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...
I've notcied that both jdd and PFLodo have made changes to it. Thx.
To my question:
I've finished (for now) the intro, Now I need to right diferent "Chapters" on how to setup different pieces of software I've been blabing about...
I would like to make the chapters seperate documents, each along the lines "Tell then what your are going to tell, tel them, and then tell what you just told then".
my problems are: 1) the documents look like shit. 2) I need to use tables to organize the options. 3) I'll want lots and lots of screen shots for the newbies...
And I don't know how to fix any of these...
Additionally, I find it hard working on the wiki documantation.
Any tips appreceated.
Jerry P.S. How do I get something like this into wiki? http://home.intergga.ch/Westrick/Using_SSH_tunnels_from_M$_Windows.pdf
On 5/28/06, Jerry Westrick jerry@westrick.com wrote:
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:
- the documents look like shit.
- 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.
- 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
Peter Flodin wrote:
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
the better way (ie the one I use most of the time :-) is to type in the text the name of the image where it's needed without worrying of the image itself. The link looks red. afterward, when clicking on the link, you are asked to upload it. If you upload the image first, you have to remember it's exact name (with case and extension). You can also use the Special:Newimages page
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.
and don't worry too much. people are looking at your work and will fix the typos. bigbrother is watching you :-) (http://en.opensuse.org/Special:Recentchanges)
jdd
On Sunday 28 May 2006 08:31, jdd wrote:
and don't worry too much. people are looking at your work and will fix the typos. bigbrother is watching you :-) (http://en.opensuse.org/Special:Recentchanges)
jdd
I guess there is lots of stuff out there....
But I haven't seen any of it...
Where is the indiex, the categories, the references?
I assume since nobody has said anything that this is not duplicated work?
Jerry
Jerry Westrick wrote:
Where is the indiex, the categories, the references?
the truth is I don't see/find a page to help new writers on the wiki. we have many pages on translation, few on writing. This should be improved :-)
I assume since nobody has said anything that this is not duplicated work?
not in this form, I think.
jdd
jdd wrote:
not in this form, I think.
And even if it is, better wins attention. The Wikipedia that looks to have only one article per topic solves this trough article merger process.
Someone propose merger with http://en.opensuse.org/Template:Merge than follows discussion on article Talk page, and one day you can see only one article for the topic.
jdd wrote:
I found the page :-)
http://en.opensuse.org/OpenSUSE_Wiki_Project
jdd
Me too. I usually follow this link http://en.opensuse.org/Wiki_Team.
What happened to the project?
BTW, I replied to you expanding your article a bit, just to tell Jerry that on wiki one has not to worry even if something is duplicate.
Rajko M wrote:
jdd wrote:
I found the page :-)
http://en.opensuse.org/OpenSUSE_Wiki_Project
jdd
Me too. I usually follow this link http://en.opensuse.org/Wiki_Team.
What happened to the project?
BTW, I replied to you expanding your article a bit, just to tell Jerry that on wiki one has not to worry even if something is duplicate.
you are right jdd
On 5/28/06, jdd jdd@dodin.org wrote:
the better way (ie the one I use most of the time :-) is to type in the text the name of the image where it's needed without worrying of the image itself. The link looks red. afterward, when clicking on the link, you are asked to upload it. If you upload the image first, you have to remember it's exact name (with case and extension)
And for years you will keep learning new little tricks, like I just learned this one :-)
Peter 'Pflodo' Flodin.
-
jdd -
Jerry Westrick -
Peter Flodin -
Rajko M