porting_existing_tutorials_to_the_wiki
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
porting_existing_tutorials_to_the_wiki [2021/03/13 02:18] – [Translated HTML files] added line about HTML escape codes peteyboy | porting_existing_tutorials_to_the_wiki [2021/03/23 04:58] – [Here are some tips:] added nowiki example peteyboy | ||
---|---|---|---|
Line 6: | Line 6: | ||
===== Translated HTML files ===== | ===== Translated HTML files ===== | ||
- | - User pifty has run a converter on all the existing ([[wp> | + | - User pifty has run a converter on all the existing ([[wp> |
- | - User peteyboy has run a converter on the existing ([[wp> | + | - User peteyboy has run a converter on the existing ([[wp> |
* 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:// | * 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:// | ||
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: | * in another new tab, open this link for the dokuwiki [[wiki: | ||
* make changes, using the preview to make sure the page looks good before saving | * make changes, using the preview to make sure the page looks good before saving | ||
- | 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 | * 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 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 manually generated TOCs, because **above** | ||
* Remove any HTML escape codes, like //> < &// dokuwiki markup doesn' | * Remove any HTML escape codes, like //> < &// dokuwiki markup doesn' | ||
- | * leading a line by two spaces renders the line as " | + | |
+ | |||
+ | < | ||
+ | The protocol in a url is separated from the path by a colon and two slashes, for example: | ||
+ | http:< | ||
+ | </ | ||
+ | |||
+ | This should render as you expect, meaning not switching italics on for the rest of the document: | ||
+ | |||
+ | The protocol in a url is separated from the path by a colon and two slashes, for example: | ||
+ | http:< | ||
+ | |||
+ | | ||
this is code | this is code | ||
- | === Notes === | + | ==== |
+ | Currently we are using the following convention to link to the source HTML tutorials, via a snippet at the end of the tutorial that looks like so in dokuwiki markup: | ||
+ | |||
+ | >< | ||
+ | |||
+ | For example, the markup looks like: | ||
+ | <code dokuwiki> | ||
+ | |||
+ | [[http:// | ||
+ | </ | ||
+ | |||
+ | And the Example page would then include: | ||
+ | > | ||
+ | |||
+ | |||
+ | |||
+ | **Notes** | ||
porting_existing_tutorials_to_the_wiki.txt · Last modified: 2024/09/16 06:28 by hc9