Difference between revisions of "Wikitext"
(Imported from Wikispaces) |
(Imported from Wikispaces) |
||
Line 1: | Line 1: | ||
− | [[ | + | <div id="content_view" class="wiki" style="display: block"> |
− | + | ||
− | Wikispaces uses the following text markup rules. Remember that you can skip wikitext entirely by using the visual editor. | + | =wikitext= |
− | + | <br /> <div id="toc"> | |
− | =Text Formatting= | + | =Table of Contents= |
− | + | <div style="margin-left: 1em">[[#Text Formatting| Text Formatting]]</div><div style="margin-left: 1em">[[#Links and Images and Files| Links and Images and Files]]</div><div style="margin-left: 2em">[[#Links and Images and Files-Link examples| Link examples]]</div><div style="margin-left: 1em">[[#Other Layout| Other Layout]]</div><div style="margin-left: 1em">[[#Page Includes| Page Includes]]</div><div style="margin-left: 1em">[[#Special Tags| Special Tags]]</div><div style="margin-left: 1em">[[#Preventing Wikitext| Preventing Wikitext]]</div></div>Wikispaces uses the following text markup rules. Remember that you can skip wikitext entirely by using the visual editor.<br /> <br /> | |
− | {| | + | =Text Formatting= |
− | | Heading 1 | + | <br /> |
+ | {| class="wiki_table" | ||
+ | | Heading 1<br /> | ||
+ | | = heading 1 =<br /> | ||
|- | |- | ||
− | | Heading 2 | + | | Heading 2<br /> |
+ | | == heading 2 ==<br /> | ||
|- | |- | ||
− | | Heading 3 | + | | Heading 3<br /> |
+ | | === heading 3 ===<br /> | ||
|- | |- | ||
− | | Bulleted List | + | | Bulleted List<br /> |
+ | | * list<br /> | ||
|- | |- | ||
− | | Numbered List | + | | Numbered List<br /> |
+ | | # numbered<br /> | ||
|- | |- | ||
− | | Bold | + | | Bold<br /> |
+ | | **bold**<br /> | ||
|- | |- | ||
− | | Italics | + | | Italics<br /> |
+ | | ''italics''<br /> | ||
|- | |- | ||
− | | Underline | + | | Underline<br /> |
+ | | <u>underline</u><br /> | ||
|- | |- | ||
− | | Monospaced Font | + | | Monospaced Font<br /> |
+ | | <nowiki><span style="font-family:monospace">curly braces</span></nowiki><br /> | ||
|- | |- | ||
− | | Escaping | + | | Escaping<br /> |
− | + | | ` `escaping` ` (surround in double backtick characters).<br /> | |
− | |||
|- | |- | ||
+ | | Indenting<br /> | ||
+ | | > indent<br /> | ||
|} | |} | ||
− | + | <br /> | |
− | =Links and Images and Files= | + | =Links and Images and Files= |
− | + | <br /> | |
− | {| | + | {| class="wiki_table" |
− | | Page Link | + | | Page Link<br /> |
+ | | <nowiki>[[pagename| label]]</nowiki> or just <nowiki>[[pagename]]</nowiki><br /> | ||
|- | |- | ||
− | | Page Link in Another Space | + | | Page Link in Another Space<br /> |
+ | | <nowiki>[[space:pagename| label]]</nowiki> or just <nowiki>[[space:pagename]]</nowiki><br /> | ||
|- | |- | ||
− | | URL | + | | URL<br /> |
+ | | http://some.url<br /> | ||
|- | |- | ||
− | | Email | + | | Email<br /> |
+ | | help@wikispaces.org<br /> | ||
|- | |- | ||
− | | Labeled URL | + | | Labeled URL<br /> |
+ | | <nowiki>[[http://some.url| label]</nowiki><br /> | ||
|- | |- | ||
− | | Image | | + | | Image<br /> |
+ | | | ||
+ | <nowiki>[[File:name.jpg]]</nowiki> (png, jpeg, and gif - learn more about [[image tags]])<br /> | ||
|- | |- | ||
− | | File | + | | File<br /> |
− | + | | <nowiki>[[:File:name.txt]]</nowiki> (any file type supported)<br /> | |
− | |||
|- | |- | ||
+ | | Anchor<br /> | ||
+ | | | ||
+ | <nowiki>[[#anchor]]</nowiki> see [[wikitext anchor]] for more details<br /> | ||
|} | |} | ||
− | + | <br /> | |
− | ==Link examples== | + | ==Link examples== |
− | <nowiki>[[foo]]</nowiki> | + | <nowiki>[[foo]]</nowiki><br /> This will display the text "foo" on the page which will be a link to the page in this space also called "foo".<br /> <br /> <nowiki>[[foo| bar]]</nowiki><br /> This will display the text "bar" on the page which will be a link to the page in this space called "foo".<br /> <br /> <nowiki>[[hep:the]]</nowiki><br /> This will display the text "hep:the" on the page which will be a link to the page in the "hep" space called "the".<br /> <br /> <nowiki>[[hep:the| bar]]</nowiki><br /> This will display the text "bar" on the page which will be a link to the page in the "hep" space called "the".<br /> <br /> |
− | This will display the text "foo" on the page which will be a link to the page in this space also called "foo". | + | =Other Layout= |
− | + | <br /> | |
− | <nowiki>[[foo | bar]]</nowiki> | + | {| class="wiki_table" |
− | This will display the text "bar" on the page which will be a link to the page in this space called "foo". | + | | Horizontal Line<br /> |
− | + | | ----<br /> | |
− | <nowiki>[[hep:the]]</nowiki> | ||
− | This will display the text "hep:the" on the page which will be a link to the page in the "hep" space called "the". | ||
− | |||
− | <nowiki>[[hep:the | bar]]</nowiki> | ||
− | This will display the text "bar" on the page which will be a link to the page in the "hep" space called "the". | ||
− | |||
− | =Other Layout= | ||
− | |||
− | {| | ||
− | | Horizontal Line | ||
|- | |- | ||
− | | Table | + | | Table<br /> |
+ | | || table cell || table cell || table cell ||<br /> | ||
|- | |- | ||
− | | Table Heading Cell | + | | Table Heading Cell<br /> |
+ | | !! heading1 !! heading2 ||<br /> | ||
+ | | <br /> | ||
|- | |- | ||
− | | Table Cell Alignment | + | | Table Cell Alignment<br /> |
+ | | ||= centered ||> right ||<br /> | ||
+ | | <br /> | ||
|- | |- | ||
− | | Table Column Spans (merging columns together) | + | | Table Column Spans (merging columns together)<br /> |
+ | | |||| spans 2 columns ||<br /> || col1 || col2 ||<br /> | ||
+ | | <br /> | ||
|- | |- | ||
− | | Table of Contents | | + | | Table of Contents<br /> |
− | + | | <nowiki></nowiki> or <nowiki>[[toc| flat]]</nowiki><br /> | |
− | + | | note that <nowiki>[[toc| flat]]</nowiki> only displays first level headings using the = heading = syntax<br /> | |
|- | |- | ||
+ | | Right-to-Left text<br /> | ||
+ | | <nowiki>[[rtl]]</nowiki> ... <nowiki>[[rtl]]</nowiki><br /> | ||
+ | | note that the rtl tags must be on their own lines<br /> | ||
|} | |} | ||
− | + | <br /> | |
− | =Page Includes= | + | =Page Includes= |
− | Pages can be included inside other pages to make larger pages by using the <nowiki>[[include]]</nowiki> tag. This can be useful in breaking a large page up into smaller, more manageable pieces, or to create reusable components, like headers and footers, that can be included on multiple pages. The only required attribute of the include tag is the '''page''' attribute. Includes can optionally include a section title using the '''title''' attribute or can include an edit button, allowing users to edit the included page directly, using the '''editable''' attribute. | + | Pages can be included inside other pages to make larger pages by using the <nowiki>[[include]]</nowiki> tag. This can be useful in breaking a large page up into smaller, more manageable pieces, or to create reusable components, like headers and footers, that can be included on multiple pages. The only required attribute of the include tag is the '''page''' attribute. Includes can optionally include a section title using the '''title''' attribute or can include an edit button, allowing users to edit the included page directly, using the '''editable''' attribute.<br /> |
− | {| | + | {| class="wiki_table" |
− | | Basic Include | + | | Basic Include<br /> |
+ | | <nowiki>[[include page="PAGENAME"]]</nowiki><br /> | ||
|- | |- | ||
− | | Include With Section Title | + | | Include With Section Title<br /> |
− | + | | <nowiki>[[include page="PAGENAME" title="Section Title"]]</nowiki><br /> | |
− | |||
|- | |- | ||
+ | | Include With Direct Edit Button<br /> | ||
+ | | <nowiki>[[include page="PAGENAME" editable="true"]]</nowiki><br /> | ||
|} | |} | ||
− | + | <br /> | |
− | =Special Tags= | + | =Special Tags= |
− | + | <br /> | |
− | {| | + | {| class="wiki_table" |
− | | Signature | | + | | Signature<br /> |
− | + | | <span class="membersnap">- [https://www.wmwikis.net/user/view/jbyers [[File:https:''www.wmwikis.net/user/pic/jbyers-lg.jpg jbyers] [https://www.wmwikis.net/user/view/jbyers jbyers]</span><br /> | |
− | + | | (three tildes)(i.e. ~)<br /> | |
|- | |- | ||
− | | | + | | Signature with Date<br /> |
+ | | <span class="membersnap">- [https://www.wmwikis.net/user/view/jbyers [[File:https:''www.wmwikis.net/user/pic/jbyers-lg.jpg jbyers] [https://www.wmwikis.net/user/view/jbyers jbyers] <small>Mar 10, 2005</small></span><br /> | ||
+ | | (four tildes) (i.e.~)<br /> | ||
|- | |- | ||
− | | | + | | Source Code<br /> |
+ | | <nowiki><syntaxhighlight></nowiki> ... <nowiki></syntaxhighlight></nowiki><br /> | ||
+ | | | ||
+ | see the [[wikitext code| code page]] for details on color highlighting<br /> | ||
|- | |- | ||
− | | | + | | Mathematics<br /> |
+ | | <nowiki>[[math]]</nowiki> ... <nowiki>[[math]]</nowiki><br /> | ||
+ | | supporting LaTeX math markup<br /> | ||
|- | |- | ||
− | | | + | | RSS Feeds<br /> |
+ | | <nowiki>[[rss ... ]]</nowiki><br /> | ||
+ | | | ||
+ | see [[wikitext rss]] for more details<br /> | ||
|- | |- | ||
+ | | Embedded Media<br /> | ||
+ | | <nowiki>[[media ...]]</nowiki><br /> | ||
+ | | | ||
+ | see [[wikitext media]] for more details<br /> | ||
|} | |} | ||
− | =Preventing Wikitext= | + | =Preventing Wikitext= |
− | Sometimes the content of your page will include some of the above wikitext, and Wikispaces will mark up that text. For example, an equation that contains 2 equals signs ( | + | Sometimes the content of your page will include some of the above wikitext, and Wikispaces will mark up that text. For example, an equation that contains 2 equals signs (a = b = c) will look like a heading, or a footnote (* see details) will be interpreted as an unordered list. To prevent this markup, wikitext can be '''escaped''' by surrounding the ambiguous area with double back ticks. The back tick character is on the same key as the ~ tilde character on the keyboard. For example, to prevent a list from being displayed, use:<br /> ` ` * this is a footnote, not a list item` ` </div> |
− | ` ` * this is a footnote, not a list item` ` |
Revision as of 14:29, 14 February 2019
wikitext
Table of Contents
Text Formatting
Heading 1 |
= heading 1 = |
Heading 2 |
== heading 2 == |
Heading 3 |
=== heading 3 === |
Bulleted List |
* list |
Numbered List |
# numbered |
Bold |
**bold** |
Italics |
italics |
Underline |
underline |
Monospaced Font |
<span style="font-family:monospace">curly braces</span> |
Escaping |
` `escaping` ` (surround in double backtick characters). |
Indenting |
> indent |
Links and Images and Files
Page Link |
[[pagename| label]] or just [[pagename]] |
Page Link in Another Space |
[[space:pagename| label]] or just [[space:pagename]] |
URL |
http://some.url |
Email |
help@wikispaces.org |
Labeled URL |
[[http://some.url| label] |
Image |
[[File:name.jpg]] (png, jpeg, and gif - learn more about image tags) |
File |
[[:File:name.txt]] (any file type supported) |
Anchor |
[[#anchor]] see wikitext anchor for more details |
Link examples
[[foo]]
This will display the text "foo" on the page which will be a link to the page in this space also called "foo".
[[foo| bar]]
This will display the text "bar" on the page which will be a link to the page in this space called "foo".
[[hep:the]]
This will display the text "hep:the" on the page which will be a link to the page in the "hep" space called "the".
[[hep:the| bar]]
This will display the text "bar" on the page which will be a link to the page in the "hep" space called "the".
Other Layout
Horizontal Line |
---- | |||||||
Table |
table cell | table cell | table cell | |||||
Table Heading Cell |
!! heading1 !! heading2 | |||||||
Table Cell Alignment |
= centered | > right | ||||||
Table Column Spans (merging columns together) |
spans 2 columns | col1 | col2 | |||||
Table of Contents |
or [[toc| flat]] |
note that [[toc| flat]] only displays first level headings using the = heading = syntax | ||||||
Right-to-Left text |
[[rtl]] ... [[rtl]] |
note that the rtl tags must be on their own lines |
Page Includes
Pages can be included inside other pages to make larger pages by using the [[include]] tag. This can be useful in breaking a large page up into smaller, more manageable pieces, or to create reusable components, like headers and footers, that can be included on multiple pages. The only required attribute of the include tag is the page attribute. Includes can optionally include a section title using the title attribute or can include an edit button, allowing users to edit the included page directly, using the editable attribute.
Basic Include |
[[include page="PAGENAME"]] |
Include With Section Title |
[[include page="PAGENAME" title="Section Title"]] |
Include With Direct Edit Button |
[[include page="PAGENAME" editable="true"]] |
Special Tags
Signature |
- [[File:https:www.wmwikis.net/user/pic/jbyers-lg.jpg jbyers jbyers |
(three tildes)(i.e. ~) |
Signature with Date |
- [[File:https:www.wmwikis.net/user/pic/jbyers-lg.jpg jbyers jbyers Mar 10, 2005 |
(four tildes) (i.e.~) |
Source Code |
<syntaxhighlight> ... </syntaxhighlight> |
see the code page for details on color highlighting |
Mathematics |
[[math]] ... [[math]] |
supporting LaTeX math markup |
RSS Feeds |
[[rss ... ]] |
see wikitext rss for more details |
Embedded Media |
[[media ...]] |
see wikitext media for more details |
Preventing Wikitext
Sometimes the content of your page will include some of the above wikitext, and Wikispaces will mark up that text. For example, an equation that contains 2 equals signs (a = b = c) will look like a heading, or a footnote (* see details) will be interpreted as an unordered list. To prevent this markup, wikitext can be escaped by surrounding the ambiguous area with double back ticks. The back tick character is on the same key as the ~ tilde character on the keyboard. For example, to prevent a list from being displayed, use:` ` * this is a footnote, not a list item` `