[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.

Welcome to the Slackware Documentation Project

Differences

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

Link to this comparison view

Next revision		Previous revision
Next revisionBoth sides next revision
slackdocs:offline_editing [2012/12/25 04:43 (UTC)] – created mfillpotslackdocs:offline_editing [2013/01/02 09:41 (UTC)] – [Obtaining Existing Wiki Pages] typo sycamorex
Line 1: Line 1:
 +<!-- 0.0.2 -->
 ====== Offline Wiki Editing ====== ====== Offline Wiki Editing ======
  
Line 10: Line 11:
   * Translating an article   * Translating an article
  
-===== How to Edit Documents Offline =====+===== 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, a git repo //(listed below)// has been established with 
 +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 
 +**<nowiki>?do=export_raw</nowiki>** to the end of the url such as 
 +[[http://docs.slackware.com/slackware:current?do=export_raw]]. 
 + 
 +<note> 
 +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. 
 +</note> 
 + 
 +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 to a local text file. 
 + 
 +===== Offline Editing =====
  
 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 32: Line 63:
 your content. your content.
  
-To edit an existing article you will need to open the article in your +The file **syntax.docuwiki** is included with the git repo files to give
-webbrowser, click the //"edit this page"// button on the top of the page and +
-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.// +
- +
-<note>The file **syntax.docuwiki** is included with the git repo files to give+
 brief examples of the dokuwiki syntax that is used by the Slackware brief examples of the dokuwiki syntax that is used by the Slackware
 Documentation Project. Documentation Project.
-</note> 
- 
-To edit an existing article you will need to open the article in your 
-webbrowser, click the //"edit this page"// button on the top of the page and 
-copy the text from within the WYSIWYG box into your new local document. 
  
 <note> <note>
Line 112: Line 131:
 ===== 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 **xclip** application from SlackBuilds.org+Install the **[[http://sourceforge.net/projects/xclip/|xclip]]** application 
 +from [[http://slackbuilds.org/repository/14.0/misc/xclip/|SlackBuilds.org]].
  
-Issue the command <code>cat {filename} | xlcip -selection clipboard</code>+Issue the command <code>cat {filename} | xclip -selection clipboard</code>
  
 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
Line 136: Line 156:
 page --> page -->
 {{tag>offline-editing author_mfillpot}} {{tag>offline-editing author_mfillpot}}
 +

Trace:

slackdocs:offline_editing ()