[Home]

TS 1 DocsAboutInstallFormatsOverridesStructure

Note: This is incomplete documentation for an old version of TachibanaSite. A new version is in the works, and this site runs on it in compatibility mode.

AutoTS Installation

AutoTS is still quite alpha, but the installer works pretty well. 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

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, (note from the future: yours should work better, especially on mobile) go back and make sure you input everything correctly.