Skip to content

Commit

Permalink
1.0.0-beta.1 release (#8)
Browse files Browse the repository at this point in the history
- beta.1 release blog post
  • Loading branch information
tib authored Oct 22, 2024
1 parent 0e1d241 commit e1df0a7
Show file tree
Hide file tree
Showing 32 changed files with 558 additions and 52 deletions.
27 changes: 25 additions & 2 deletions docs/articles/page/1/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -163,7 +163,30 @@ <h1>Articles</h1><p>Browse all articles.</p>
<span class="featured">featured</span>

<div class="meta">
<time datetime="2024.10.15.">2024.10.15.</time>
<time datetime="2024.10.22.">2024.10.22.</time>
&middot; <span class="reading-time">1 min read</span>
</div>
<h2 class="title"><a href="https://toucansites.com/first-beta-release/" target="">First beta release</a></h2>
<hr>
<p>Toucan 1.0.0-beta.1 has been released, featuring custom block directives and other minor enhancements.</p>

<div class="grid grid-221">
<div class="author-list">
<a href="https://toucansites.com/authors/tibor-bodecs/">
<img class="small rounded" src="/assets/authors/tibor-bodecs/tibor-bodecs.jpg" alt="Tibor Bödecs">
</a>
</div>

<div class="tag-list">
<a href="https://toucansites.com/tags/releases/"><small>Releases</small></a>
</div>
</div>
</div>
<div class="post card">


<div class="meta">
<time datetime="2024.10.17.">2024.10.17.</time>
&middot; <span class="reading-time">1 min read</span>
</div>
<h2 class="title"><a href="https://toucansites.com/last-alpha-release/" target="">Last alpha release</a></h2>
Expand All @@ -183,7 +206,7 @@ <h2 class="title"><a href="https://toucansites.com/last-alpha-release/" target="
</div>
</div>
<div class="post card">
<span class="featured">featured</span>


<div class="meta">
<time datetime="2024.09.30.">2024.09.30.</time>
Expand Down
2 changes: 1 addition & 1 deletion docs/authors/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -171,7 +171,7 @@ <h2><a href="https://toucansites.com/authors/andris-sipos/">Andris Sipos</a></h2
<img class="large rounded" src="/assets/authors/tibor-bodecs/tibor-bodecs.jpg" alt="Tibor Bödecs">
</a>
<h2><a href="https://toucansites.com/authors/tibor-bodecs/">Tibor Bödecs</a></h2>
<p>2 articles</p>
<p>3 articles</p>
</div>
</div>

Expand Down
30 changes: 27 additions & 3 deletions docs/authors/tibor-bodecs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -160,7 +160,7 @@
<h1>Tibor Bödecs</h1>
<hr>
<p>CEO @ Binary Birds</p>
<p>2 articles</p>
<p>3 articles</p>
</header>


Expand All @@ -171,7 +171,31 @@ <h1>Tibor Bödecs</h1>
<span class="featured">featured</span>

<div class="meta">
<time datetime="2024.10.15.">2024.10.15.</time>
<time datetime="2024.10.22.">2024.10.22.</time>
&middot; <span class="reading-time">1 min read</span>
</div>
<h2 class="title"><a href="https://toucansites.com/first-beta-release/" target="">First beta release</a></h2>
<hr>
<p>Toucan 1.0.0-beta.1 has been released, featuring custom block directives and other minor enhancements.</p>

<div class="grid grid-221">
<div class="author-list">
<a href="https://toucansites.com/authors/tibor-bodecs/">
<img class="small rounded" src="/assets/authors/tibor-bodecs/tibor-bodecs.jpg" alt="Tibor Bödecs">
</a>
</div>

<div class="tag-list">
<a href="https://toucansites.com/tags/releases/"><small>Releases</small></a>
</div>
</div>
</div>

<div class="post card">


<div class="meta">
<time datetime="2024.10.17.">2024.10.17.</time>
&middot; <span class="reading-time">1 min read</span>
</div>
<h2 class="title"><a href="https://toucansites.com/last-alpha-release/" target="">Last alpha release</a></h2>
Expand All @@ -192,7 +216,7 @@ <h2 class="title"><a href="https://toucansites.com/last-alpha-release/" target="
</div>

<div class="post card">
<span class="featured">featured</span>


<div class="meta">
<time datetime="2024.09.30.">2024.09.30.</time>
Expand Down
2 changes: 1 addition & 1 deletion docs/docs/deployment/github-pages/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -212,7 +212,7 @@
<article>
<a href="https://toucansites.com/docs/deployment/">Deployment</a>

<h1>GitHub Pages</h1><hr><p>Toucan-based websites can be hosted for free using GitHub Pages. Follow these steps to set up your site:</p><ol><li>Create a repository for your website on GitHub.</li><li>Place all your source files into an src directory within the repository.</li><li>Run the <code>toucan generate</code> command to generate your site.</li><li>Commit and push the generated files to your repository.</li><li>Navigate to the repository’s <strong>Settings</strong> > <strong>Pages</strong> section.</li><li>In the Pages settings, select the directory containing the generated site files.</li></ol><p>Once done, your site should be live on GitHub Pages.</p><p>Fore more information, visit the following guides:</p><ul><li><a href="https://docs.github.com/en/pages/quickstart" target="_blank">Quickstart for GitHub Pages</a></li><li><a href="https://docs.github.com/en/pages/getting-started-with-github-pages/creating-a-github-pages-site" target="_blank">Creating a GitHub Pages site</a></li></ul>
<h1>GitHub Pages</h1><hr><p>Toucan-based websites can be hosted for free using GitHub Pages. Follow these steps to set up your site:</p><ol><li>Create a repository for your website on GitHub.</li><li>Place all your source files into an src directory within the repository.</li><li>Run the <code>toucan generate</code> command to generate your site.</li><li>Commit and push the generated files to your repository.</li><li>Navigate to the repository’s <strong>Settings</strong> > <strong>Pages</strong> section.</li><li>In the Pages settings, select the directory containing the generated site files.</li></ol><p>Once done, your site should be live on GitHub Pages.</p><p>For more information, visit the following guides:</p><ul><li><a href="https://docs.github.com/en/pages/quickstart" target="_blank">Quickstart for GitHub Pages</a></li><li><a href="https://docs.github.com/en/pages/getting-started-with-github-pages/creating-a-github-pages-site" target="_blank">Creating a GitHub Pages site</a></li></ul>


<section>
Expand Down
2 changes: 1 addition & 1 deletion docs/docs/getting-started/commands/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -213,7 +213,7 @@
<a href="https://toucansites.com/docs/getting-started/">Getting started</a>

<h1>Commands</h1><hr><p>Toucan includes three built-in subcommands to generate static sites: <em>generate</em>, <em>watch</em>, and <em>serve</em>.</p><h2 id="generate">Generate</h2><p>The <code>generate</code> command builds static files from the source folder. The static site will be available in a destination directory, which can be customized. Additionally, the site’s base URL can be overridden, which is useful for local development.</p><pre><code class="language-sh">toucan generate ./src ./docs --base-url http://localhost:3000/
</code></pre><h2 id="watch">Watch</h2><p>The <code>watch</code> command monitors a source directory for changes and automatically rebuilds the distribution files, regenerating the site whenever changes are detected.</p><blockquote><p>Please note that the <code>watch</code> command is only available on macOS during the alpha release.​</p></blockquote><pre><code class="language-sh">toucan watch ./src ./docs --base-url http://localhost:3000/
</code></pre><h2 id="watch">Watch</h2><p>The <code>watch</code> command monitors a source directory for changes and automatically rebuilds the distribution files, regenerating the site whenever changes are detected.</p><blockquote><p>Please note that the <code>watch</code> command is only available on macOS during the beta release.​</p></blockquote><pre><code class="language-sh">toucan watch ./src ./docs --base-url http://localhost:3000/
</code></pre><h2 id="serve">Serve</h2><p>The serve command starts a web server to serve a specified directory. It allows serving a folder with an optional port number. By default, your site will be accessible at <code>http://localhost:3000/</code> if run as follows:</p><pre><code class="language-sh">toucan serve ./docs -h localhost -p 3000
toucan serve ./docs --host localhost --port 3000
</code></pre><p>You can specify a hostname and port parameter to bind your web server to a given address. This allows you to preview your website at http://localhost:3000/.</p>
Expand Down
2 changes: 1 addition & 1 deletion docs/docs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -209,7 +209,7 @@
</div>
<div class="center">
<article>
<h1>Docs</h1><p>Toucan is currently released as an <a href="https://github.com/binarybirds/toucan" target="_blank">alpha-version</a>.</p><p>Welcome to the Toucan user docs. This page is currently work in progress. We’re going to provide the documentation for our static site during the upcoming weeks. Thank you very much for your patience. 🙏</p><p>Don’t hesitate to <a href="/contact/">contact us</a> if you have any questions.</p>
<h1>Docs</h1><p>Toucan is currently released as an <a href="https://github.com/binarybirds/toucan" target="_blank">beta-version</a>.</p><p>Welcome to the Toucan user docs. This page is currently work in progress. We’re going to provide the documentation for our static site during the upcoming weeks. Thank you very much for your patience. 🙏</p><p>Don’t hesitate to <a href="/contact/">contact us</a> if you have any questions.</p>



Expand Down
2 changes: 1 addition & 1 deletion docs/docs/installation/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -210,7 +210,7 @@
<div class="center">
<article>
<a href="/docs/">Docs</a>
<h1>Installation</h1><p>During the alpha release, Toucan is available only for macOS and Linux. Windows support will be coming soon.</p>
<h1>Installation</h1><p>During the beta release, Toucan is available only for macOS and Linux. Windows support will be coming soon.</p>

<h2>Guides</h2>
<ul>
Expand Down
2 changes: 1 addition & 1 deletion docs/docs/installation/linux/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -212,7 +212,7 @@
<article>
<a href="https://toucansites.com/docs/installation/">Installation</a>

<h1>Linux</h1><hr><p>During the alpha release, Toucan can be installed on Linux by compiling from source.</p><p>Please note that the <code>watch</code> command is not fully supported yet, but this feature will be available on Linux in a future release.</p><h2 id="quick-install">Quick install</h2><p>Here’s a quick snippet to install Toucan on Linux. Run the following commands, ensuring that Swift 5.10 or later is installed on your machine beforehand.</p><pre><code class="language-swift"># clone the repository & install toucan
<h1>Linux</h1><hr><p>During the beta release, Toucan can be installed on Linux by compiling from source.</p><p>Please note that the <code>watch</code> command is not fully supported yet, but this feature will be available on Linux in a future release.</p><h2 id="quick-install">Quick install</h2><p>Here’s a quick snippet to install Toucan on Linux. Run the following commands, ensuring that Swift 5.10 or later is installed on your machine beforehand.</p><pre><code class="language-swift"># clone the repository & install toucan
git clone https://github.com/toucansites/toucan.git
cd toucan
make install
Expand Down
2 changes: 1 addition & 1 deletion docs/docs/installation/macos/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -212,7 +212,7 @@
<article>
<a href="https://toucansites.com/docs/installation/">Installation</a>

<h1>macOS</h1><hr><p>During the alpha release, Toucan can be installed on macOS by compiling from source. Support for <a href="https://brew.sh/" target="_blank">Brew</a> and <a href="https://github.com/yonaskolb/Mint" target="_blank">Mint</a> package managers is coming soon.</p><h2 id="quick-install">Quick install</h2><p>Here’s a quick snippet to install Toucan on macOS. Simply run the following commands. Please note that both Swift and Xcode must be installed on your machine before executing the commands.</p><pre><code class="language-swift"># clone the repository & install toucan
<h1>macOS</h1><hr><p>During the beta release, Toucan can be installed on macOS by compiling from source. Support for <a href="https://brew.sh/" target="_blank">Brew</a> and <a href="https://github.com/yonaskolb/Mint" target="_blank">Mint</a> package managers is coming soon.</p><h2 id="quick-install">Quick install</h2><p>Here’s a quick snippet to install Toucan on macOS. Simply run the following commands. Please note that both Swift and Xcode must be installed on your machine before executing the commands.</p><pre><code class="language-swift"># clone the repository & install toucan
git clone https://github.com/toucansites/toucan.git
cd toucan
make install
Expand Down
2 changes: 1 addition & 1 deletion docs/docs/installation/windows/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -212,7 +212,7 @@
<article>
<a href="https://toucansites.com/docs/installation/">Installation</a>

<h1>Windows</h1><hr><p>Toucan is available for <a href="/docs/installation/macos/">macOS</a> and <a href="/docs/installation/linux/">Linux</a> during the alpha release, with Windows support coming soon.</p><p>If you’d like to help improve Toucan on Windows, consider submitting a PR to the project’s repository on <a href="https://github.com/toucansites/toucan/pulls" target="_blank">GitHub</a>. 🙏</p>
<h1>Windows</h1><hr><p>Toucan is available for <a href="/docs/installation/macos/">macOS</a> and <a href="/docs/installation/linux/">Linux</a> during the beta release, with Windows support coming soon.</p><p>If you’d like to help improve Toucan on Windows, consider submitting a PR to the project’s repository on <a href="https://github.com/toucansites/toucan/pulls" target="_blank">GitHub</a>. 🙏</p>


<section>
Expand Down
2 changes: 1 addition & 1 deletion docs/docs/themes/content-types/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -242,7 +242,7 @@ <h1>Content types</h1><hr><p>Custom content types are defined in the <code>types
method: equals
value: true

</code></pre><p>Content types, including pagination and property validation, are still subject to change during the alpha and beta release cycles.</p><p>Additional documentation will be provided once this feature is stabilized.</p>
</code></pre><p>Content types, including pagination and property validation, are still subject to change during beta release cycle.</p><p>Additional documentation will be provided once this feature is stabilized.</p>


<section>
Expand Down
2 changes: 1 addition & 1 deletion docs/docs/themes/toucan-templates/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -212,7 +212,7 @@
<article>
<a href="https://toucansites.com/docs/themes/">Themes</a>

<h1>Toucan templates</h1><hr><p>The templates are being standardized in preparation for the 1.0.0 release. This document outlines the structure of the template files used during the alpha and beta release cycles.</p><h2 id="top-level-templates">Top-level templates</h2><p>There are a few top level templates that most of the themes will include inside the <code>themes/default/templates</code> folder:</p><pre><code class="language-sh">html.mustache
<h1>Toucan templates</h1><hr><p>The templates are being standardized in preparation for the 1.0.0 release. This document outlines the structure of the template files used during the beta release cycle.</p><h2 id="top-level-templates">Top-level templates</h2><p>There are a few top level templates that most of the themes will include inside the <code>themes/default/templates</code> folder:</p><pre><code class="language-sh">html.mustache
redirect.mustache
rss.mustache
sitemap.mustache
Expand Down
Loading

0 comments on commit e1df0a7

Please sign in to comment.