sandbox/grubert/test/literal.txt

   1 Literal Blocks
   2 --------------
   3
   4 Literal blocks are indented, and indicated with a double-colon ("::")
   5 at the end of the preceding paragraph (right here ``-->``)::
   6
   7     if literal_block:
   8         text = 'is left as-is'
   9         spaces_and_linebreaks = 'are preserved'
  10         markup_processing = None
  11
  12 Or some code formatting ::
  13
  14      typedef
  15
  16        mpl::push_back<           // >----------------+
  17                                  //                  |
  18            mpl::push_back<       // >--------------+ |
  19                                  //                | |
  20                mpl::push_back<   // >------------+ | |
  21                    mpl::vector<> //              | | |
  22                  , int           //              | | |
  23                >::type           // first step <-+ | |
  24              , long              //                | |
  25            >::type               // second step <--+ |
  26          , double                //                  |
  27        >::type                   // third step <-----+
  28
  29      vec;
  30
  31 The central makefile construct is called a *rule*, and is described
  32 with the following syntax:
  33
  34 .. parsed-literal::
  35
  36    *dependent-target* : *prerequisites*
  37            *commands*
  38
  39
  40 parsed literal with markup spanning lines. should produce valid LaTeX
  41 code, but the indentation is ragged.
  42
  43 .. parsed-literal::
  44
  45    Hey!
  46      *this is some emphasized text
  47      that spans two lines* and
  48      this is **some more bold text
  49      spanning two lines**
  50
  51
  52
  53 a literal block with underscores and markup
  54
  55 .. parsed-literal::
  56
  57        mpl::push_back<           // >----------------+
  58                                  //                  |
  59            mpl::push_back<       // >--------------+ |
  60                                  // <- *end* ------+-+
  61
  62
  63 inline ``literal`` with double hyphen ``two hyphens: --`` and tripplets
  64 ``three hyphens: ---``.
  65
  66 Special characters
  67 ------------------
  68
  69 lele needed a patch to process the italian ZopeBook, because
  70 of the tilde ~ and the backquote chars.
  71
  72 1. scaricarlo anche usando un browser web::
  73
  74      lele:~/zope $ wget http://zope.org/Products/Zope/2.7.0/Zope-2.7.0-linux-x86.tgz
  75      --00:49:51--  http://zope.org/Products/Zope/2.7.0/Zope-2.7.0-linux-x86.tgz
  76                 => `Zope-2.7.0-linux-x86.tgz'
  77
  78
  79 this works as long as the document is not italian.
  80
  81 bracketts at line start and empty lines
  82
  83 .. parsed-literal::
  84
  85    with
  86    [
  87        _Container=std::map<std::string,std::string>,
  88        _InIt=std::list<std::string>::iterator
  89    ]
  90    *messages continue...*
  91