]> git.baikalelectronics.ru Git - kernel.git/commit
docs-rst: automatically convert Graphviz and SVG images
authorMarkus Heiser <markus.heiser@darmarit.de>
Mon, 6 Mar 2017 13:09:27 +0000 (14:09 +0100)
committerJonathan Corbet <corbet@lwn.net>
Thu, 9 Mar 2017 09:59:26 +0000 (02:59 -0700)
commit9dc5c36214b1aa71f2bb885465c7349568ccfc8e
tree2f5646aff5210a2669cdb8a624fc40f2797836d5
parente6df06776c4b807d8119fee37230d612ce4bfc6c
docs-rst: automatically convert Graphviz and SVG images

This patch brings scalable figure, image handling and a concept to
embed *render* markups:

* DOT (http://www.graphviz.org)
* SVG

For image handling use the 'image' replacement::

    .. kernel-image::  svg_image.svg
       :alt:    simple SVG image

For figure handling use the 'figure' replacement::

    .. kernel-figure::  svg_image.svg
       :alt:    simple SVG image

       SVG image example

Embed *render* markups (or languages) like Graphviz's **DOT** is
provided by the *render* directive.::

  .. kernel-render:: DOT
     :alt: foobar digraph
     :caption: Embedded **DOT** (Graphviz) code.

     digraph foo {
      "bar" -> "baz";
     }

The *render* directive is a concept to integrate *render* markups and
languages, yet supported markups:

* DOT: render embedded Graphviz's **DOT**
* SVG: render embedded Scalable Vector Graphics (**SVG**)

Cc: Jani Nikula <jani.nikula@linux.intel.com>
Cc: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Tested-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Tested-by: Daniel Vetter <daniel.vetter@ffwll.ch>
Signed-off-by: Daniel Vetter <daniel.vetter@intel.com> (v2 - v5)
Signed-off-by: Markus Heiser <markus.heiser@darmarit.de> (v1, v6)
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/conf.py
Documentation/doc-guide/hello.dot [new file with mode: 0644]
Documentation/doc-guide/sphinx.rst
Documentation/doc-guide/svg_image.svg [new file with mode: 0644]
Documentation/process/changes.rst
Documentation/sphinx/kfigure.py [new file with mode: 0644]