New Snippets plugin, 0.20.0 Released
Tags: showdev, orchid, jamstack, webdev
Published: 2020-03-30 17:33:59

<div class="content card-content is-medium-tablet is-large-fullhd">
<p>The next major version of Orchid, 0.20.0, is now available! It includes the first introduction of the long-awaited
<a href="/plugins/orchidsnippets">Snippets</a> plugin, as well as a number of smaller quality-of-life improvements throughout.
Check out the full release notes <a href="/changelog">here</a>, and stick around for a general update of the
development and community around Orchid!</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"></a>On Github</h2>
<p>Orchid is now at 343 stars on Github, and since the last newsletter has received a PR from
<a href="https://github.com/BrunoVernay">Bruno Vernay</a> with some improvements to the formatting of blog post filenames.</p>
<p>I also want to give a special thanks to everyone who provided feedback and suggestions for the new Snippets plugin! Both
on the proposal issue and on Gitter, your suggestions are what decided the features to include in this first release,
and it's my hope that it will provide exactly the solution you're looking for!</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"></a>What's New?</h2>
<p>This latest release is a continuation of the "quality-of-life" improvements that have been suggested by the you and are
making Orchid better and easier to use. Some of these changes required breaking the internal API (thus the major version
bump to 0.20.0), but this version does not include any deprecations or breaking changes to the public, end-user
features. Below are the new features available in 0.19.0:</p>
<ul>
<li>New Snippets plugin allows you to lookup and embed snippets from code, files, and even external webpages!</li>
<li>The Admin Panel layout got a minor makeover to make it easier to use and more flexible.</li>
<li>Forms and snippets located during the site build are care listed and can be previewed in the admin panel.</li>
<li>Allows Forms to be embedded with a new <code>form</code> tag, instead of only as Components as before.</li>
<li>Replaces default accordion markup with details/summary HTML5 tag for best usage in all themes</li>
<li>Tabbed TemplateTags can now be rendered dynamically! You can now use loops and conditionals to add individual tabs to
the body of tabbed tags, instead of having to have them be statically-determined.</li>
<li>Both the base URL and your theme can now be set in <code>config.yml</code>, instead of needing to be set in your Gradle or Maven
build scripts.</li>
<li>Improvements to base URL management now allow plugins to provide "helpers" for determining the base URL, such as
OrchidNetlify detecting when Orchid is running on Netlify's CI platform and using its build environment variables
to find the base URL.</li>
<li>OrchidPosts now relaxes slightly the strict filename requirements for post files.</li>
</ul>
<p>Full release notes and a migration guide are available <a href="/changelog">here</a>.</p>
<h1 id="in-progress"><a href="#in-progress" id="in-progress" class="anchor"></a>In Progress</h1>
<p>The changes allowing base URLs to be set from <code>config.yml</code>, instead of being a flag from the CLI or build plugins,
brings us closer to having <em>relative</em> urls for generated links instead <em>absolute</em> as they are now. Relative URLs don't
include a base URL, but instead provide a path from the current page to the linked one, and will make it possible to
view an Orchid site directly in the filesystem instead of needing to start an HTTP server to view it.</p>
<p>There is still work to be done on this, but it's now considered a mid- to short-term goal for Orchid instead of a
long-term one, and it will be a <em>huge</em> win for those of you using Orchid for documentation. Thank you to everyone who
has been asking for this, I hope to be able to provide this feature for you soon!</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>

</div>