Differences

This shows you the differences between two versions of the page.

--- wiki_authoring [2023/11/26 03:24] – [Plan 9 extension] ext m( hc9
+++ wiki_authoring [2025/03/29 06:49] (current) – [Wiki section extension] alW hc9
@@ Line 1: / Line 1: @@
+====== Wiki Authoring ======
+**If you would like to be able add or edit pages here, email [[membership@sdf.org]] (mailto link).**
+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>
+===== Wiki section extension =====
+| One might //roll (one's) eyes// when reviewing a //Wiki section extension// tutorial headline in the distant\\ future. //[[http://sdf.org/?tutorials|Two Tutorial Projects]]// are described in detail.  Another **SDF** server can act as a repository\\ for additional educational content.  These content section extensions may resemble tutorial content. |
+|**1.**| [[https://wiki.twenex.org/tutorials:interlisp |TWENEX]] Interlisp Tutorial |
+|//a.//| [[https://wiki.twenex.org/tutorials:interlisp#example_session |Example Session]] – //Interlisp Example Session on TWENEX// |
+|//b.//| [[https://wiki.twenex.org/tutorials:interlisp#interlisp_editor |Interlisp Editor]] – //The Interlisp Editor// |
+|**2.**| [[web_content_management#cms_and_wiki_options_that_only_require_arpa_membership |CMS and Wiki Options]] That Only Require ARPA Membership |
+|//a.//| • Wikis |
+| | • BrutalWiki: …//Here's a// [https] //demo running on SDF// |
+=== Authoring Tips ===
+  - Section Extension Authoring Tips welcome. <file config sample Section Extension html format>
+A sample Section Extension 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.