0.21.0 Released
Tags: showdev, orchid, jamstack, webdev
Published: 2020-06-01 18:47:50

<p>Being stuck at home may not be the most exciting, but it has given me lots of time to fix bugs and make Orchid better
for you! This latest release, 0.21.0, includes many bug fixes identified (and sometimes fixed!) by the community, and
also boasts some significant internal changes which improve Orchid's overall performance and prepare a major portion of
its functionality to be pulled into a standalone library (which you'll absolutely want to check out when it's released).</p>
<p>This is the official Orchid newsletter, the newest and best documentation site generator. There is a growing need to
keep the community up-to-date on all the happenings around Orchid, and here I will share Orchid's progress, milestones,
and future plans! Follow along with this series to stay on top of Orchid's newest features, track adoption on Github,
and see who's using Orchid!</p>
<h2 id="on-github"><a href="#on-github" id="on-github" class="anchor"><svg data-fa-pseudo-element=":after" data-prefix="fas" data-icon="link" class="svg-inline--fa fa-link fa-w-16" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" data-fa-i2svg=""><path fill="currentColor" d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"></path></svg></a>On Github</h2>
<p>The Orchid community is growing larger all the time, and the repo is now at 367 stars!</p>
<p>Orchid also received contributions from <a href="https://github.com/vmj">Mikko Värri</a> for improvements to sitemaps, and
<a href="https://github.com/JavierSegoviaCordoba">Javier Segovia Córdoba</a> with documentation fixes.</p>
<p>And thank you to everyone else who has been giving Orchid a try, reaching out with questions and feedback, and generally
supporting this growing community!</p>
<h2 id="whats-new"><a href="#whats-new" id="whats-new" class="anchor"><svg data-fa-pseudo-element=":after" data-prefix="fas" data-icon="link" class="svg-inline--fa fa-link fa-w-16" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" data-fa-i2svg=""><path fill="currentColor" d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"></path></svg></a>What's New?</h2>
<p>Full release notes and a migration guide are available <a href="/changelog">here</a>. Here's a summary of what to
expect in 0.21.0:</p>
<ul>
<li>Experimental sourcedocs are now enabled by default and do not need a CLI flag to use.</li>
<li>Sourcedocs modules can now cross-link between each other for multi-module projects, or those with multiple interlinked
sourcesets (like Kotlin MPP).</li>
<li>Collections have become the base unit of organizing groups of pages in Orchid, and there is now a <code>collectionPages</code>
menu item to display pages from a collection from any plugin.</li>
<li>Asset management is greatly improved, and support for downloading and inlining CSS and JS assets is now available from
<code>config.yml</code> as well as from plugin code.</li>
<li>Diagnostic output across the board is generally improved. Pebble templates are now more descriptive about errors with
better line-number tracking (to aid in resolving specific Pebble template issues), and <code>OrchidTest</code> now only shows
HTML selectors from the test instead of the entire rendered page.</li>
</ul>
<h1 id="in-progress"><a href="#in-progress" id="in-progress" class="anchor"><svg data-fa-pseudo-element=":after" data-prefix="fas" data-icon="link" class="svg-inline--fa fa-link fa-w-16" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" data-fa-i2svg=""><path fill="currentColor" d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"></path></svg></a>In Progress</h1>
<p>Continued work is underway to support relative URLs (for viewing an Orchid site without needing a local fileserver). In
addition, Orchid's resource/file management is a core subsystem that would do well to be a separate library, and work is
in progress to move it out of Orchid and into Arcana, it's own library. This library will be Kotlin
multiplatform-enabled, bringing Orchid's simple and flexible file-management APIs to Android, iOS, JS, and of course,
pure JVM.</p>
<hr>
<p>Are you interested in getting started with Orchid? There simply is no better way to manage all the documentation for
your project, and I'd love to help you get set up!</p>
<p>If you have an open-source project that needs docs, are building a new portfolio, or are building any other kind of
static site, I want to work with you to get you set up with Orchid! Comment on this post, send me a PM here on Dev.to,
reach out on <a href="https://gitter.im/JavaEden/Orchid">Gitter</a>, or <a href="https://www.caseyjbrooks.com/contact/">contact me here</a>
and I will be with you every step of the way.</p>
<p>And as always, let me know if you start using Orchid so I can feature you in the next update!</p>