blob: e3aed0ed2daae3775d0afc551b371888c9c72a35 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
|
-*- mode: org -*-
#+TITLE: spine (sisudoc) (project) README
#+DESCRIPTION: README for spine
#+FILETAGS: :spine:build:tools:
#+AUTHOR: Ralph Amissah
#+EMAIL: [[mailto:ralph.amissah@gmail.com][ralph.amissah@gmail.com]]
#+COPYRIGHT: Copyright (C) 2015 - 2024 Ralph Amissah
#+LANGUAGE: en
#+STARTUP: content hideblocks hidestars noindent entitiespretty
#+OPTIONS: H:3 num:nil toc:t \n:nil @:t ::t |:t ^:nil _:nil -:t f:t *:t <:t
#+PROPERTY: header-args :exports code
#+PROPERTY: header-args+ :noweb yes
#+PROPERTY: header-args+ :eval no
#+PROPERTY: header-args+ :results no
#+PROPERTY: header-args+ :cache no
#+PROPERTY: header-args+ :padline no
project_name: "sisudoc spine (doc reform) markup samples"
description:
- "markup samples for the project sisudoc spine"
- "sisu markup"
- "search"
- "object numbering"
- "static content generator"
author:
name: "Ralph Amissah"
email: ralph.amissah@gmail.com
copyright: "(C) 2015 - 2024 Ralph Amissah, All Rights Reserved."
license:
- "markup samples substantive content: as granted by original authors & publishers (as indicated in each document)"
- "project code: AGPL 3 or later"
homepage:
- "https://sisudoc.org"
- "https://doc-reform.org"
git:
- "https://git.sisudoc.org"
* Summary
These are document markup samples for the program sisudoc-spine prepared in the
markup language sisu. The markup of document headers for sisudoc-spine now use
yaml (instead of bespoke sisu markup headers) and sisudoc-spine documents are
(optionally) presented in a preferred directory structure that is absent in
sisu.
Sample files are provided under the directory: ./markup/
A few document samples without the formal directory structure are provided in:
./markup/non-pod-samples/
This is the easiest way to start preparation of a document, in a file with a
.sst extension, marked up in sisu. Any images belonging to documents going in a
sub-directory called image. sisudoc-spine can be run against the prepared .sst
file.
sisudoc-spine organizes document source into pods (sisupods). Document samples
using the directory structure for sisudoc-spine are located under: ./markup/pod/
(this includes a number of prepared books and articles).
individual .sst files with their associated images are automatically converted
to sisupods if the source is to be shared or bundled with the commands:
spine --source [.sst document name]
# or bundled with:
spine --pod [.sst document name]
or
spine --source --pod [.sst document name]
* Installation, Compilation
These are document markup samples for the program sisudoc-spine and as such
there is no installation that needs to be done. You may use the examples to
understand how you might markup your own documents. To produce output, you would
run the program sisudoc-spine against the markup sample using a command line
instruction. The sources of relevant parts of the project are here:
https://sisudoc.org
https://git.sisudoc.org
git clone --depth=1 git://git.sisudoc.org/software/sisudoc-spine && \
git clone --depth=1 git://git.sisudoc.org/software/sisudoc-spine-search-cgi && \
git clone --depth=1 git://git.sisudoc.org/markup/sisudoc-spine-samples
you may wish to clone these into a directory created for the purpose, e.g.
mkdir ~/git.sisudoc
cd ~/git.sisudoc
and then git clone sisudoc-spine-samples
sisudoc-spine-samples provides markup samples for sisudoc-spine to use
sisudoc-spine to generate document output see the README in that directory.
cd sisudoc-spine-samples
*** build using nix flakes on linux (binary in ./result/bin)
If you happen to be using Nix or NixOS (x86_64-linux so far), you can install
sisudoc-spine from the flake.nix file provided in this (sisudoc-spine-samples)
directory tree, without first cloning sisudoc-spine (the flake will fetch and
build from online source).
NOTE all actions to build sisudoc-spine under current discusson are taken within
the directory sisudoc-spine-samples
choose one of the following nix flake runes to build sisudoc-spine (here in the
sisudoc-spine-samples directory tree):
nix build ".#spine-overlay-ldc" --print-build-logs
nix build ".#spine-overlay-dmd" --print-build-logs
the result which can be used to generate content should be available in:
./result/bin/spine
What you do with these is run sisudoc-spine (now available loocally) against the
document source to get the desired output.
* sisudoc-spine pod structure
pod (directory may contain multiple documents)
└── the_wealth_of_networks.yochai_benkler
├── conf
│ └── sisu_document_make
├── media
│ ├── image
│ │ ├── won_benkler_2_1.png
│ │ ├── won_benkler_6_1.png
│ │ ├── won_benkler_7_1.png
│ │ ├── won_benkler_7_2.png
│ │ ├── won_benkler_7_3a.png
│ │ ├── won_benkler_7_3b.png
│ │ ├── won_benkler_7_4.png
│ │ ├── won_benkler_7_5.png
│ │ ├── won_benkler_7_6.png
│ │ └── won_benkler_9_1.png
│ └── text
│ └── en
│ └── the_wealth_of_networks.yochai_benkler.sst
└── pod.manifest
* Document processing examples
e.g.:
./result/bin/spine -v --source --pod --epub --html --html-link-curate --html-link-markup --curate --output=./OUTPUT_TEST_sisudocSpine ./markup/pod/*
with sisudoc-spine installed, for a list of commands from the program type:
spine -h
or see the README in sisudoc-spine for more information and examples of command
flags and configuration options
|
