wip: Include markdown content, via pandoc
authorMatthias Clasen <mclasen@redhat.com>
Sat, 23 May 2020 01:56:39 +0000 (21:56 -0400)
committerMatthias Clasen <mclasen@redhat.com>
Mon, 25 May 2020 20:11:18 +0000 (16:11 -0400)
commit10cd539104af54f5d1d1e49618f5aa9d8ac42074
tree41ae6d4bcaea2be727a658c757fff46d694d19bf
parent2127cc19437bc1e474225a7accaf7c14547e1457
wip: Include markdown content, via pandoc

Use pandoc to convert freestanding markdown files to docbook for
inclusion in the generated docs, and use bits and pieces of
gtk-doc code to continue expanding typical gtk-doc abbreviations.
The new tool for markdown -> docbook is a python script called
gtk-markdown-to-docbook.

The markdown dialect is specified via a list of pandoc extension
in gtk-markdown-to-docbook. It includes header annocations,
definition lists and tables, among other things.

This commit converts the 3 overview chapters (drawing, input
handling and actions) and the migration guide to markdown
syntax. Other files that are still listed in content_files
can be converted later.

This commit adds a pandoc dependency.
14 files changed:
docs/reference/gtk/actions.md [new file with mode: 0644]
docs/reference/gtk/actions.xml [deleted file]
docs/reference/gtk/drawing-model.md [new file with mode: 0644]
docs/reference/gtk/drawing-model.xml [deleted file]
docs/reference/gtk/gtk-markdown-to-docbook [new file with mode: 0755]
docs/reference/gtk/gtk4-docs.xml
docs/reference/gtk/input-handling.md [new file with mode: 0644]
docs/reference/gtk/input-handling.xml [deleted file]
docs/reference/gtk/lists-overview.md [new file with mode: 0644]
docs/reference/gtk/meson.build
docs/reference/gtk/migrating-2to4.md [new file with mode: 0644]
docs/reference/gtk/migrating-2to4.xml [deleted file]
docs/reference/gtk/migrating-3to4.md [new file with mode: 0644]
docs/reference/gtk/migrating-3to4.xml [deleted file]