Fossil SCM

Document Markdown tables (never knew this feature existed), and improve consistency of formatting

andygoth 2017-08-06 23:32 trunk
Commit 6f69ccdc698319588bf99f7282ba7cb6a5526075d9e8228fd01e5450dd819182
1 file changed +24 -7
+24 -7
--- src/markdown.md
+++ src/markdown.md
@@ -72,26 +72,43 @@
7272
> > Double-indented paragraph
7373
7474
> Begin each line with at least four spaces or one tab to produce a verbatim
7575
> code block.
7676
77
+## Tables ##
78
+
79
+>
80
+ | Header 1 | Header 2 | Header 3 |
81
+ --------------------------------------------
82
+ |:Left-aligned |:Centered :| Right-aligned:|
83
+ | | ← Blank → | |
84
+
85
+> The first row is a header if followed by a horizontal rule or a blank line.
86
+
87
+> Placing **:** at the left, both, or right sides of a cell gives left-aligned,
88
+> centered, or right-aligned text, respectively. By default, header cells are
89
+> centered, and body cells are left-aligned.
90
+
91
+> The leftmost **\|** is required if the first column contains at least one
92
+> blank cell. The rightmost **\|** is optional.
93
+
7794
## Miscellaneous ##
7895
7996
> * In-line images are made using **\!\[alt-text\]\(image-URL\)**.
80
-> * Use HTML for advanced formatting such as tables and forms.
97
+> * Use HTML for advanced formatting such as forms.
8198
> * **\<!--** HTML-style comments **-->** are supported.
82
-> * Escape special characters (ex: "\[", "\(", "\*")
83
-> using backslash (ex: "\\\[", "\\\(", "\\\*").
99
+> * Escape special characters (ex: **\[** **\(** **\|** **\***)
100
+> using backslash (ex: **\\\[** **\\\(** **\\\|** **\\\***).
84101
> * A line consisting of **---**, **\*\*\***, or **\_\_\_** is a horizontal
85102
> rule. Spaces and extra **-**/**\***/**_** are allowed.
86103
> * See [daringfireball.net][] for additional information.
87104
> * See this page's [Markdown source](/md_rules?txt=1) for complex examples.
88105
89106
## Special Features For Fossil ##
90107
91
-> * In hyperlinks, if the URL begins with "/" then the root of the Fossil
108
+> * In hyperlinks, if the URL begins with **/** then the root of the Fossil
92109
> repository is prepended. This allows for repository-relative hyperlinks.
93
-> * For documents that begin with a top-level heading (ex: "# heading #"), the
94
-> heading is omitted from the body of the document and becomes the document
95
-> title displayed at the top of the Fossil page.
110
+> * For documents that begin with a top-level heading (ex: **# heading #**),
111
+> the heading is omitted from the body of the document and becomes the
112
+> document title displayed at the top of the Fossil page.
96113
97114
[daringfireball.net]: http://daringfireball.net/projects/markdown/syntax
98115
--- src/markdown.md
+++ src/markdown.md
@@ -72,26 +72,43 @@
72 > > Double-indented paragraph
73
74 > Begin each line with at least four spaces or one tab to produce a verbatim
75 > code block.
76
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
77 ## Miscellaneous ##
78
79 > * In-line images are made using **\!\[alt-text\]\(image-URL\)**.
80 > * Use HTML for advanced formatting such as tables and forms.
81 > * **\<!--** HTML-style comments **-->** are supported.
82 > * Escape special characters (ex: "\[", "\(", "\*")
83 > using backslash (ex: "\\\[", "\\\(", "\\\*").
84 > * A line consisting of **---**, **\*\*\***, or **\_\_\_** is a horizontal
85 > rule. Spaces and extra **-**/**\***/**_** are allowed.
86 > * See [daringfireball.net][] for additional information.
87 > * See this page's [Markdown source](/md_rules?txt=1) for complex examples.
88
89 ## Special Features For Fossil ##
90
91 > * In hyperlinks, if the URL begins with "/" then the root of the Fossil
92 > repository is prepended. This allows for repository-relative hyperlinks.
93 > * For documents that begin with a top-level heading (ex: "# heading #"), the
94 > heading is omitted from the body of the document and becomes the document
95 > title displayed at the top of the Fossil page.
96
97 [daringfireball.net]: http://daringfireball.net/projects/markdown/syntax
98
--- src/markdown.md
+++ src/markdown.md
@@ -72,26 +72,43 @@
72 > > Double-indented paragraph
73
74 > Begin each line with at least four spaces or one tab to produce a verbatim
75 > code block.
76
77 ## Tables ##
78
79 >
80 | Header 1 | Header 2 | Header 3 |
81 --------------------------------------------
82 |:Left-aligned |:Centered :| Right-aligned:|
83 | | ← Blank → | |
84
85 > The first row is a header if followed by a horizontal rule or a blank line.
86
87 > Placing **:** at the left, both, or right sides of a cell gives left-aligned,
88 > centered, or right-aligned text, respectively. By default, header cells are
89 > centered, and body cells are left-aligned.
90
91 > The leftmost **\|** is required if the first column contains at least one
92 > blank cell. The rightmost **\|** is optional.
93
94 ## Miscellaneous ##
95
96 > * In-line images are made using **\!\[alt-text\]\(image-URL\)**.
97 > * Use HTML for advanced formatting such as forms.
98 > * **\<!--** HTML-style comments **-->** are supported.
99 > * Escape special characters (ex: **\[** **\(** **\|** **\***)
100 > using backslash (ex: **\\\[** **\\\(** **\\\|** **\\\***).
101 > * A line consisting of **---**, **\*\*\***, or **\_\_\_** is a horizontal
102 > rule. Spaces and extra **-**/**\***/**_** are allowed.
103 > * See [daringfireball.net][] for additional information.
104 > * See this page's [Markdown source](/md_rules?txt=1) for complex examples.
105
106 ## Special Features For Fossil ##
107
108 > * In hyperlinks, if the URL begins with **/** then the root of the Fossil
109 > repository is prepended. This allows for repository-relative hyperlinks.
110 > * For documents that begin with a top-level heading (ex: **# heading #**),
111 > the heading is omitted from the body of the document and becomes the
112 > document title displayed at the top of the Fossil page.
113
114 [daringfireball.net]: http://daringfireball.net/projects/markdown/syntax
115

Keyboard Shortcuts

Open search /
Next entry (timeline) j
Previous entry (timeline) k
Open focused entry Enter
Show this help ?
Toggle theme Top nav button