diff options
author | Johannes 5 Joemann <joemann@beefree.free.de> | 2023-08-20 20:16:05 +0200 |
---|---|---|
committer | Robert Clausecker <fuz@FreeBSD.org> | 2023-09-24 14:57:13 -0400 |
commit | 7fa7c89ce00609a13b933c096eda065d3eb578c7 (patch) | |
tree | 866b40d2dad271c803549a017413287be52f0102 /www/hs-gitit/files/patch-data_markup.DocBook | |
parent | devel/py-pyhcl: Update to 0.4.5 (diff) |
www/hs-gitit: Restore and update to 0.15.1.1
Gitit is a wiki program written in Haskell. It uses Happstack for the
web server and pandoc for markup processing. Pages and uploaded files
are stored in a git, darcs, or mercurial repository and may be
modified either by using the VCS's command-line tools or through
the wiki's web interface. By default, pandoc's extended version of
markdown is used as a markup language, but reStructuredText, LaTeX,
HTML, DocBook, or Emacs Org-mode markup can also be used. Gitit can
be configured to display TeX math (using texmath) and highlighted
source code (using highlighting-kate).
Other features include
* plugins: dynamically loaded page transformations written in
Haskell (see "Network.Gitit.Interface")
* categories
* caching
* Atom feeds (site-wide and per-page)
* a library, "Network.Gitit", that makes it simple to include
a gitit wiki in any happstack application
WWW: https://github.com/jgm/gitit
PR: 273260
Diffstat (limited to 'www/hs-gitit/files/patch-data_markup.DocBook')
-rw-r--r-- | www/hs-gitit/files/patch-data_markup.DocBook | 748 |
1 files changed, 748 insertions, 0 deletions
diff --git a/www/hs-gitit/files/patch-data_markup.DocBook b/www/hs-gitit/files/patch-data_markup.DocBook new file mode 100644 index 000000000000..823421ff0e3b --- /dev/null +++ b/www/hs-gitit/files/patch-data_markup.DocBook @@ -0,0 +1,748 @@ +--- data/markup.DocBook.orig 2001-09-09 01:46:40 UTC ++++ data/markup.DocBook +@@ -1,347 +1,411 @@ +-<sect1 id="markdown"> +- <title>Markdown</title> ++# Markdown ++ ++The usual way to write pages for this wiki is [pandoc]'s extended form ++of [markdown]. You can start using markdown and later switch to ++DocBook by using `pandoc` to convert your markdown page to DocBook for ++more sophisticated formatting. To do so use the wiki's export option ++(if enabled) or `pandoc -f markdown -t docbook -o page.xml page.md`. ++Further down on this page there is some information about the DocBook ++format. Here we continue with an introduction to markdown. ++If you're not familiar with markdown, you should start by looking ++at the [markdown "basics" page] and the [markdown syntax description]. ++Consult the [pandoc User's Guide] for information about pandoc's syntax ++for footnotes, tables, description lists, and other elements not present ++in standard markdown. ++ ++[pandoc]: http://pandoc.org ++[pandoc User's Guide]: http://pandoc.org/README.html ++[markdown]: http://daringfireball.net/projects/markdown ++[markdown "basics" page]: http://daringfireball.net/projects/markdown/basics ++[markdown syntax description]: http://daringfireball.net/projects/markdown/syntax ++ ++Markdown is pretty intuitive, since it is based on email conventions. ++Here are some examples to get you started: ++ +++--------------------------------------------------------+------------------------------------------------------------+ ++| Markdown code | Result | +++========================================================+============================================================+ ++| `*emphasized text*` | *emphasized text* | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `**strong emphasis**` | **strong emphasis** | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `` `literal text` `` | `literal text` | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `\*escaped special characters\*` | \*escaped special characters\* | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `[external link](http://google.com)` | [external link](http://google.com) | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `` |  | +++--------------------------------------------------------+------------------------------------------------------------+ ++| Wikilink: `[Front Page]()` | Wikilink: [Front Page]() | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `H~2~O` | H~2~O | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `10^100^` | 10^100^ | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `~~strikeout~~` | ~~strikeout~~ | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `$x = \frac{{ - b \pm \sqrt {b^2 - 4ac} }}{{2a}}$` | $x = \frac{{ - b \pm \sqrt {b^2 - 4ac} }}{{2a}}$[^1] | ++| | | ++| | [^1]: If this looks like code, it\'s because MathJax is | ++| | not installed on your system. Contact your administrator | ++| | to request it. | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `A simple footnote.^[Or is it so simple?]` | A simple footnote.^[Or is it so simple?] | +++--------------------------------------------------------+------------------------------------------------------------+ ++| \> an indented paragraph\ \ | > an indented paragraph, usually used for quotations | ++| \> usually used for quotations | | +++--------------------------------------------------------+------------------------------------------------------------+ ++| #!/bin/sh -e | #!/bin/sh -e | ++| # code, indented four spaces | # code, indented four spaces | ++| echo "Hello world" | echo "Hello world" | +++--------------------------------------------------------+------------------------------------------------------------+ ++| * a bulleted list | - a bulleted list | ++| * second item | - second item | ++| - sublist | - sublist | ++| - and more | - and more | ++| * back to main list | - back to main list | ++| 1. this item has an ordered | 1. this item has an ordered | ++| 2. sublist | 2. sublist | ++| a) you can also use letters | a. you can also use letters | ++| b) another item | b. another item | +++--------------------------------------------------------+------------------------------------------------------------+ ++| Fruit Quantity | Fruit Quantity | ++| ------- --------- | ------- ---------- | ++| apples 30,200 | apples 30,200 | ++| oranges 1,998 | oranges 1,998 | ++| pears 42 | pears 42 | ++| | | ++| Table: Our fruit inventory | : Our fruit inventory | +++--------------------------------------------------------+------------------------------------------------------------+ ++ ++## Headings ++ ++For headings, prefix a line with one or more `#` signs: one for a major heading, ++two for a subheading, three for a subsubheading. Be sure to leave space before ++and after the heading. ++ ++ # Markdown ++ ++ Text... ++ ++ ## Some examples... ++ ++ Text... ++ ++## Wiki links ++ ++Links to other wiki pages are formed this way: `[Page Name]()`. ++(Gitit converts markdown links with empty targets into wikilinks.) ++ ++To link to a wiki page using something else as the link text: ++`[something else](Page Name)`. ++ ++Note that page names may contain spaces and some special characters. ++They need not be CamelCase. CamelCase words are *not* automatically ++converted to wiki links. ++ ++Wiki pages may be organized into directories. So, if you have ++several pages on wine, you may wish to organize them like so: ++ ++ Wine/Pinot Noir ++ Wine/Burgundy ++ Wine/Cabernet Sauvignon ++ ++Note that a wiki link `[Burgundy]()` that occurs inside the `Wine` ++directory will link to `Wine/Burgundy`, and not to `Burgundy`. ++To link to a top-level page called `Burgundy`, you'd have to use ++`[Burgundy](/Burgundy)`. ++ ++To link to a directory listing for a subdirectory, use a trailing ++slash: `[Wine/]()` will link to a listing of the `Wine` subdirectory. ++ ++# DocBook ++ ++As DocBook is an XML format, opening and closing tags must match ++(`<tag>...</tag>`). ++ +++--------------------------------------------------------+------------------------------------------------------------+ ++| DocBook code | Result | +++========================================================+============================================================+ ++| `<emphasis>emphasized text</emphasis>` | *emphasized text* | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `<emphasis role="strong">strong emphasis</emphasis>` | **strong emphasis** | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `<literal>literal text</literal>` | `literal text` | +++--------------------------------------------------------+------------------------------------------------------------+ ++| XML character entities: `< > "` | `< > "` | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `<ulink url="https://en.wikipedia.org/wiki/DocBook"> | [external link](https://en.wikipedia.org/wikiDocBook) | ++| external link</ulink>` | | +++--------------------------------------------------------+------------------------------------------------------------+ ++| Inserting an image: |  | ++| | | ++| <inlinemediaobject> | | ++| <alt>folder</alt> | | ++| <imageobject> | | ++| <imagedata fileref="/img/icons/folder.png" /> | | ++| </imageobject> | | ++| </inlinemediaobject> | | +++--------------------------------------------------------+------------------------------------------------------------+ ++| Wikilink: `<ulink url="Front Page">Front Page</ulink>` | Wikilink: [Front Page]() | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `H<subscript>2</subscript>O` | H~2~O | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `10<superscript>100</superscript>` | 10^100^ | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `<emphasis role="strikethrough">strikeout</emphasis>` | ~~strikeout~~ | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `$x = \frac{{ - b \pm \sqrt {b^2 - 4ac} }}{{2a}}$` | $x = \frac{{ - b \pm \sqrt {b^2 - 4ac} }}{{2a}}$[^1] | ++| | | ++| | (Use pandoc's `--mathml` option to convert TeX math code.) | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `A simple footnote.<footnote>Or | A simple footnote.^[Or is it so simple?] | ++| is it so simple?</footnote>` | | +++--------------------------------------------------------+------------------------------------------------------------+ ++| `<blockquote>an indented paragraph, usually used | > an indented paragraph, usually used for quotations | ++| for quotations</blockquote>` | | +++--------------------------------------------------------+------------------------------------------------------------+ ++| <programlisting> | #!/bin/sh -e | ++| #!/bin/sh -e` | echo "Hello world" | ++| echo "Hello world" | | ++| </programlisting> | | +++--------------------------------------------------------+------------------------------------------------------------+ ++| <itemizedlist spacing="compact"> | - a bulleted list | ++| <listitem> | - second item | ++| <simpara>a bulleted list</simpara> | - sublist | ++| </listitem> | - and more | ++| <listitem> | - back to main list | ++| <simpara>second item</simpara> | 1. this item has an ordered | ++| <itemizedlist spacing="compact"> | 2. sublist | ++| <listitem> | a. you can also use letters | ++| <simpara>sublist</simpara> | b. another item | ++| </listitem> | | ++| <listitem> | | ++| <simpara>and more</simpara> | | ++| </listitem> | | ++| </itemizedlist> | | ++| </listitem> | | ++| <listitem> | | ++| <simpara>back to main list</simpara> | | ++| <orderedlist spacing="compact"> | | ++| <listitem> | | ++| <simpara>this item has an ordered</simpara> | | ++| </listitem> | | ++| <listitem> | | ++| <simpara>sublist</simpara> | | ++| <orderedlist spacing="compact" | | ++| numeration="loweralpha"> | | ++| <listitem> | | ++| <simpara>you can also use letters</simpara> | | ++| </listitem> | | ++| <listitem> | | ++| <simpara>another item</simpara> | | ++| </listitem> | | ++| </orderedlist> | | ++| </listitem> | | ++| </orderedlist> | | ++| </listitem> | | ++| </itemizedlist> | | +++--------------------------------------------------------+------------------------------------------------------------+ ++| <table> | Fruit Quantity | ++| <title>Our fruit inventory</title> | ------- ---------- | ++| <tgroup cols="2"> | apples 30,200 | ++| <colspec align="left" /> | oranges 1,998 | ++| <colspec align="right" /> | pears 42 | ++| <thead> | | ++| <row> | : Our fruit inventory | ++| <entry>Fruit</entry> | | ++| <entry>Quantity</entry> | | ++| </row> | | ++| </thead> | | ++| <tbody> | | ++| <row> | | ++| <entry>apples</entry> | | ++| <entry>30,200</entry> | | ++| </row> | | ++| <row> | | ++| <entry>oranges</entry> | | ++| <entry>1,998</entry> | | ++| </row> | | ++| <row> | | ++| <entry>pears</entry> | | ++| <entry>42</entry> | | ++| </row> | | ++| </tbody> | | ++| </tgroup> | | ++| </table> | | +++--------------------------------------------------------+------------------------------------------------------------+ ++ ++## Headings ++ ++A heading is given as the `<title>` element of a `<section>`: ++ ++<pre> ++<section> ++ <title>Heading</title> ++ <simpara>This is a top level section.</simpara> ++ <section> ++ <title>Subheading</title> ++ <simpara>This is a second level section.</simpara> ++ </section> ++</section> ++</pre> ++ ++## Wiki links ++ ++Links to other wiki pages are formed this way: ++`<ulink url="Page Name">Page Name</ulink>` ++ ++To link to a wiki page using something else as the link text: ++`<ulink url="Page Name">something else</ulink>`. ++ ++Note that page names may contain spaces and some special characters. ++They need not be CamelCase. CamelCase words are *not* automatically ++converted to wiki links. ++ ++Wiki pages may be organized into directories. So, if you have ++several pages on wine, you may wish to organize them like so: ++ ++ Wine/Pinot Noir ++ Wine/Burgundy ++ Wine/Cabernet Sauvignon ++ ++Note that a wiki link `<ulink url="Burgundy">Burgundy</ulink>` ++that occurs inside the `Wine` directory will link to `Wine/Burgundy`, ++and not to `Burgundy`. To link to a top-level page called `Burgundy`, ++you'd have to use `<ulink url="/Burgundy">Burgundy</ulink>`. ++ ++To link to a directory listing for a subdirectory, use a trailing ++slash: `<ulink url="Wine/">Wine</ulink>` will link to a listing of ++the `Wine` subdirectory. ++ ++## Reference material ++ ++Further reading: [DocBook 5: The Definitive Guide], which includes the ++[List of DocBook elements]. ++ ++[DocBook 5: The Definitive Guide]: https://tdg.docbook.org/tdg/5.0/docbook.html ++[List of DocBook elements]: https://tdg.docbook.org/tdg/5.0/chunk-part-d64e8789.html ++ ++## A sample document ++ ++You might want to use the following document as a resource of DocBook ++snippets (copy/paste). ++ ++~~~~~~~~ ++ ++<section id="docbook"> ++ <title>Using DocBook</title> ++ <simpara> ++ As DocBook is an XML format, opening and closing tags ++ must match (<tag>...</tag>). ++ </simpara> ++ <section id="inline"> ++ <title>Text Formatting</title> ++ <simpara> ++ A simple paragraph. ++ </simpara> + <para> +- This wiki's pages are written in +- <ulink url="http://pandoc.org">pandoc</ulink>'s +- extended form of +- <ulink url="http://daringfireball.net/projects/markdown">markdown</ulink>. +- If you're not familiar with markdown, you should start by looking at +- the +- <ulink url="http://daringfireball.net/projects/markdown/basics">markdown +- "basics" page</ulink> and the +- <ulink url="http://daringfireball.net/projects/markdown/syntax">markdown +- syntax description</ulink>. Consult the +- <ulink url="http://pandoc.org/README.html">pandoc +- User's Guide</ulink> for information about pandoc's syntax for +- footnotes, tables, description lists, and other elements not present +- in standard markdown. ++ A complex paragraph may contain blocks. + </para> +- <para> +- Markdown is pretty intuitive, since it is based on email +- conventions. Here are some examples to get you started: +- </para> +- <table> +- <tr> +- <td> +- <literal>*emphasized text*</literal> +- </td> +- <td> +- <emphasis>emphasized text</emphasis> +- </td> +- </tr> +- <tr> +- <td> +- <literal>**strong emphasis**</literal> +- </td> +- <td> +- <emphasis role="strong">strong emphasis</emphasis> +- </td> +- </tr> +- <tr> +- <td> +- <literal>`literal text`</literal> +- </td> +- <td> +- <literal>literal text</literal> +- </td> +- </tr> +- <tr> +- <td> +- <literal>\*escaped special characters\*</literal> +- </td> +- <td> +- *escaped special characters* +- </td> +- </tr> +- <tr> +- <td> +- <literal>[external link](http://google.com)</literal> +- </td> +- <td> +- <ulink url="http://google.com">external link</ulink> +- </td> +- </tr> +- <tr> +- <td> +- <literal></literal> +- </td> +- <td> +- <inlinemediaobject> ++ <simpara> ++ italics: <emphasis>italics</emphasis>, ++ bold: <emphasis role="strong">bold</emphasis>, ++ strikeout: <emphasis role="strikethrough">strikeout</emphasis>, ++ inline code snippets: <literal>inline code</literal>. ++ </simpara> ++ <simpara> ++ Links: ++ <ulink url="http://foo.bar/baz">external</ulink>, ++ <ulink url="Pagename">internal Wiki Link</ulink>. ++ </simpara> ++ <simpara> ++ Inserting an image: ++ <inlinemediaobject> + <imageobject> +- <imagedata fileref="/img/icons/folder.png" /> ++ <imagedata fileref="/img/icons/folder.png" /> + </imageobject> +- </inlinemediaobject> +- </td> +- </tr> +- <tr> +- <td> +- Wikilink: <literal>[Front Page]()</literal> +- </td> +- <td> +- Wikilink: <ulink url="">Front Page</ulink> +- </td> +- </tr> +- <tr> +- <td> +- <literal>H~2~O</literal> +- </td> +- <td> +- H<subscript>2</subscript>O +- </td> +- </tr> +- <tr> +- <td> +- <literal>10^100^</literal> +- </td> +- <td> +- 10<superscript>100</superscript> +- </td> +- </tr> +- <tr> +- <td> +- <literal>~~strikeout~~</literal> +- </td> +- <td> +- <emphasis role="strikethrough">strikeout</emphasis> +- </td> +- </tr> +- <tr> +- <td> +- <literal>$x = \frac{{ - b \pm \sqrt {b^2 - 4ac} }}{{2a}}$</literal> +- </td> +- <td> +- $x = \frac{{ - b \pm \sqrt {b^2 - 4ac} }}{{2a}}$<footnote> +- <para> +- If this looks like code, it's because MathJax is not installed on +- your system. Contact your administrator to request it. +- </para> +- </footnote> +- </td> +- </tr> +- <tr> +- <td> +- <literal>A simple footnote.^[Or is it so simple?]</literal> +- </td> +- <td> +- A simple footnote.<footnote> +- <para> +- Or is it so simple? +- </para> +- </footnote> +- </td> +- </tr> +- <tr> +- <td> +- <pre> +- > an indented paragraph, +- > usually used for quotations +- </pre> +- </td> +- <td> +- <blockquote> +- <para> +- an indented paragraph, usually used for quotations +- </para> +- </blockquote> +- </td> +- <tr> +- <td> +- <pre> +- #!/bin/sh -e +- # code, indented four spaces +- echo "Hello world" +- </pre> +- </td> +- <td> +- <programlisting> ++ </inlinemediaobject> ++ </simpara> ++ </section> ++ <section id="blocks"> ++ <title>Text Blocks</title> ++ <para> ++ Quotation: ++ <blockquote> ++ <simpara> ++ A quotation set off from the main text. ++ </simpara> ++ </blockquote> ++ </para> ++ <para> ++ Code listing: ++ <programlisting> + #!/bin/sh -e +-# code, indented four spaces + echo "Hello world" +-</programlisting> +- </td> +- </tr> +- <tr> +- <td> +- <pre> +- * a bulleted list +- * second item +- - sublist +- - and more +- * back to main list +- 1. this item has an ordered +- 2. sublist +- a) you can also use letters +- b) another item +- </pre> +- </td> +- <td> +- <itemizedlist spacing="compact"> ++ </programlisting> ++ </para> ++ </section> ++ <section id="lists"> ++ <title>Lists</title> ++ <para> ++ Simple list: ++ <itemizedlist spacing="compact"> + <listitem> +- <para> +- a bulleted list +- </para> ++ <simpara> ++ first ++ </simpara> + </listitem> + <listitem> +- <para> +- second item +- </para> +- <itemizedlist spacing="compact"> +- <listitem> +- <para> +- sublist +- </para> +- </listitem> +- <listitem> +- <para> +- and more +- </para> +- </listitem> +- </itemizedlist> +- </listitem> ++ <simpara> ++ second ++ </simpara> ++ </listitem> ++ </itemizedlist> ++ Numbered list: ++ <orderedlist spacing="compact"> + <listitem> +- <para> +- back to main list +- </para> +- <orderedlist numeration="arabic" spacing="compact"> +- <listitem> +- <para> +- this item has an ordered +- </para> +- </listitem> +- <listitem> +- <para> +- sublist +- </para> +- <orderedlist numeration="loweralpha" spacing="compact"> +- <listitem> +- <para> +- you can also use letters +- </para> +- </listitem> +- <listitem> +- <para> +- another item +- </para> +- </listitem> +- </orderedlist> +- </listitem> +- </orderedlist> ++ <simpara> ++ first ++ </simpara> + </listitem> +- </itemizedlist> +- </td> +- </tr> +- <tr> +- <td> +- <pre> +- Fruit Quantity +- -------- ----------- +- apples 30,200 +- oranges 1,998 +- pears 42 +- +- Table: Our fruit inventory +- </pre> +- </td> +- <td> +- <table> +- <title> +- Our fruit inventory +- </title> +- <tgroup cols="2"> +- <colspec align="left" /> +- <colspec align="right" /> +- <thead> +- <row> +- <entry> +- Fruit +- </entry> +- <entry> +- Quantity +- </entry> +- </row> +- </thead> +- <tbody> +- <row> +- <entry> +- apples +- </entry> +- <entry> +- 30,200 +- </entry> +- </row> +- <row> +- <entry> +- oranges +- </entry> +- <entry> +- 1,998 +- </entry> +- </row> +- <row> +- <entry> +- pears +- </entry> +- <entry> +- 42 +- </entry> +- </row> +- </tbody> +- </tgroup> +- </table> +- </td> +- </tr> +- </table> +- <para> +- For headings, prefix a line with one or more <literal>#</literal> +- signs: one for a major heading, two for a subheading, three for a +- subsubheading. Be sure to leave space before and after the heading. ++ <listitem> ++ <simpara> ++ second ++ </simpara> ++ </listitem> ++ </orderedlist> ++ Definition list: ++ <variablelist> ++ <varlistentry> ++ <term> ++ DocBook ++ </term> ++ <listitem> ++ <simpara> ++ A sophisticated XML format. ++ </simpara> ++ </listitem> ++ </varlistentry> ++ <varlistentry> ++ <term> ++ orange ++ </term> ++ <listitem> ++ <simpara> ++ A healthy fruit. ++ </simpara> ++ </listitem> ++ <listitem> ++ <simpara> ++ A warm colour. ++ </simpara> ++ </listitem> ++ </varlistentry> ++ </variablelist> + </para> +- <programlisting> +-# Markdown ++ </section> ++</section> + +-Text... +- +-## Some examples... +- +-Text... +-</programlisting> +- <sect2 id="wiki-links"> +- <title>Wiki links</title> +- <para> +- Links to other wiki pages are formed this way: +- <literal>[Page Name]()</literal>. (Gitit converts markdown links +- with empty targets into wikilinks.) +- </para> +- <para> +- To link to a wiki page using something else as the link text: +- <literal>[something else](Page Name)</literal>. +- </para> +- <para> +- Note that page names may contain spaces and some special +- characters. They need not be CamelCase. CamelCase words are +- <emphasis>not</emphasis> automatically converted to wiki links. +- </para> +- <para> +- Wiki pages may be organized into directories. So, if you have +- several pages on wine, you may wish to organize them like so: +- </para> +- <programlisting> +-Wine/Pinot Noir +-Wine/Burgundy +-Wine/Cabernet Sauvignon +-</programlisting> +- <para> +- Note that a wiki link <literal>[Burgundy]()</literal> that occurs +- inside the <literal>Wine</literal> directory will link to +- <literal>Wine/Burgundy</literal>, and not to +- <literal>Burgundy</literal>. To link to a top-level page called +- <literal>Burgundy</literal>, you'd have to use +- <literal>[Burgundy](/Burgundy)</literal>. +- </para> +- <para> +- To link to a directory listing for a subdirectory, use a trailing +- slash: <literal>[Wine/]()</literal> will link to a listing of the +- <literal>Wine</literal> subdirectory. +- </para> +- </sect2> +-</sect1> ++~~~~~~~~ |