====== 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 ==== Unlike 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.)) don't work in the SDF wiki, because it appears to not understand the protocol (which makes sense, Gemini is now not widely accepted yet at SDF) but if you don't surround a gemini link in the link markup syntax with double brackets, dokuwiki will consider // as "start italics" and mess up your document. so if you type ''[[gemini://gem.sdf.org]]'' inline in wiki markup, it will render as [[gemini://gem.sdf.org]] but if you just type the url straight, as ''gemini://gem.sdf.org'', 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. This [[:wiki_authoring|wiki authoring]] link is green when viewed from the playground namespace. - This [[wiki_authoring|wiki authoring]] link ((Without a colon ''%%[[wiki_authoring|wiki authoring]]%%'')) is red when viewed from the //playground// namespace. This [[wiki_authoring|wiki authoring]] link is red when viewed from the playground namespace. - A red [[playground:author:playground|pagename link]] ((A link without a contiguous underline.)) example. //a topic that doesn't exist yet//\\ https://wiki.sdf.org/doku.php?id=playground:author:playground ===== 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 [:!:] CAUTION [:!:] CAUTION [:!:] CAUTION [:!:] - 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 [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] 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. A sample Discoveries format may apply. ---- 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.