From: Ruben Beltran del Rio Date: Sun, 15 Dec 2024 23:27:11 +0000 (+0100) Subject: Use usage once X-Git-Url: https://git.r.bdr.sh/rbdr/r.bdr.sh/commitdiff_plain Use usage once --- diff --git a/blog.gmi b/blog.gmi index 94c2a11..6a3d0eb 100644 --- a/blog.gmi +++ b/blog.gmi @@ -76,7 +76,7 @@ Adding and updating posts regenerates the blog and archive, but you can always r blog generate ``` -## Usage II: Publishing +## II: Publishing Publishing the blog and archive requires `rsync`. @@ -100,7 +100,7 @@ blog publish-archive This will include *all the posts* in gemtext format. -## Usage III: Source Control +## III: Source Control Blog supports saving snapshots of the blog in git, and you can add and remove remotes with the following commands: @@ -120,7 +120,7 @@ The blog will always sync down before adding to avoid going out of sync. **IF YOU CHANGE ANY FILES MANUALLY, REMEMBER TO SYNC UP, OTHERWISE YOUR CHANGES WILL BE LOST** -## Usage IV: Customizing +## IV: Customizing The default templates included in blog are very generic and likely not helpful for your use case. However, you can customize this freely: @@ -189,7 +189,7 @@ Finally, you can do conditionals. To negate a conditional you can prepend !. Any files inside the `static` directory of your blog data root (`$XDG_DATA_HOME/blog`) will be copied as is. This is useful for any images, javascript files or stylesheets that you use in your posts or templates. -## Usage V: Where is Data Stored? +## V: Where is Data Stored? Blog uses three diretories to store data, all of them using the XDG User Directories. @@ -202,7 +202,7 @@ Directories. All of these can be overridden by environment variables. -## Usage VI: Configuration +## VI: Configuration You can control the number of posts in the ephemeral blog, and the location of all the data by using environment variables.