blob: 26aff757bdafae4720353502b3e80ede515f3e01 (
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
|
# Introduction
This is a collection of design documents, formerly maintained in various
different locations and formats, now grouped together and converted
to commonmark.
# Contributing
## Style
We will follow the commonmark specification.
We *should* try to follow this
[style guide](http://www.cirosantilli.com/markdown-style-guide/#about),
but are still [evaluating solutions](https://github.com/jgm/cmark/issues/131)
for *stable* automatic formatting.
80 columns line width is thus not yet enforced, but strongly suggested.
# Build a web portal from the sources
## Install dependencies
* Follow [hotdoc's installation guide](https://people.collabora.com/~meh/hotdoc_hotdoc/html/installing.html),
preferably in a virtualenv.
* We *experimentally* use the hotdoc C extension to include functions by
name, follow the steps outlined [here](https://github.com/hotdoc/hotdoc_c_extension)
* We recompile and override hotdoc's default theme, which is a submodule of this project:
```
git submodule update --init
```
Follow the instructions outlined in the theme's README.md, you can dispense
with the last step (building the theme):
```
cd theme/hotdoc_bootstrap_theme
sudo dnf install nodejs # On Fedora
sudo apt-get install nodejs nodejs-legacy npm # debian
sudo pacman -S nodejs npm # arch
npm install && ./node_modules/bower/bin/bower install
cd ../..
```
* Build the portal:
```
make
```
* And browse it:
```
xdg-open built_doc/html/index.html
```
## Licensing
The content of this module comes from a number of different sources and is
licensed in different ways:
### Tutorial source code
All tutorial code is licensed under any of the following licenses (your choice):
- 2-clause BSD license ("simplified BSD license") (`LICENSE.BSD`)
- MIT license (`LICENSE.MIT`)
- LGPL v2.1 (`LICENSE.LGPL-2.1`)
This means developers have maximum flexibility and can pick the right license
for any derivative work.
### Application Developer Manual and Plugin Writer's Guide
These are licensed under the [Open Publication License v1.0][op-license]
(`LICENSE.OPL`), for historical reasons.
[op-license]: http://www.opencontent.org/openpub/
### Documentation
Mostly licensed under the [Creative Commons CC-BY-SA-4.0 license][cc-by-sa-4.0],
but some parts of the documentation may still be licensed differently
(e.g. LGPLv2.1) for historical reasons.
[cc-by-sa-4.0]: https://creativecommons.org/licenses/by-sa/4.0/
|
