Prepare your first Contenticious site
Contenticious builds a web site from Markdown files that it finds in a
directory structure. But there's a little more. Use the contenticious
command to generate everything you need in an empty directory:
$ cd foo
$ contenticious init
generating contenticious boilerplate...
[exist] /Users/memowe/Desktop/foo
[write] /Users/memowe/Desktop/foo/config
...
done.
This command will generate four things for you:
- config - a simple config file
With this config file you can tell Contenticious some basic things like where it'll find your content pages or your name. For now, the default values are fine. - pages - the content directory
Contenticious uses this directory to search for Markdown files. Three example pages are already there. - public - used for static content If you want to add something like images or PDF documents to your pages, just add them to this directory. You'll also find the default stylesheet in this directory which is used to make your content as pretty as possible.
- webapp.pl - The actual web app script
This script will be called with several commands to work with Contenticious.
As a first step with your newly created Contenticious directory, start the built-in server:
$ ./webapp.pl daemon
...
Server available at http://127.0.0.1:3000.
Look up that address (http://127.0.0.1:3000
) in your favourite browser.
You should see a nice little web site which says something like
Hi there, Contenticious is working.
Next step: Edit your first Contenticious document