waf

FORK: waf with some random patches
git clone https://git.neptards.moe/neptards/waf.git
Log | Files | Refs | README

test1.rst (1534B)


      1 #########
      2 Example 1
      3 #########
      4 
      5 :purpose: demonstrate basic rst processing
      6 
      7 Static SVG Picture
      8 ##################
      9 
     10 .. figure:: test.svg
     11    :align: center
     12    :width: 50%
     13 
     14    This is a static svg file
     15 
     16 Generated PNG Picture
     17 #####################
     18 
     19 .. figure:: test.png
     20    :align: center
     21    :width: 50%
     22 
     23    This figure is a png file generated
     24    (in the build folder of course).
     25 
     26    As of 2013-08-25, rst2pdf and docutils do not have
     27    some way of specifying include paths, in which includes
     28    are searched.
     29    So the figure is broken.
     30    We could generate the figure in the source directory,
     31    but I prefer not having a figure at all for the sake
     32    of cleanleness.
     33    A docutils patch is available here though:
     34    http://zougloub.eu/git/overlay-zougloub/plain/dev-python/docutils/files/docutils-0.11-search-path.patch
     35 
     36 
     37 Generated rst Content
     38 #####################
     39 
     40 .. include:: generated.rst
     41 
     42 Generated CSV Content
     43 #####################
     44 
     45 As of 2013-08-25, waf doesn't scan the csv-table directive
     46 including an external file. You'll have to specify
     47 the dependency manually, use build groups, or count on your luck.
     48 
     49 .. csv-table::
     50    :file: generated.csv
     51 
     52 
     53 
     54 
     55 Generated Content using raw Directive
     56 #####################################
     57 
     58 The following line will be empty if not using the HTML
     59 output.
     60 
     61 .. raw:: html
     62    :file: generated.html
     63 
     64 Did you see something?
     65 
     66 As of 2013-08-25, waf doesn't scan the raw directive
     67 including an external file. You'll have to specify
     68 the dependency manually, use build groups, or count on your luck.
     69