commit 2331d73d3cf2c21ab1c3087d140b461bd34ecaae Author: Luke Murphy Date: Fri May 17 13:09:34 2019 +0200 Bootstrapping the manual diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..2480ecf --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ +site/ +src/ diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..20bc7c8 --- /dev/null +++ b/Makefile @@ -0,0 +1,8 @@ +build: + @mkdocs build && \ + mkdir site/pd site/epub && \ + mkdocscombine -o site/pd/manual.pd --no-titles && \ + pandoc --toc -f markdown+grid_tables -t epub -o site/epub/manual.epub site/pd/manual.pd + +serve: + @mkdocs serve diff --git a/README.md b/README.md new file mode 100644 index 0000000..ac47e60 --- /dev/null +++ b/README.md @@ -0,0 +1,18 @@ +# Manual.Bibliotecha.Info + +The manual for Bibliotecha. + +> https://manual.bibliotecha.info + +# Contribute to the Manual + +``` +$ python3 -m venv .venv && source .venv/bin/activate +$ pip install -r requirements.txt +$ make serve +``` + +References: + + * [Python virtual environment](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/#creating-a-virtual-environment) documentation + * [MkDocs](https://www.mkdocs.org/) documentation diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 0000000..691b055 --- /dev/null +++ b/docs/index.md @@ -0,0 +1,30 @@ +# Bibliotecha Manual + +> [bibliotecha.info/](https://bibliotecha.info/) + +> Bibliotecha is a framework to facilitate the local distribution of digital +> publications within a small community. It relies on a microcomputer running +> open-source software to serve books over a local wifi hotspot. Using the +> browser to connect to the library one can retrieve or donate texts. +> Bibliotecha proposes an alternative model of distribution of digital texts +> that allows specific communities to form and share their own collections. + +--- + +[TOC] + +--- + +## Introduction + +Welcome to the Bibliotecha manual! + +## Prerequisites + +## Pre-installation + +## Installation + +## Post-installation + +## Troubleshooting diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 0000000..2e2d628 --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,18 @@ +site_name: Bibliotecha +site_url: https://manual.bibliotecha.info/ + +theme: alabaster + +nav: + - Manual: index.md + +markdown_extensions: + - abbr + - toc + +plugins: + - search: + lang: en + - pdf-export: + combined: True + combined_output_path: pdf/manual.pdf diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..3f62df9 --- /dev/null +++ b/requirements.txt @@ -0,0 +1,4 @@ +mkdocs==1.0.4 +mkdocs-pdf-export-plugin==0.5.5 +mkdocs-alabaster==0.8.0 +-e git+https://github.com/twardoch/mkdocs-combine.git#egg=mkdocs-combine