Documentation/contributor/website-work.itexi

   1 @c -*- coding: us-ascii; mode: texinfo; -*-
   2 @node Website work
   3 @chapter Website work
   4
   5 @menu
   6 * Introduction to website work::
   7 * Translating the website::
   8 @end menu
   9
  10
  11 @node Introduction to website work
  12 @section Introduction to website work
  13
  14 The website is @emph{not} written directly in HTML;
  15 instead, the source is Texinfo, which is then generated into HTML,
  16 PDF, and Info formats.  The sources are
  17
  18 @verbatim
  19 Documentation/web.texi
  20 Documentation/web/*.texi
  21 @end verbatim
  22
  23 Unless otherwise specified, follow the instructions and policies
  24 given in @ref{Documentation work}.  That chapter also contains a
  25 quick introduction to Texinfo; consulting an external Texinfo
  26 manual should be not necessary.
  27
  28 @subheading Exceptions to the documentation policies
  29
  30 @itemize
  31
  32 @item
  33 Sectioning: the website only uses chapters and sections; no
  34 subsections or subsubsections.
  35
  36 @dots{}
  37
  38 @item
  39 For anything not listed here, just follow the same style as the
  40 existing texinfo files.
  41
  42 @end itemize
  43
  44
  45 @node Translating the website
  46 @section Translating the website
  47
  48 As it has much more audience, the website should be translated before
  49 the documentation; see @ref{Translating the documentation}.