static site generator

Bilingual

Setting up Jekyll for GitHub Pages
2 months ago
- Jekyll is a customizable static site generator that parses Markdown and uses templates for consistent styling.
- To install Jekyll, you need RubyGems; then you can create a new site from the command line.
- Customize your site by editing _config.yml, and modify CSS, layouts, and includes in the respective folders.
- Content can be written in Markdown, HTML, or plain text, and Jekyll expects a specific front matter format.
- If you encounter permissions errors during gem installation, you may need to reinstall RubyGems or adjust gem storage paths.
Beej's Bit Bucket
2 months ago
- The author removed Disqus comments from their blog because Disqus ended its free ad-free option, making it not worth the cost for low usage.
- They replaced Disqus with a system that pulls comments from Mastodon, leveraging the overlap between Mastodon users and their blog readers.
- The solution uses Mastodon's public API to fetch comments as JSON without authentication, then JavaScript parses the data and builds the comment HTML.
- The Mastodon post ID is embedded in the static HTML via a placeholder that gets replaced during site generation using a shell script.
- Comments are loaded on user click (not on page load) to reduce server load, and the function fetch() retrieves the JSON from the API endpoint.
- Each comment displays the user's avatar, display name, account name, content (already HTML-encoded), and media attachments as simple links with emoji icons.
- A blacklist feature allows filtering out specific comments or accounts by storing IDs in an environment variable, which is converted to a JavaScript Set for filtering.
- The deployment process involves a chicken-and-egg problem: the blog must be live before linking from Mastodon, then the post ID is used to rebuild and redeploy the blog entry.
- This is the first post using the new comment system, so the author is testing it for breakages.
Blog-Doc Reloaded
3 months ago
- Blog-Doc has been completely rewritten after nearly two years without updates.
- The rewrite is inspired by lessons learned from building Aether, Blog-Doc's successor.
- The new version returns to the original philosophy: keeping the Node.js CMS and static site generator simple, lightweight, and enjoyable.
- Aether had drifted from simplicity, making tasks more complex internally.
- The author decided to incorporate most of Aether's features into Blog-Doc while adhering to the 'simpler is always better' principle.
- Users are encouraged to try the new version and star it on GitHub for support.
Shrimple – A Simpler, Nicer Markdown
3 months ago
- Shrimple is a cleaner Markdown alternative for generating HTML documents.
- Installation requires a Go compiler, and usage involves compiling and running with flags like -s for default CSS and -w for wrapping.
- Links use footnotes to avoid inline URLs, maintaining readability.
- Code blocks require 6 spaces indentation; optional language tags enable highlighting.
- Lists use bullet points and numbered formats with specific indentation rules.
- Headers are defined by underscore thickness (=== for h1, --- for h2) with a minimum line length rule.
- Notes start with an uppercase word followed by colon, with 4-space indentation for content.
- Parse and render dictionaries allow word highlighting without inline markup.
- Static site generation converts directories and files to HTML with menu and navigation links.

static site generator

Setting up Jekyll for GitHub Pages

Beej's Bit Bucket

Blog-Doc Reloaded

Shrimple – A Simpler, Nicer Markdown