https://basalt.10397121.xyz/ 2026-04-20T21:49:16+00:00 https://basalt.10397121.xyz/ https://basalt.10397121.xyz/_media/wiki:dokuwiki.svg text/html 2026-04-12T11:13:56+00:00 alice (alice@undisclosed.example.com) https://basalt.10397121.xyz/docs:usage:posts?rev=1775992436&do=diff Posts Posts in basalt-ng can represent a simple blog post or another kind of entity with it's own metadata and archive page using Custom Post Types. Even pages, are actually posts internally. Posts are located in the “posts” directory within the root of your basalt site. All files inside the posts directory and any subdirectories therein that end with the text/html 2026-04-12T11:13:24+00:00 alice (alice@undisclosed.example.com) https://basalt.10397121.xyz/docs:theme_development:themes?rev=1775992404&do=diff Themes On your basalt website, a theme is what defines the look, feel, layout, and (if using custom post types) extra functions of your site. basalt-ng themes are built with jinja2 templates. An example theme is the “minimal” theme in the basalt-themes repository. text/html 2026-04-12T11:12:51+00:00 alice (alice@undisclosed.example.com) https://basalt.10397121.xyz/docs:theme_development:theme_template_variables?rev=1775992371&do=diff Theme template variables At page render time, a number of variables are exposed to the theme with information relating to the rendering. This is how the theme can know, for example, to render a post list or a post display page or any other combination. text/html 2026-04-12T11:12:38+00:00 alice (alice@undisclosed.example.com) https://basalt.10397121.xyz/docs:theme_development:custom_post_types?rev=1775992358&do=diff Custom Post Types Custom Post Types are available in basalt-ng 0.2.0+ Custom Post Types allow you to specify for a post to be handled differently compared to ordinary posts. You can elect to have basalt generate an entirely separate archive page for them (or not), and the theme can respond to this, possibly rendering different archive or post display pages. text/html 2026-04-12T11:12:07+00:00 alice (alice@undisclosed.example.com) https://basalt.10397121.xyz/docs:configuration:site_configuration?rev=1775992327&do=diff Site Configuration The site configuration is located in the “site.json” file in the root directory of a basalt site. It is used to configure properties relating to the site itself, the title, base url, theme, and other such options. Appearance Options text/html 2026-04-12T11:11:54+00:00 alice (alice@undisclosed.example.com) https://basalt.10397121.xyz/docs:configuration:secrets?rev=1775992314&do=diff Secrets A file named “secrets.json” in your basalt site's root directory can be used to store authentication credentials and the like. It is currently only used to hold the authentication token for Netlify uploading. It is automatically added to the .gitignore file when the site is initialised, to avoid it being accidentally committed to source control. text/html 2026-04-12T11:11:36+00:00 alice (alice@undisclosed.example.com) https://basalt.10397121.xyz/docs:configuration:netlify?rev=1775992296&do=diff Netlify Netlify provides serverless hosting services for static websites. The basalt netlify upload target can be used to automatically upload a built site to netlify. Configuring the Netlify upload target First, set basalt to use the netlify upload function. text/html 2026-04-12T11:11:27+00:00 alice (alice@undisclosed.example.com) https://basalt.10397121.xyz/docs:configuration:custom_menu?rev=1775992287&do=diff Custom Menu Enabling the custom menu override in Site configuration allows you to override the automatic generation of the menu, and specify the items that it should contain manually. Enabling the Custom Menu Override Set the “use_custom_menu” flag in the Site configuration to true. text/html 2026-04-12T11:11:12+00:00 alice (alice@undisclosed.example.com) https://basalt.10397121.xyz/docs:configuration:automatic_build_uploading?rev=1775992272&do=diff Automatic Build Uploading basalt-ng is capable of building a site, and uploading it to a server in one command. ServiceTarget namePageNetlifynetlifyNetlify Configuring an upload target Set the “upload_target” site configuration option to the target name of your chosen target. Follow any other instructions on the upload target's page, such as configuring an authentication token or setting secrets text/html 2026-04-12T11:05:41+00:00 alice (alice@undisclosed.example.com) https://basalt.10397121.xyz/sidebar?rev=1775991941&do=diff GENERAL * Home/About basalt-ng * Download * Release Notes Documentation docs index text/html 2025-12-31T19:38:24+00:00 alice (alice@undisclosed.example.com) https://basalt.10397121.xyz/release:0.2.1?rev=1767209904&do=diff basalt-ng 0.2.1, released 31 December 2025, has 1 listed changes. Changes * When the post preview maximum length is set, an ellipsis will be added to the preview to indicate it is truncated text/html 2025-12-31T19:37:07+00:00 alice (alice@undisclosed.example.com) https://basalt.10397121.xyz/release_notes?rev=1767209827&do=diff This page links to all of the release pages for basalt-ng, and their associated Codeberg tags. Version Release Date Tag basalt-ng 0.2.1 31 December 2025 text/html 2025-12-02T20:39:24+00:00 alice (alice@undisclosed.example.com) https://basalt.10397121.xyz/?image=basalt-wordmark.png&ns=0&rev=1764707964&tab_details=history&media_do=diff&do=media <img src="https://basalt.10397121.xyz/_media/basalt-wordmark.png?w=500&amp;h=500&amp;tok=614ae1" alt="basalt-wordmark.png" loading="lazy" width="500" height="500" /> text/html 2025-12-02T20:39:17+00:00 alice (alice@undisclosed.example.com) https://basalt.10397121.xyz/?image=0%3Abasalt-wordmark.png&ns=0&rev=1764707957&tab_details=history&media_do=diff&do=media <img src="https://basalt.10397121.xyz/_media/0:basalt-wordmark.png?w=500&amp;h=500&amp;tok=1af623" alt="basalt-wordmark.png" loading="lazy" width="500" height="500" />