doc/main/text/man-structure.en.tm

   1 <TeXmacs|1.0.2.9>
   2
   3 <style|tmdoc>
   4
   5 <\body>
   6   <tmdoc-title|Typing structured text>
   7
   8   Usually, long documents have a structure: they are organized in chapters,
   9   sections and subsections, they contain different types of text, such as
  10   regular text, citations, footnotes, theorems, etc. After selecting a
  11   <def-index|document style> in <menu|Document|Style>, <TeXmacs> takes care
  12   of specific layout issues, such as numbering of sections, pages, theorems,
  13   typesetting citations and footnotes in a nice way and so on.
  14
  15   Currently, four standard document styles have been implemented: letter,
  16   article, book and seminar. The seminar style is used for making
  17   transparencies. As soon as you have selected such a style, you can organize
  18   your text into sections (see <menu|Text|Section>) and use specific
  19   <def-index|environments>. Examples of environments are theorem,
  20   proposition, remark and so on (see <menu|Text|Environment>). Other examples
  21   are lists of items (see <menu|Text|Itemize>) or numbered lists (see
  22   <menu|Text|Enumerate>).
  23
  24   When you get more acquainted with <TeXmacs>, it is possible to add your own
  25   new environments in your own style file. Assume for instance that you often
  26   make citations and that you want those to appear in italic, with left and
  27   right margins of 1cm. Instead of manually changing the text and paragraph
  28   properties each time you make a citation, it is better to create a citation
  29   environment. Not only it will be faster to create a new citation when doing
  30   so, but it is also possible to systematically change the layout of your
  31   citations throughout the document just by changing the definition of the
  32   citation environment. The latter situation occurs for instance if you
  33   discover <with|font-shape|italic|a posteriori> that you prefer the
  34   citations to appear in a smaller font.
  35
  36   <tmdoc-copyright|1998--2002|Joris van der Hoeven>
  37
  38   <tmdoc-license|Permission is granted to copy, distribute and/or modify this
  39   document under the terms of the GNU Free Documentation License, Version 1.1
  40   or any later version published by the Free Software Foundation; with no
  41   Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
  42   Texts. A copy of the license is included in the section entitled "GNU Free
  43   Documentation License".>
  44 </body>
  45
  46 <\initial>
  47   <\collection>
  48     <associate|page-even|30mm>
  49     <associate|page-reduce-bot|15mm>
  50     <associate|page-reduce-right|25mm>
  51     <associate|page-reduce-left|25mm>
  52     <associate|sfactor|4>
  53     <associate|page-top|30mm>
  54     <associate|page-type|a4>
  55     <associate|page-right|30mm>
  56     <associate|par-width|150mm>
  57     <associate|page-odd|30mm>
  58     <associate|page-bot|30mm>
  59     <associate|language|english>
  60     <associate|page-reduce-top|15mm>
  61   </collection>
  62 </initial>
  63
  64 <\references>
  65   <\collection>
  66     <associate|idx-5|<tuple|<uninit>|?>>
  67     <associate|idx-6|<tuple|<uninit>|?>>
  68     <associate|idx-7|<tuple|<uninit>|?>>
  69     <associate|toc-1|<tuple|<uninit>|?>>
  70     <associate|idx-1|<tuple|<uninit>|?>>
  71     <associate|idx-2|<tuple|<uninit>|?>>
  72     <associate|idx-3|<tuple|<uninit>|?>>
  73     <associate|idx-4|<tuple|<uninit>|?>>
  74   </collection>
  75 </references>
  76
  77 <\auxiliary>
  78   <\collection>
  79     <\associate|idx>
  80       <tuple|<tuple|document style>|<pageref|idx-1>>
  81
  82       <tuple|<tuple|<with|font-family|<quote|ss>|Document>|<with|font-family|<quote|ss>|Style>>|<pageref|idx-2>>
  83
  84       <tuple|<tuple|<with|font-family|<quote|ss>|Text>|<with|font-family|<quote|ss>|Section>>|<pageref|idx-3>>
  85
  86       <tuple|<tuple|environments>|<pageref|idx-4>>
  87
  88       <tuple|<tuple|<with|font-family|<quote|ss>|Text>|<with|font-family|<quote|ss>|Environment>>|<pageref|idx-5>>
  89
  90       <tuple|<tuple|<with|font-family|<quote|ss>|Text>|<with|font-family|<quote|ss>|Itemize>>|<pageref|idx-6>>
  91
  92       <tuple|<tuple|<with|font-family|<quote|ss>|Text>|<with|font-family|<quote|ss>|Enumerate>>|<pageref|idx-7>>
  93     </associate>
  94   </collection>
  95 </auxiliary>