Resources
Zola
Zola is a fast static site generator written in Rust that Free Your Tech uses to build our public-facing website. It transforms Markdown content into a complete HTML website with consistent design. Our website contains information about our association, along with news articles and guides.
A static site contains no user accounts, databases, APIs, or complex servers. All content is defined in source files that are converted to website files. The server simply makes these files available at the specified web address, resulting in a fast, secure site that requires minimal maintenance.
Content is organized in the content directory, with each page as a Markdown file with front matter. Sections are created using _index.md files.
The site is automatically built and deployed using Codeberg CI after changes are merged to main, as defined in the woodpecker configuration file.
Resources
mdBook
mdBook is a command-line tool for creating modern online books from Markdown files. Free Your Tech uses mdBook to generate our documentation site, providing a clean, navigable interface for our wiki. While similar to Zola, mdBook is specifically designed for documentation.
The documentation structure:
book.toml: Configuration file for mdBooksrc/: Directory containing Markdown filesSUMMARY.md: Defines the book structure- Other
.mdfiles: Content pages
To add new content, create a Markdown file in the appropriate directory and add an entry to SUMMARY.md to include it in the navigation.
The site is automatically built and deployed using Codeberg CI after changes are merged to main, as defined in the woodpecker configuration file.