test1.rst 1.5 KB

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