FormatForest is a simple and elegant blogging engine written in Go. It was originally developed as a personal project targeting Nadim Kobeissi's personal blog but has now been rendered open source.
FormatForest is only suited for personal blogs operated by a single individual. Its advantages:
- Simplicity and elegance in the FormatForest design and functionality allow you to focus on growing your writing and personal web presence.
- Complete Markdown support allows you to draft posts quickly and without fuss.
- Unparallelled security compared to WordPress and other dynamic blog engines.
- Secure sync over rsync allows you to publish your website quickly from your local machine.
- Integration with Commento, the fast, privacy-focused commenting platform for easy comment support on all of your posts.
Let's set up a blog using FormatForest.
- Install FormatForest as a system command:
go install formatforest.com/cmd/formatforest@latest - Type
formatforest init myBlogto create a new FormatForest blog in a folder calledmyBlog.
The folder myBlog will contain:
config.txt, your master configuration file for your FormatForest blog.postsfolder, where you will write and store your blog posts in Markdown format.publicfolder, where FormatForest will generate static HTML to be served via your web server.resfolder, which contains your static resources (includesimg,css,js,pdfandzipsubfolders).templatesfolder, which includes the templates that FormatForest will use to render your formatted static blog.
Please note that init requires an Internet connection in order to download some very small assets for your blog. If you do not have an Internet connection, you can simply create the above files and folders manually and obtain the same effect, minus the boilerplate HTML templates, CSS and images.
Simply open config.txt using a text editor and modify the values. They are self-explanatory:
WebsiteName: Your website's name.WebsiteURI: Your website's URL.WebsiteDescription: A small description for your website, one paragraph.WebsiteIcon: An icon for your website. Store the icon file inres/img. For example, if your icon is located inres/img/myIcon.png, then simply set this parameter to"myIcon.png". Do not type the full path.WebsiteTwitter: Your Twitter handle. Do not include the@.WebsiteLang: Your website's language.WebsiteLangDir: Set toltrfor left-to-right languages (such as English or French),rtlfor right-to-left languages (such as Arabic or Hebrew.)AuthorName: Your name.AuthorEmail: Your email.AuthorTwitter: Your Twitter handle, otherwise leave empty.AuthorLinkedIn: Your LinkedIn handle, otherwise leave empty.AuthorFacebook: Your Facebook handle, otherwise leave empty.AuthorInstagram: Your Instagram handle, otherwise leave empty.CommentoIntegration: If your website is signed up with Commento, set to true. All blog posts will automatically use Commento for comments.SyncUser: SSH username for FormatForest's sync feature.SyncHost: Remote host for FormatForest's sync feature.SyncPath: Remote directory path for FormatForest's sync feature.
Blog posts are stored in the posts folder and must imperatively have a filename with the following format:
2020-04-19-mypost.md
In the above, we have the date of publication (year-month-day) and then a post tag which indicates a single-word unique identifier for the post which must be between 1 and 32 characters. .md specifies that this is a Markdown file. If your post filename does not meet the above format, FormatForest will not be able to process your blog.
Here is an example post:
{
PostTitle: "My First Post",
PostDescription: "A short description of my post for social media embeds.",
PostImage: "fileNameOfMyImageInResImgFolderForSocialMediaEmbeds.jpg"
}
## Subtitle
Hello, and welcome to my post! Thanks for tuning in!
## Conclusion
Final Fantasy VII Remake is a fantastic game!
In FormatForest, the first five lines of a post specify a configuration for that post itself. This must be specified in order for the post to be processed correctly. The rest of the file can be standard Markdown.
In order to generate the static HTML for your blog, return to your myBlog folder and type: formatforest format. Your website will then be ready inside the public folder.
You may then either:
- Serve the
publicfolder locally from your computer as you see fit, or manually upload it somewhere, or, - Type
formatforest syncin order to automatically synchronize yourpublicfolder via rsync and SSH to a remote server. rsync must be installed locally for this to work and correct values forSyncUser,SyncHostandSyncPathmust be specified inconfig.txt.
Easy!
The templates folder contains three templates:
home.html: used for your homepage and post listing.post.html: used for actual posts.rss.xml: used to generate your blog's RSS feed.
These templates can be fully customized to your liking. The CSS file can be found and modified inside res/css/style.css.
FormatForest will find the following template tags inside HTML templates and replace them automatically with the appropriate content. Each tag is written in the HTML file in the format {{FF:TagName:FF}}. For example, the PostDate tag would be written as {{FF:PostDate:FF}}.
PostDate: The date of publication of the post (yyyy-mm-dd), derived from its filename.PostTag: The tag of the post, derived from its filename.PostContent: The contents of the post, converted from Markdown to HTML format.PostList: An HTML list of all the posts in the blog, with links.
PostRss: Your posts in RSS format.PostRssDate: The publication date for your post in RSS-compatible format.
CurrentYear: The current year.CurrentMonth: The current month in numeric format.CurrentDay: The current day in numeric format.
Please check out the FormatForest source code repository to discuss and contribute.
FormatForest is authored by Nadim Kobeissi. It is provided as free and open source software, licensed under the GNU General Public License, version 3.
© Copyright 2020-2021 Nadim Kobeissi. All Rights Reserved.