wiki_authoring []

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Wiki Authoring ======

Here are instructions on how to create new wiki pages on this wiki:
[[doku>page#wiki_pages|www.dokuwiki.org/page#wiki_pages]]

Here are instructions on how to edit pages:
[[doku>editing|www.dokuwiki.org/editing]]

A page showing syntax for editing wiki pages:
[[wiki:syntax|Formatting Syntax]]

===== Draft versions =====

  * //Saving a draftfile can be forced by **pressing** the preview button//.
    * Recover((After a browser crash)) a retained //draftfile// with //Edit draft// (to the right, above //Old revisions//).

  - Edit draft {{wiki_authoring:edit_draft_e-1.jpg?23|Edit draft [e]}}
  - //Draft file found// (heading)
    - Recover draft {{wiki_authoring:recover_draft-1.jpg?235|Recover draft}}

Draft versions:
[[doku>draft|www.dokuwiki.org/draft]]

===== Show pagesource =====

  * Review the DokuWiki pagesource.
    * ''Log out'' to view the //Show pagesource// option.

  - Show pagesource ((**Ctrl**+**F** the wiki page source after using //Show pagesource//.)) {{wiki_authoring:show_pagesource_v-1.jpg?26|Show pagesource [v]}}
  - //This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.// (heading)
    - Pagesource arrows {{wiki_authoring:pagesource_arrow-1.jpg?67|Pagesource arrows}}

==== for the blind ====

  * [[sdf_for_blind_users#dokuwiki_pagesource_examples|DokuWiki pagesource examples]] from //Libraries for the Blind and Print Disabled//

====== Wiki Authoring Tips ======

===== URL Schemes =====

URL Schemes:
[[doku>urlschemes|www.dokuwiki.org/urlschemes]]

==== Gemini links ====

<del>Un</del>like the usual URL links, such as HTTP, FTP, mailto, etc, Gemini links will now((Membership included //gemini// in the SDF wiki ''[[doku>urlschemes|conf/scheme.local.conf]]'' file.)) <del>don't</del> work in the SDF wiki, because it appears to <del>not</del> understand the protocol (which makes sense, Gemini is now <del>not widely</del> accepted <del>yet</del> at SDF) <del>but if you don't surround a gemini link in the link markup syntax with double brackets, dokuwiki will consider <nowiki>//</nowiki> as "start italics" and mess up your document</del>.

so if you type ''<nowiki>[[gemini://gem.sdf.org]]</nowiki>'' inline in wiki markup, it will render as

[[gemini://gem.sdf.org]]

<del>but</del> if you just type the url straight, as ''<nowiki>gemini://gem.sdf.org</nowiki>'', it will be displayed as:

gemini://gem.sdf.org

===== headline level =====

It is possible to link to a //headline// that is omitted from the //Table of Contents//.

|**1.**|The [[wiki:syntax#sectioning|Sectioning]] and //headline// documentation.|Use //different levels of headlines to structure your content//.|
|//a.//|A [[vps_-_9front#profile_and_rules|Profile and Rules]] //headline// example.|Use the browser //go back// to return to [[wiki_authoring#headline_level|Wiki Authoring]].|
|//b.//|Use the [[wiki_authoring#show_pagesource|Show pagesource]] to view the //Profile and Rules// //headline example//.||

===== playground namespace =====

A pagename that is saved in the wiki playground ns can display nonexistent wiki pagename links, unless a colon is used.

  - Links within the DokuWiki playground namespace.
    - This [[:wiki_authoring|wiki authoring]] link ((With a colon ''%%[[:wiki_authoring|wiki authoring]]%%'')) is green when viewed from the //playground// namespace. <file config A link with `[[:`>

This [[:wiki_authoring|wiki authoring]] link is green when viewed from the playground namespace.
</file>
    - This [[wiki_authoring|wiki authoring]] link ((Without a colon ''%%[[wiki_authoring|wiki authoring]]%%'')) is red when viewed from the //playground// namespace. <file config A link with `[[`>

This [[wiki_authoring|wiki authoring]] link is red when viewed from the playground namespace.
</file>
  - A red [[playground:author:playground|pagename link]] ((A link without a contiguous underline.)) example. <file config nonexistent pagename>

//a topic that doesn't exist yet//\\
https://wiki.sdf.org/doku.php?id=playground:author:playground
</file>

===== Plan 9 pages =====

//===== Plan 9 pages =====//

|x|THIS //[[wiki:syntax#headline_level_3|headline]]// IS A DRAFT|

This section provides links to some SDF Wiki Plan 9 [[plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]], or [[plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]], browser [[wiki_authoring#show_pagesource|pagesource]] examples ((The [%%:!:%%] is  interchangeable with a //[CAUTION]//, for the [[plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]], and [[plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]] browsers. :!:)) (([[wiki:syntax#text_to_image_conversions|graphical equivalents]])).

|x|[[plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]], [[plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]], [[plan9front_-_acme_sam_abaco_mothra_and_man#netsurf|NetSurf]] ((//[[plan9front_-_acme_sam_abaco_mothra_and_man#netsurf|NetSurf]] is a free, open source web browser//.)):|//[[https://plan9.io/wiki/plan9/Web_browsers/index.html|none supports perfectly the most complex(or broken) websites]]// ((Redirect to document page on ''%%plan9.io%%'', view //[[https://plan9.io/wiki/plan9/plan_9_wiki/|wiki]]// for details.)) |

Some of the //[[wiki:syntax#text_to_image_conversions|Text to Image Conversions]]// do not work well with the [[plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]], or [[plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]], browsers.

  - View the [[plan9front_terminal_on_a_raspberry_pi_2_b#caution|CAUTION]] //headline// with the [[plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]] browser to demonstrate the broken //Text to Image Conversions//.
    - Impression: inspiring <file config abaco CAUTION:>

[:!:] CAUTION [:!:] CAUTION [:!:] CAUTION [:!:]
</file>
  - View the [[plan9front_terminal_on_a_raspberry_pi_2_b#caution|CAUTION]] //headline// with the [[plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]] browser to demonstrate the broken //Text to Image Conversions//.
    - Impression: uninspiring <file config mothra CAUTION:>

[img: https://wiki.sdf.org/lib/images/smileys/exclaim.svg: unknown image type]
CAUTION[img: https://wiki.sdf.org/lib/images/smileys/exclaim.svg: unknown image type]
CAUTION[img: https://wiki.sdf.org/lib/images/smileys/exclaim.svg: unknown image type]
CAUTION[img: https://wiki.sdf.org/lib/images/smileys/exclaim.svg: unknown image type]
</file>

The supported [[wiki:syntax#lists|ordered and unordered lists]] will look different when viewed with the [[plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]], or [[plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]], browsers.

^  Headline viewed\\ with [[:plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]] ((The [%%:!:%%] is  interchangeable with a //[CAUTION]//, for the [[plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]], and [[plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]] browsers. :!:)) ((The [%%:FIXME:%%] is  interchangeable with a //[%%FIXME%%]//, for the [[plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]], and [[plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]] browsers. FIXME))  ^  Ordered and unordered lists\\ impression  ^^
^ ^  inspiring  ^  uninspiring  ^
| [[:membership_levels#arpa|ARPA]] | | ✔ |
| [[:basic_file_and_directory_tasks#common_file_commands|Common File Commands]] | | ✔ |
| [[:boot_camp_9p_resource#reference_book|Reference book]] | ✔ | |

^  Headline viewed\\ with [[:plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]] ((The [%%:!:%%] is  interchangeable with a //[CAUTION]//, for the [[plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]], and [[plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]] browsers. :!:)) ((The [%%:FIXME:%%] is  interchangeable with a //[%%FIXME%%]//, for the [[plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]], and [[plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]] browsers. FIXME))  ^  Ordered and unordered lists\\ impression  ^^
^ ^  inspiring  ^  uninspiring  ^
| [[:membership_levels#arpa|ARPA]] | ✔ | |
| [[:basic_file_and_directory_tasks#common_file_commands|Common File Commands]] | ✔ | |
| [[:boot_camp_9p_resource#reference_book|Reference book]] | ✔ | |

The supported [[wiki:syntax#tables|Tables]] can work well while the //headers// may work differently when viewed with the [[plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]], or [[plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]], browsers.

  - View the [[plan_9_9front#plan_9_plan9front_boot_camp|Plan 9, plan9front, Boot Camp]] //headline// with the [[plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]] browser to demonstrate the //tables//, //rows//, and //headers//.
    - Impression: inspiring
  - View the [[plan_9_9front#plan_9_plan9front_boot_camp|Plan 9, plan9front, Boot Camp]] //headline// with the [[plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]] browser to demonstrate the //tables//, //rows//, and //headers//.
    - Impression: uninspiring

  - View the [[plan_9_9front#front_-_plan9front|9front - Plan9front]] //headline// with the [[plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]] browser to demonstrate the //tables//, //rows//, and //headers//.
    - Impression: inspiring
  - View the [[plan_9_9front#front_-_plan9front|9front - Plan9front]] //headline// with the [[plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]] browser to demonstrate the //tables//, //rows//, and //headers//.
    - Impression: uninspiring

|**1.**|One method is to review a playground draft with the [[plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]] browser first, then an [[plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]] browser second, if needed.|
|a.| Use a footnote: [[plan9front_-_acme_sam_abaco_mothra_and_man#mouse_button_3_menu|example]] //[%%:8-O:%%]// (([[wiki:syntax#text_to_image_conversions|graphical equivalents]])). |

==== Plan 9 extension ====

| One might //roll (one's) eyes// when reviewing a //Plan 9 extension// tutorial headline in the distant future.\\ //[[http://sdf.org/?tutorials|Two Tutorial Projects]]// are described in detail.  The [[https://9p.sdf.org/|SDF plan9front server]] can act as a repository\\ for additional educational content.  These content sections, or headlines, may resemble tutorial content. |

|x| [[plan_9_9front#programming|Discoveries in Programming]] |
|x| [[plan_9_9front#hardware|Discoveries in Hardware]] |

=== Authoring Tips ===

  - Discoveries Authoring Tips welcome. <file config sample Discoveries html format>

A sample Discoveries format may apply.
</file>

----

This wiki page was reviewed with the Plan 9 [[plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]], and [[plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]], browsers.