[2024-feb-29] Sad news: Eric Layton aka Nocturnal Slacker aka vtel57 passed away on Feb 26th, shortly after hospitalization. He was one of our Wiki's most prominent admins. He will be missed.
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
slackdocs:offline_editing [2012/12/25 05:16 (UTC)] – [Copying from the CLI] added links mfillpot | slackdocs:offline_editing [2013/03/18 13:24 (UTC)] (current) – [Offline Editing] fixed typo sycamorex | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | <!-- 0.1.2 --> | ||
====== Offline Wiki Editing ====== | ====== Offline Wiki Editing ====== | ||
Line 10: | Line 11: | ||
* Translating an article | * Translating an article | ||
- | ===== How to Edit Documents | + | ===== Starting a New Article Offline ===== |
+ | The most basic way to start working on a new article offline is to open your | ||
+ | favorite text editor and start writing. However, when pasting the contents | ||
+ | of your article into the wiki you will need to paste the data inside of the | ||
+ | template. | ||
+ | |||
+ | As an alternative, | ||
+ | template files for each of the major sections within the wiki. You can start | ||
+ | with the template file to guarantee that the header and footer data is | ||
+ | retained. | ||
+ | |||
+ | ===== Obtaining Existing Wiki Pages ===== | ||
+ | If you wish to edit an existing page, you will first need to download the | ||
+ | ofiginal markup formatted text from the page, fortunately dokuwiki has a | ||
+ | built-in function to ease the trouble. | ||
+ | |||
+ | When in a webbrowser looking at the page you will need to append the syntax | ||
+ | **< | ||
+ | [[http:// | ||
+ | |||
+ | < | ||
+ | For translators it may be a good idea to save the links of documents that you | ||
+ | are converting and append the syntax above to the end of the urls so | ||
+ | wget can loop through the list obtaining new copies of each file. | ||
+ | </ | ||
+ | |||
+ | If you want to go the more traditional route, you can open the wiki page and | ||
+ | click the **edit this page** button to access the WYSIWYG interface, then | ||
+ | copy the contents | ||
+ | |||
+ | ===== Offline | ||
To simplify your editing needs, the slackdocs editorial team has a git | To simplify your editing needs, the slackdocs editorial team has a git | ||
Line 19: | Line 50: | ||
This repository is located at | This repository is located at | ||
- | [[https:// | + | [[https:// |
+ | |||
+ | If you wish to build a package from the github repo you can find an | ||
+ | associated slackbuild script set at [[https:// | ||
- | You can download single files from the github site or clone the complete | + | The script has many functions that can be reviewed |
- | repository | + | argument or viewing the man file. |
- | as a non-root user. | + | |
- | < | + | |
- | user@darkstar$ git clone git:// | + | |
- | </ | + | |
Once the template files are downloaded you can open the appropriate template | Once the template files are downloaded you can open the appropriate template | ||
Line 32: | Line 62: | ||
your content. | your content. | ||
- | To edit an existing article you will need to open the article in your | + | The file **syntax.docuwiki** |
- | webbrowser, click the //" | + | will give you brief examples of the dokuwiki syntax that is used by the Slackware |
- | copy the text from within the WYSIWYG box into your new local document. | + | |
- | + | ||
- | //Be sure to save the edited file with a new name to avoid | + | |
- | overwriting the original template.// | + | |
- | + | ||
- | < | + | |
- | brief examples of the dokuwiki syntax that is used by the Slackware | + | |
Documentation Project. | Documentation Project. | ||
- | </ | ||
- | |||
- | To edit an existing article you will need to open the article in your | ||
- | webbrowser, click the //" | ||
- | copy the text from within the WYSIWYG box into your new local document. | ||
< | < | ||
To simplify editing the docuwiki formatted articles, instructions to enable | To simplify editing the docuwiki formatted articles, instructions to enable | ||
- | syntax highlighting in various editors is included in this article. | + | syntax highlighting in various editors is included in the slackdoctool.. |
The extension **.slackdoc** is used for the templates to automatically enable | The extension **.slackdoc** is used for the templates to automatically enable | ||
Line 68: | Line 86: | ||
==== vim Syntax Highlighting ==== | ==== vim Syntax Highlighting ==== | ||
- | To simplify editing in the **vim** text editor the git repo listed above | + | To simplify editing in the **vim** text editor the slackdoctool can download |
- | contains a vim syntax file that will enable syntax highlighting for all | + | and load the necessary configuration |
- | syntax that is used by the Slackware Documentation Project wiki. | + | |
- | + | ||
- | The file // | + | |
- | contains all necessary | + | |
- | + | ||
- | === Installing the vim Syntax File === | + | |
- | To ease installation of the syntax file, the script named // | + | |
- | is included in the syntax_file directory of the git repo. This script, when | + | |
- | launched from that directory, does the following: | + | |
- | - Removes all lines that contain the word slackdocs from your // | + | |
- | - Adds the following lines to the end of the // | + | |
- | < | + | |
- | " Add a pointer to the $FILETYPE vim syntax file | + | |
- | au BufRead, | + | |
- | au! Syntax slackdocs source {repo_directory}/ | + | |
- | </ | + | |
- | This process removes any old configuration | + | |
- | updates it with the current configuration. | + | |
- | + | ||
- | You can alternatively add it to the standard syntax file location and turn | + | |
- | the syntax on automatically, | + | |
- | + | ||
- | < | + | |
- | If updates are made to the repo based syntax file you can update the repo by | + | |
- | issuing the command | + | |
- | the // | + | |
- | </ | + | |
==== kate Syntax Highlighting ==== | ==== kate Syntax Highlighting ==== | ||
Line 112: | Line 103: | ||
===== Submitting the Updated Article(s) ===== | ===== Submitting the Updated Article(s) ===== | ||
To submit the updated or new articles you will first have to open the article | To submit the updated or new articles you will first have to open the article | ||
- | on the wiki in **Edit** view, then you can either copy and paste the article | + | on the wiki in **edit this page** view, then you can either copy and paste the article |
into the WYSIWYG editor from your favorite text edit or use xclip to copy | into the WYSIWYG editor from your favorite text edit or use xclip to copy | ||
the contents from the command line. | the contents from the command line. | ||
==== Copying from the CLI ==== | ==== Copying from the CLI ==== | ||
- | Install the **[[http:// | + | Install the **[[http:// |
+ | from [[http:// | ||
- | Issue the command < | + | Issue the command < |
Then the complete document is in your clipboard, you can then paste it into | Then the complete document is in your clipboard, you can then paste it into | ||
the wiki's WYSIWYG editor. | the wiki's WYSIWYG editor. | ||
+ | |||
+ | Alternatively, | ||
+ | with the **-c** argument. | ||
+ | |||
====== Sources ====== | ====== Sources ====== | ||
<!-- If you are copying information from another source, then specify that | <!-- If you are copying information from another source, then specify that | ||
Line 135: | Line 131: | ||
page --> | page --> | ||
{{tag> | {{tag> | ||
+ |