Skip to content
This repository
Browse code

Revert "Removed markup.* files, no longer used."

This reverts commit 0942759.
These files ARE used, at the end of the Help page.
  • Loading branch information...
commit fb13ed500685ccbdefc65f0081a39eb03ded9759 1 parent 5318dc4
John MacFarlane authored July 31, 2009
32  data/markup.HTML
... ...
@@ -0,0 +1,32 @@
  1
+# Markup
  2
+
  3
+The syntax for wiki pages is standard XHTML. All tags must be
  4
+properly closed.
  5
+
  6
+## Wiki links
  7
+
  8
+Links to other wiki pages are formed this way:
  9
+`<a href="">Page Name</a>`. (Gitit converts links with empty
  10
+targets into wikilinks.)
  11
+
  12
+To link to a wiki page using something else as the link text:
  13
+`<a href="Page+Name">something else</a>`.
  14
+
  15
+Note that page names may contain spaces and some special
  16
+characters. They need not be CamelCase. CamelCase words are *not*
  17
+automatically converted to wiki links.
  18
+
  19
+Wiki pages may be organized into directories. So, if you have
  20
+several pages on wine, you may wish to organize them like so:
  21
+
  22
+    Wine/Pinot Noir
  23
+    Wine/Burgundy
  24
+    Wine/Cabernet Sauvignon
  25
+
  26
+Note that a wiki link `<a href="">Burgundy</a>` that occurs inside
  27
+the `Wine` directory will link to `Wine/Burgundy`, and not to
  28
+`Burgundy`. To link to a top-level page called `Burgundy`, you'd
  29
+have to use `<a href="/Burgundy">Burgundy</a>`.
  30
+
  31
+To link to a directory listing for a subdirectory, use a trailing
  32
+slash:  `<a href="">Wine/</a>` will link to a listing of the `Wine` subdirectory.
63  data/markup.LaTeX
... ...
@@ -0,0 +1,63 @@
  1
+# Markup
  2
+
  3
+This wiki's pages are written in (a subset of) [LaTeX].
  4
+
  5
+  [LaTeX]: http://www.latex-project.org/
  6
+
  7
+The following commands and environments are recognized:
  8
+
  9
+-   `\emph{emphasis}`
  10
+
  11
+-   `\textbf{bold}`
  12
+
  13
+-   `verb!verbatim@@\#!`
  14
+
  15
+-   `\textsubscr{2}`
  16
+
  17
+-   `\sout{strikeout}`
  18
+
  19
+-   `\textsuperscript{2}`
  20
+
  21
+-   `$e = mc^2$`
  22
+
  23
+-   `$$e = mc^2$$`
  24
+
  25
+-   `\footnote{a footnote}`
  26
+
  27
+-   `\section{section}`, `\subsection{subsection}`, etc.
  28
+
  29
+-   `\begin{quote} . . . \end{quote}`
  30
+
  31
+-   `\begin{verbatim} . . . \end{verbatim}`
  32
+
  33
+-   `\begin{itemize} . . . \end{itemize}`
  34
+
  35
+-   `\begin{enumerate} . . . \end{enumerate}`
  36
+
  37
+## Wiki links
  38
+
  39
+Links to other wiki pages are formed this way: `\href{}{Page Name}`.
  40
+(Gitit converts markdown links with empty targets into wikilinks.)
  41
+
  42
+To link to a wiki page using something else as the link text:
  43
+`\href{Page Name}{Something else}`.
  44
+
  45
+Note that page names may contain spaces and some special
  46
+characters. They need not be CamelCase. CamelCase words are *not*
  47
+automatically converted to wiki links.
  48
+
  49
+Wiki pages may be organized into directories. So, if you have
  50
+several pages on wine, you may wish to organize them like so:
  51
+
  52
+    Wine/Pinot Noir
  53
+    Wine/Burgundy
  54
+    Wine/Cabernet Sauvignon
  55
+
  56
+Note that a wiki link `\href{}{Burgundy}` that occurs inside the `Wine`
  57
+directory will link to `Wine/Burgundy`, and not to `Burgundy`. To
  58
+link to a top-level page called `Burgundy`, you'd have to use
  59
+`\href{/Burgundy}{Burgundy}`.
  60
+
  61
+To link to a directory listing for a subdirectory, use a trailing
  62
+slash:  `\href{}{Wine/}` will link to a listing of the `Wine` subdirectory.
  63
+
198  data/markup.Markdown
... ...
@@ -0,0 +1,198 @@
  1
+# Markdown
  2
+
  3
+This wiki's pages are written in [pandoc]'s extended form of [markdown].
  4
+If you're not familiar with markdown, you should start by looking
  5
+at the [markdown "basics" page] and the [markdown syntax description].
  6
+Consult the [pandoc User's Guide] for information about pandoc's syntax
  7
+for footnotes, tables, description lists, and other elements not present
  8
+in standard markdown.
  9
+
  10
+[pandoc]: http://johnmacfarlane.net/pandoc
  11
+[pandoc User's Guide]: http://johnmacfarlane.net/pandoc/README.html
  12
+[markdown]: http://daringfireball.net/projects/markdown
  13
+[markdown "basics" page]: http://daringfireball.net/projects/markdown/basics
  14
+[markdown syntax description]: http://daringfireball.net/projects/markdown/syntax 
  15
+
  16
+Markdown is pretty intuitive, since it is based on email conventions.
  17
+Here are some examples to get you started:
  18
+
  19
+<table>
  20
+<tr>
  21
+<td>`*emphasized text*`</td>
  22
+<td>*emphasized text*</td>
  23
+</tr>
  24
+<tr>
  25
+<td>`**strong emphasis**`</td>
  26
+<td>**strong emphasis**</td>
  27
+</tr>
  28
+<tr>
  29
+<td>`` `literal text` ``</td>
  30
+<td>`literal text`</td>
  31
+</tr>
  32
+<tr>
  33
+<td>`\*escaped special characters\*`</td>
  34
+<td>\*escaped special characters\*</td>
  35
+</tr>
  36
+<tr>
  37
+<td>`[external link](http://google.com)`</td>
  38
+<td>[external link](http://google.com)</td>
  39
+</tr>
  40
+<tr>
  41
+<td>`![folder](/img/icons/folder.png)`</td>
  42
+<td>![folder](/img/icons/folder.png)</td>
  43
+</tr>
  44
+<tr>
  45
+<td>Wikilink: `[Front Page]()`</td>
  46
+<td>Wikilink: [Front Page]()</td>
  47
+</tr>
  48
+<tr>
  49
+<td>`H~2~O`</td>
  50
+<td>H~2~O</td>
  51
+</tr>
  52
+<tr>
  53
+<td>`10^100^`</td>
  54
+<td>10^100^</td>
  55
+</tr>
  56
+<tr>
  57
+<td>`~~strikeout~~`</td>
  58
+<td>~~strikeout~~</td>
  59
+</tr>
  60
+<tr>
  61
+<td>
  62
+`$x = \frac{{ - b \pm \sqrt {b^2 - 4ac} }}{{2a}}$`
  63
+</td>
  64
+<td>
  65
+$x = \frac{{ - b \pm \sqrt {b^2 - 4ac} }}{{2a}}$^[If this looks like
  66
+code, it's because jsMath is
  67
+not installed on your system.  Contact your administrator to request it.]
  68
+</td>
  69
+</tr>
  70
+<tr>
  71
+<td>
  72
+`A simple footnote.^[Or is it so simple?]`
  73
+</td>
  74
+<td>
  75
+A simple footnote.^[Or is it so simple?]
  76
+</td>
  77
+</tr>
  78
+<tr>
  79
+<td>
  80
+<pre>
  81
+> an indented paragraph,
  82
+> usually used for quotations
  83
+</pre>
  84
+</td>
  85
+<td>
  86
+
  87
+> an indented paragraph,
  88
+> usually used for quotations
  89
+
  90
+</td>
  91
+<tr>
  92
+<td>
  93
+<pre>
  94
+    #!/bin/sh -e
  95
+    # code, indented four spaces
  96
+    echo "Hello world"
  97
+</pre>
  98
+</td>
  99
+<td>
  100
+
  101
+    #!/bin/sh -e
  102
+    # code, indented four spaces
  103
+    echo "Hello world"
  104
+
  105
+</td>
  106
+</tr>
  107
+<tr>
  108
+<td>
  109
+<pre>
  110
+* a bulleted list
  111
+* second item
  112
+    - sublist
  113
+    - and more
  114
+* back to main list
  115
+    1. this item has an ordered
  116
+    2. sublist
  117
+        a) you can also use letters
  118
+        b) another item
  119
+</pre>
  120
+</td>
  121
+<td>
  122
+
  123
+* a bulleted list
  124
+* second item
  125
+    - sublist
  126
+    - and more
  127
+* back to main list
  128
+    1. this item has an ordered
  129
+    2. sublist
  130
+        a) you can also use letters
  131
+        b) another item
  132
+
  133
+</td>
  134
+</tr>
  135
+<tr>
  136
+<td>
  137
+<pre>
  138
+Fruit        Quantity
  139
+--------  -----------
  140
+apples         30,200
  141
+oranges         1,998
  142
+pears              42
  143
+
  144
+Table:  Our fruit inventory
  145
+</pre>
  146
+</td>
  147
+<td>
  148
+
  149
+Fruit        Quantity
  150
+--------  -----------
  151
+apples         30,200
  152
+oranges         1,998
  153
+pears              42
  154
+
  155
+Table:  Our fruit inventory
  156
+
  157
+</td>
  158
+</tr>
  159
+</table>
  160
+
  161
+For headings, prefix a line with one or more `#` signs:  one for a major heading,
  162
+two for a subheading, three for a subsubheading.  Be sure to leave space before
  163
+and after the heading.
  164
+
  165
+    # Markdown
  166
+
  167
+    Text...
  168
+ 
  169
+    ## Some examples...
  170
+   
  171
+    Text...
  172
+
  173
+## Wiki links
  174
+
  175
+Links to other wiki pages are formed this way:  `[Page Name]()`.
  176
+(Gitit converts markdown links with empty targets into wikilinks.)
  177
+
  178
+To link to a wiki page using something else as the link text:
  179
+`[something else](Page Name)`.
  180
+
  181
+Note that page names may contain spaces and some special characters.
  182
+They need not be CamelCase.  CamelCase words are *not* automatically
  183
+converted to wiki links.
  184
+
  185
+Wiki pages may be organized into directories.  So, if you have
  186
+several pages on wine, you may wish to organize them like so:
  187
+
  188
+    Wine/Pinot Noir
  189
+    Wine/Burgundy
  190
+    Wine/Cabernet Sauvignon
  191
+
  192
+Note that a wiki link `[Burgundy]()` that occurs inside the `Wine`
  193
+directory will link to `Wine/Burgundy`, and not to `Burgundy`.
  194
+To link to a top-level page called `Burgundy`, you'd have to use
  195
+`[Burgundy](/Burgundy)`.
  196
+
  197
+To link to a directory listing for a subdirectory, use a trailing
  198
+slash: `[Wine/]()` will link to a listing of the `Wine` subdirectory.
42  data/markup.RST
... ...
@@ -0,0 +1,42 @@
  1
+# Markup
  2
+
  3
+This wiki's pages are written in [reStructuredText]. If you're
  4
+not familiar with reStructuredText, you should start by looking at
  5
+the [primer] and the [quick reference guide]. Note that not all
  6
+reStructuredText constructs are currently supported.  Use the
  7
+preview button if you're in doubt.
  8
+
  9
+  [reStructuredText]: http://docutils.sourceforge.net/rst.html
  10
+  [primer]: http://docutils.sourceforge.net/docs/user/rst/quickstart.html
  11
+  [quick reference guide]: http://docutils.sourceforge.net/docs/user/rst/quickref.html
  12
+
  13
+## Wiki links
  14
+
  15
+Links to other wiki pages are formed this way: `` `Page Name <>`_ ``.
  16
+(Gitit converts markdown links with empty targets into wikilinks.)
  17
+
  18
+To link to a wiki page using something else as the link text:
  19
+either `` `something else <Page+Name>`_ `` or
  20
+
  21
+    `something else`_
  22
+
  23
+    .. _`something else`: Page Name
  24
+
  25
+Note that page names may contain spaces and some special
  26
+characters. They need not be CamelCase. CamelCase words are *not*
  27
+automatically converted to wiki links.
  28
+
  29
+Wiki pages may be organized into directories. So, if you have
  30
+several pages on wine, you may wish to organize them like so:
  31
+
  32
+    Wine/Pinot Noir
  33
+    Wine/Burgundy
  34
+    Wine/Cabernet Sauvignon
  35
+
  36
+Note that a wiki link `` `Burgundy <>`_ `` that occurs inside the `Wine`
  37
+directory will link to `Wine/Burgundy`, and not to `Burgundy`. To
  38
+link to a top-level page called `Burgundy`, you'd have to use
  39
+`` `Burgundy </Burgundy>`_ ``.
  40
+
  41
+To link to a directory listing for a subdirectory, use a trailing
  42
+slash:  `` `Wine/ <>`_ `` will link to a listing of the `Wine` subdirectory.

0 notes on commit fb13ed5

Please sign in to comment.
Something went wrong with that request. Please try again.