base_url = "/" (required)
- relative url your site will be served under in
autost server, or any other web server you deploy it to. must end with a slash.
external_base_url = "https://example.com/" (required)
- absolute url of the web server you are deploying to, for atom output. must end with a slash.
server_port = 8420 (optional)
- port to listen on, for
autost server.
site_title = "ao!!" (required)
- title of your site as a whole, for both html and atom output.
other_self_authors = ["https://cohost.org/staff"] (required)
- author urls whose posts are considered your own, in addition to
[self_author].
the settings below control which posts are considered “interesting” and included in the html and atom output by default. this allows you to curate your imported chosts, and linkify meaningful tags.
interesting_tags = [["photography"], ["reading", "watching", "listening"]] (required)
- posts with these tags are considered “interesting” and included by default, regardless of author. these tags also generate tag pages, which are linked to in all of the posts in those tags.
this setting must be a list of lists of tags — the grouping controls how they are displayed in the navigation at the top of the html output.
archived_thread_tags_path = "path/to/archived_thread_tags.txt" (optional)
- path (relative to autost.toml) to a list of additional tags to add to imported posts. you write this, and the format is:
# <original url> <tag>,<tag>,...
https://cohost.org/project/post/123456-slug tag,another tag
interesting_output_filenames_list_path = "path/to/output_interesting.txt" (optional)
- path (relative to autost.toml) to a list of paths relative to your site output directory, representing the “interesting” posts and tag pages.
autost render writes this, and you need this to use sites/deploy.sh.
interesting_archived_threads_list_path = "path/to/interesting.txt" (optional)
- path (relative to autost.toml) to a list of imported posts that should also be considered “interesting”, regardless of tags or author. you write this, and the format is:
# <original url>
https://cohost.org/project/post/123456-slug
https://nex-3.com/blog/reblogging-posts-with-h-entry/
excluded_archived_threads_list_path = "path/to/excluded.txt" (optional)
- path (relative to autost.toml) to a list of imported posts that should not be considered “interesting”, even if your other settings would otherwise consider them interesting. you write this, and the format is:
# <original url>
https://cohost.org/project/post/123456-slug
use the settings below if you want to tinker with static files like style.css and script.js without rebuilding your copy of autost:
path_to_static = "../../static2" (optional)
- path (relative to autost.toml) to a directory with your own versions of the files in autost’s static directory. note that if you set this to the actual static directory in your copy of the source code,
autost will still get rebuilt whenever you change any files, which may not be what you want.
path_to_static = "../../static2" (optional)- path (relative to autost.toml) to a directory containing a
static directory with your own version of the files in autost’s static directory. this doesn’t work as nicely as path_to_static, but it was needed in older versions of autost (< 0.3.0) where static files were not built into the autost binary.
[self_author] (optional)
this section is for your details as an author. it has two effects: new posts are prefilled with this author, and posts by this href are always considered “interesting”.
href = "https://example.com" (required in section) → <link rel="author" href>
- url for
<link> metadata and your name and handle links. uniquely identifies you for the purposes of checking if a post is your own.
name = "eggbug" (required in section) → <link rel="author" name>
- your name, for atom output.
display_name = "eggbug" (required in section) → <meta name="author_display_name" content>
- your name, for html output.
display_handle = "eggbug" (required in section) → <meta name="author_display_handle" content>
- your handle, for html output. since this is a domain name like
example.com in other imported posts (autost import), we recommend setting this to a domain name like example.com, but it can be anything really.
[renamed_tags] (optional)
this section is for automatically renaming tags in your posts without editing them. this takes effect before [implied_tags].
"Laptop stickers" = "laptop stickers"
- renames any occurrence of “Laptop stickers” to “laptop stickers”.
[implied_tags] (optional)
this section is for automatically adding tags to your posts when they contain a specific tag. this takes effect after [renamed_tags].
you can use this to tag your posts with more general tags (e.g. “photography”) when they have a more specific tag (e.g. “bird photography”). the implied tags (to the right of “=”) are inserted before the specific tag, so the more general tags come first.
"bird photography" = ["birds", "photography"]
- when a post is tagged “bird photography”, replace that tag with “birds”, “photography”, and “bird photography”.
[[nav]] (optional)
you can have any number of these sections, or none at all. each of these sections adds a link to the navigation at the top of the html output.
href = "." (required in section)
- url of the link. relative urls are relative to
base_url, not to the current page.
text = "posts" (required in section)
- text to display in the link.