Differences

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

--- porting_existing_tutorials_to_the_wiki [2021/03/12 22:18] – [Translated HTML files] hc9
+++ porting_existing_tutorials_to_the_wiki [2021/03/15 19:39] – [Here are some tips:] hc9
@@ Line 6: / Line 6: @@
 ===== Translated HTML files =====
-  - User pifty has run a converter on all the existing ([[wp>Revision_Control_System|RCS]]) HTML tutorials, and dumped them into the SDF wiki [[https://git.sdf.org/pifty/tutes-dump/src/branch/master/dump|here at git.sdf.org]]
+  - User pifty has run a converter on all the existing ([[wp>Revision_Control_System|RCS]]) HTML tutorials, and dumped them into the SDF wiki [[https://git.sdf.org/pifty/tutes-dump/src/branch/master/dump|here, at git.sdf.org]]
-  - User peteyboy has run a converter on all the existing ([[wp>Revision_Control_System|RCS]]) HTML tutorials, //cleaned-up(([[https://wiki.sdf.org/doku.php?id=start&do=revisions|Old Revisions]] 2021/03/11 23:56 start -- pointed to forked tutes-dump with more 'cleaned up' html2docuwiki dumps peteyboy...))// files, and dumped them into the SDF wiki [[https://git.sdf.org/peteyboy/tutes-dump/src/branch/master/dump|here at git.sdf.org]]
+  - User peteyboy has run a converter on the existing ([[wp>Revision_Control_System|RCS]]) HTML tutorials, //cleaned-up((2021/03/11 23:56 start -- pointed to forked tutes-dump with more 'cleaned up' html2docuwiki dumps peteyboy...[[https://wiki.sdf.org/doku.php?id=start&do=revisions|Old Revisions]]))// files, and dumped them into the SDF wiki [[https://git.sdf.org/peteyboy/tutes-dump/src/branch/master/dump|here, at git.sdf.org]]
   * You can look on the [[start]] or [[SDF basics]] page to find a file to convert (see that it is an external link in the wiki to http://sdf.org/?tutorials/)
@@ Line 19: / Line 19: @@
-It's better if you do some cleanup:
+==== It's better if you do some cleanup: ====
   * in another new tab, open this link for the dokuwiki [[wiki:syntax]]
   * make changes, using the preview to make sure the page looks good before saving
-Here are some tips:
+====  Here are some tips: ====
   * Many of the paragraphs have leading spaces in the converted text,  remove them because in wiki that's a code block
   * Remove anchor markup in headings, they are probably all messed up. The wiki automatically makes TOCs, so the manual ones can **go**
   * Remove any manually generated TOCs, because **above**
+  * Remove any HTML escape codes, like //&gt; &lt; &amp;// dokuwiki markup doesn't need these escaped, and doesn't render them as expected by HTML.
+  * leading a line by two spaces renders the line as //"code"((Additional [[doku>syntax#code_blocks|Code Blocks]] are mentioned in the DokuWiki [[doku>syntax#formatting_syntax|Formatting Syntax]] section.))//, so you can replace delineation around code that is meant for user to type, such as quotes or some other markup, with two spaces, like so:
+  this is code
-=== Notes ===
+**Notes**