GStreamer multimedia framework
Find a file
2017-10-19 20:48:47 -07:00
examples basic-tutorial-3: remove leading spaces in prints 2017-10-12 10:28:43 +03:00
images Split out documentation into subfolders. 2016-11-14 14:10:22 +00:00
markdown faq: git: improve content and formatting 2017-10-19 20:48:47 -07:00
plugins-introspection plugins: add plugin introspection xml files 2016-11-28 23:56:47 +00:00
theme Update theme submodule 2017-04-25 02:17:21 +02:00
.gitignore plugins: add script to generate plugins list from module xml files 2016-11-28 23:56:38 +00:00
.gitmodules Split out documentation into subfolders. 2016-11-14 14:10:22 +00:00
hotdoc.json Add project version as it is now required by hotdoc 2017-04-05 09:50:37 -03:00
Makefile Makefile: check for hotdoc before attempting upload 2016-12-08 07:38:41 +00:00
README Fix up README for recent changes 2016-11-14 14:31:48 +00:00
sitemap.txt design: add RTP design docs from -good 2016-12-10 12:16:43 +00:00
TODO.md Move licensing page over from www module 2016-11-29 10:28:14 +00:00

# 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
```