AutoTS Installation

The AutoTS installer works pretty well, it's just missing some advanced features. You can install with AutoTS and then edit files manually, and you shouldn't run into any issues. If you do encounter issues, please submit them to the GitHub project.

To install with AutoTS, go into the directory where you want your site, and run:

$ curl -O https://raw.githubusercontent.com/NighttimeDriver50000/tachibanasite/master/_install_ts.sh
$ sh _install_ts.sh

Then follow the on-screen instructions.

Manual Installation

THESE INSTRUCTIONS ARE OUT-OF-DATE. Just do an AutoTS install and then use the other documentation on this site to manually do more advanced stuff

Enter the directory where you want to put your site:

cd /<host_path>/<site_url>

where <host_path> is the path on disk corresponding to the URL / on your server (e.g. /var/www), and <site_url> is the URL path to your site root (e.g. /ts).

Run:

git clone https://github.com/NighttimeDriver50000/tachibanasite.git
cd tachibanasite
git submodule update --init --recursive
cd ..

Make a directory called common, and put a file in it called config.ini:

[TachibanaSite]
local_host_path = "/<host_path>"
install_url = "/<site_url>/tachibanasite"
enable_templates = yes

Quick Start

Create a file common/header.markdown:

# My Site

Create a file common/navlist.markdown.template:

% import os, configIniUtils
% base = os.path.dirname(configIniUtils.get_install_url())
* [Home]({{base}}/home/)

Make a directory called home, and put a file in it called index.php:

<?php include '../tachibanasite/utils/FindStandardPage.php' ?>

You will need a file like this in every page directory in order to bootstrap TachibanaSite.

Create a file home/index.markdown:

*Hello, world!*

Create a file index.php:

<?php
header('Location: /<site_url>/home/', true, 303);
die();
?>

Now go to your site. You should see a simple page with the default black-and-white theme, "My Site" at the top, and the content "Hello, world!". If your page doesn't look like this, go back and make sure you input everything correctly.

Bootstrap

To enable Bootstrap, edit your config.ini, adding the following lines:

theme_name = "bootstrap"

[Modules]
mobiletext_disabled = yes
bootstrap_disabled = no
bootstrapify_disabled = no

Then rename your header.markdown to header.markdown.template and edit it:

% import os, configIniUtils
% base = os.path.dirname(configIniUtils.get_install_url())
# [My Site]({{base}}/bootstrap/)

Your page should now look like this.