START
Disclaimer
Toucan product is currently in its beta phase, which means you might encounter issues if you attempt to custom modify the template using Toucan. While we’re actively refining and improving the experience, some features may be unstable or require manual adjustments. TRY-O template is fully operational as is! We appreciate your flexibility as we work towards a more polished version! 🚀
Introduction
Thank you for purchasing Try-O-Theme! This theme is built on our very own, soaring Toucan static site generator, which uses Markdown for content creation and Mustache templates for layout and design. Together, these tools make it easy to add, edit, and manage your site’s content while maintaining a visually appealing and professional design.
With Markdown, you can write formatted text in plain-text files, which Toucan converts into HTML. Mustache templates allow you to customize the layout and presentation of your site with clean, readable syntax. Together, they give you full control over both the content and appearance of your site.
This guide will walk you through essential tasks, such as changing the site logo, adding new content (tags, authors, posts), and customizing your site’s pages and footer. It also covers Markdown basics and provides instructions for deploying your site to GitHub Pages, ensuring a smooth publishing process.
Change content
Easily customize your site’s content by following these guides:
- Change Images: Learn how to replace or update images across your site.
- Add a new tag: Organize your posts by creating tags to improve navigation.
- Add a new author: Showcase contributors by adding author profiles with bios, images, and social links.
- Add a new post: Create and publish new content using Markdown while associating it with relevant tags and authors.
- Create a custom page in navigation: Add static pages, like “About” or “Contact Us,” and include them in the navigation menu.
- Customize the footer: Update your site’s footer with social links, copyright information, and custom text.
- Theme Tweaks: Tweak your theme by changing the theme colours or add block directives.
Each guide is designed to provide step-by-step instructions to make the customization process seamless.
Markdown basics
Markdown is an easy-to-use markup language that simplifies formatting. Learn the essentials through these guides:
- Markdown basics part1: Covers headings, bold/italic textand blockquotes.
- Markdown basics part2: Explores advanced features like lists, links and images.
Whether you’re new to Markdown or need a refresher, these guides will help you master its simplicity.
Deploy to GitHub
Publish your site live using GitHub Pages:
- Deploy to a GitHub Page: Follow step-by-step instructions to deploy your docs folder to GitHub Pages and make your site accessible online.
This guide ensures you can easily manage updates and publish changes to your site.
Closing Notes
Thank you again for choosing Try-O-Theme! If you have any questions or need further assistance, feel free to:
- Contact us directly.
- Check the Toucan documentation for more detailed developer guidance.
- Explore the examples provided in this guide.
Give a star on Github 🙏
I’m sure you know, how much it means to an online service provider to more ratings on Github. Give us a star and watch us if you like Toucan and TRY-O theme. Thank you!
