Usage

Sitix is a KISS program, so there's not a lot of setup. Once you've got it installed (see for information on that), you need a project to build. The simplest Sitix project structure is just a site folder, which contains the actual Sitix "scripts". When (you absolutely must be outside of the site directory to do this!) you run sitix site, Sitix will delete the output directory and all contents, if it exists, and then create a new output directory for the compiled site code. Then, Sitix will walk down the tree of your site directory, creating appropriate subdirectories and directly copying over any file that doesn't have an opening phrase - [!], for a Sitix page, or [?] for a data page (which will not be rendered itself, but may be used for templating or configuration). The opening phrase MUST be the first three bytes of the file; if there are any whitespaces before it, the file will be treated as plain data. If you want it to render to a different directory, pass the -o location flag.
WARNING: -o is very dangerous! If you tell Sitix to render to a directory with important information in it, that directory is as good as gone. At the moment Sitix does not put any effort into questioning your choices, so make sure to double-check everything is okay before running any sitix command! Avoiding -o unless you really need it is generally a good policy.
Let's cover some syntax. All Sitix commands are enclosed in brackets like [command] (you can escape brackets with backslashes). There aren't very many Sitix commands; at the moment, it's just: You can use Sitix commands in any file with a Sitix opening phrase; Sitix commands in files that do not have an opening phrase will be ignored.
And that's it! To see how these are used creatively in the wild, check out the source code for this website.
For a more thorough look at Sitix, check out the source code. There's a rather large comment at the start of main.cpp that provides a deep look at Sitix syntax and usage.
Sitix by Tyler Clarke
Shameless Plugs
Tyler Clarke's personal site
Tyler Clarke's (old) webcomic/blog/personal site
Fedora Linux
GNU
The Free Software Foundation
The Avraham Society (first site to be officially generated with Sitix)
The Not Art Gallery
Places in This Site
Home
About
Install Sitix
Todo
Noteboard
Usage
Information
Sitix (including this website) is open-source Free Software protected by GNU GPLv3. Looking to contribute? The source code for this website is hosted on Github, as is Sitix itself.
Sitix is still young and probably buggy; if you have issues, submit a bug report at the issues page or contact me at plupy44@gmail.com (github issue preferred).
If you want to contribute, but don't know where to start, see The Todo List.
Site designed by Tyler Clarke and built with Sitix. This page uses the Lato fonts.