27 May
2006
27 May
'06
22:58
On 5/28/06, Jerry Westrickwrote: > Hello there, my first post post here... > I was sent to this list from the OpenSUSE list... > > I'm trying to write some documentation about > remote access to SUSE. > > Unfortunately, I'm down with a real bad flu... Yes, but this sounds like a reason TO work on the wiki, otherwise you should go out an enjoy the real world :-) > my problems are: > 1) the documents look like shit. > 2) I need to use tables to organize the options. Wiki tables are a litte tricky, but simple tables are relatively simple. You can also use HTML tables, which means if you have a way to convert your original text to HTML, it makes it easier. > 3) I'll want lots and lots of screen shots for the newbies... Simple but does require a bit of work. You need to upload each image that you want to use. And then insert them using a tag like [[Image:filename.png]] where filename.png is your image filename. See this (on-topic) page for an example: http://en.opensuse.org/Terminal_Services_Client > Additionally, I find it hard working on the wiki documantation. You will soon have forgotten the luxury of WYSIWYG :-) and practice makes perfect. > Any tips appreceated. 1. Have a look at www.Wikipedia.org you can look at the source of any page to learn how they created particular document features. 2. Specifically read this page: http://en.wikipedia.org/wiki/Wikipedia:How_to_edit_a_page it is the best single page on how to edit in a wiki. 3. When moving from a document to a wiki, remember that you are now part of something larger. And also try to break up large pages into logical pages. eg: SSH Tunnels should be explained on it's own page so that a wide variety of pages (including from other authors) can refer to it (ie on a page on how to use SSH from Windows it should not explain what SSH tunnels are, but just link to the SSH Tunnel page). > Jerry > P.S. How do I get something like this into wiki? > http://home.intergga.ch/Westrick/Using_SSH_tunnels_from_M$_Windows.pdf I did one page from the pdf : http://en.opensuse.org/SSH_Tunnels_from_Microsoft_Windows Peter 'Pflodo' Flodin