aboutsummaryrefslogtreecommitdiff
path: root/content
diff options
context:
space:
mode:
authorSilvio Rhatto <rhatto@riseup.net>2024-06-06 08:42:24 -0300
committerSilvio Rhatto <rhatto@riseup.net>2024-06-06 08:42:24 -0300
commitddbf070bded29947f6e6595f29d99a7c08822462 (patch)
treea0a47aa9f28f4ff0e0042cf8b37d6da842c8b681 /content
parent515bdd658d91020c73f82b70ff001015b359adc0 (diff)
downloadbookup-ddbf070bded29947f6e6595f29d99a7c08822462.tar.gz
bookup-ddbf070bded29947f6e6595f29d99a7c08822462.tar.bz2
Misc improvements
Diffstat (limited to 'content')
-rw-r--r--content/published/00-intro/intro.md36
1 files changed, 36 insertions, 0 deletions
diff --git a/content/published/00-intro/intro.md b/content/published/00-intro/intro.md
index 306ce81..f6613d3 100644
--- a/content/published/00-intro/intro.md
+++ b/content/published/00-intro/intro.md
@@ -5,3 +5,39 @@ implementar e corrigir funcionalidades paralelamente em muitos repositórios, jÃ
que os livros tendem a aumentar. Lidando com a produção de conteúdo como
lidamos com outros códigos, mas sem algoritmizar, ao contrário: usando um
processo arbóreo-espiral.
+
+# Folder structure {#structure}
+
+Book folder structure:
+
+* `archive`: to hold archives (older book versions).
+* `content`: book content:
+ * `drafts`: leave here texts still being redacted.
+ * `published`: here goes all the material to be compiled.
+* `notes`: notebook.
+* `slides`: slides in Markdown format.
+* `site`: optional HTML used for the base site; if this exists, the book will
+ be placed under `public/book` or something like that.
+* `public`: compiled book (HTML, PDF and other formats):
+ * `notes`: compiled notebook.
+ * `book`: compiled book if there's a `site` folder, otherwise book contents
+ will be placed in the root of the public folder.
+* `biblio`: bibliography.
+* `images`: images folder.
+* `vendor/bookup`:
+ * `content`: Bookup documentation.
+ * `vendor/{Fuse.js,}`: dependencies.
+
+# Instalation {#installation}
+
+Setup procedure:
+
+* Vendorizantion (`bookup` and bibliography repositories).
+* Symlinking.
+* Basic files:
+ * `images/cover.png`.
+ * `_bookup.yml`.
+ * `_biblio.yml`.
+ * `LICENSE`.
+ * `DISCLAIMER`.
+ * `snippets/`.