Difference between revisions of "Help:Contents"
m |
|||
(10 intermediate revisions by one other user not shown) | |||
Line 1: | Line 1: | ||
Here are some general semi-random bits of helpful documentation we've written or found. | Here are some general semi-random bits of helpful documentation we've written or found. | ||
+ | |||
+ | = Where can I find things? Where am I supposed to add things, or ask questions?= | ||
+ | |||
+ | There is a LOT of stuff on this wiki, and we know it. For someone new, we do realize that it can be overwhelming. Here is a crash course to get started: | ||
+ | |||
+ | * See the navigation bar on the left? You can use this to get to each of the main sections, or this page, from anywhere in the wiki. You can also use the search box to see if we have anything yet on your favorite section. | ||
+ | * By all means, click around and see what we have. If you find a red link, it means that the destination you would reach, were you to click on that link, does not exist yet. Even some of the pages that do exist have spots that say "to be filled in more later" or similar text. This wiki is not "done" and it probably never will be -- it is a constantly evolving and changing forum. | ||
+ | * Each of the pages we have is called (in wiki parlance) an "article." Each of the pages also has a "discussion" tab on the top left of each page. If that discussion tab is red, the so-called "talk page" doesn't exist yet. But, for several of the pages, that discussion tab is blue and the talk page does exist. If you click on the discussion tab, you might find a long or a short discussion about the contents of the main article. (Example: main article is [[Working_area_for_AAS_jan_2008_poster |this working area for writing our AAS posters]], and the discussion about it is [[Talk:Working_area_for_AAS_jan_2008_poster| here]]. See how the main article has introductory and summary information, but the discussion page has the back story, earlier versions, questions, interactions? that's the idea ....) | ||
+ | * If you have questions about some of the things you find here, or you find things that you think are wrong, or should be changed, '''most likely, you should add your question or correction to the talk page''' to see if anyone else agrees or disagrees with you. (The exception would be simple typos - if you find a simple typo, by all means correct it.) There is general wiki editing help below, ''including instructions for signing your question when you enter it on the talk page.'' | ||
+ | * In order to find what has been going on lately on the wiki, click on "recent changes" on the menu bar on the left hand side. This will show you all of the most recent changes to the wiki, and through the options on the top, you can control how far back in time it goes & whether or not it shows your changes as well as everyone else's. You can also use the "diff" and "hist" links on each line to see exactly what that person changed when they edited that page. | ||
+ | |||
+ | = Be polite. = | ||
+ | |||
+ | Please: | ||
+ | *Be polite. | ||
+ | *Use good grammar. | ||
+ | *Sign your questions or comments. | ||
+ | |||
= General wiki editing help = | = General wiki editing help = | ||
Line 5: | Line 23: | ||
Consult the [http://meta.wikipedia.org/wiki/MediaWiki_User%27s_Guide User's Guide] for tons of information on using '''(including editing files with)''' the wiki software. [[Playground]] to experiment with formatting. | Consult the [http://meta.wikipedia.org/wiki/MediaWiki_User%27s_Guide User's Guide] for tons of information on using '''(including editing files with)''' the wiki software. [[Playground]] to experiment with formatting. | ||
+ | * [http://www.mediawiki.org/wiki/Help:Formatting Formatting tags for editing pages] | ||
* [http://www.mediawiki.org/wiki/Help:Configuration_settings Configuration settings list] | * [http://www.mediawiki.org/wiki/Help:Configuration_settings Configuration settings list] | ||
* [http://www.mediawiki.org/wiki/Help:FAQ MediaWiki FAQ] | * [http://www.mediawiki.org/wiki/Help:FAQ MediaWiki FAQ] | ||
* [http://mail.wikipedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list] | * [http://mail.wikipedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list] | ||
− | |||
− | |||
= Guidelines for posting a comment = | = Guidelines for posting a comment = | ||
Line 27: | Line 44: | ||
=Guidelines for posting a file= | =Guidelines for posting a file= | ||
− | -- | + | Here is a step-by-step example on how to post a file. Be sure that you are on the right page for what you want to do, and name your file something other than this example filename -- if you pick a filename that already exists, it will link to that existing file. |
+ | |||
+ | Example posting of a contribution for the 2008 Jan AAS poster. | ||
− | + | #Follow the link to here: https://coolwiki.ipac.caltech.edu/index.php/Working_area_for_AAS_jan_2008_poster This is the 'overview' page. | |
− | + | #For contributed pieces for the poster, click on the "discussion" tab on the top left. It will take you here: https://coolwiki.ipac.caltech.edu/index.php/Talk:Working_area_for_AAS_jan_2008_poster | |
− | + | #Log in if you haven't already. | |
− | + | #Scroll down past the large graphic and see the conversations already taking place about what to put in the poster. Find the end of the conversation where you can add your contribution. | |
− | + | #Edit the page. | |
− | + | #Scroll down to the end of the conversation where you can add your contribution. | |
− | + | #OPTION 1: if you have plain text to contribute: | |
− | + | ##type the following in the page where you want to make your addition. | |
− | + | Note that the first set of characters can be obtained by clicking on the 'signature' button as demonstrated above, but may not appear when you are using safari. However, you can just type the characters as they appear here, and it will automatically put in your signature and timestamp. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
-begin example- | -begin example- | ||
<pre> | <pre> | ||
Line 57: | Line 63: | ||
</pre> | </pre> | ||
-end example- | -end example- | ||
− | + | #OPTION 2: if you have a jpg file beyond plain text: | |
− | + | ##type the following in the page where you want to make your addition. | |
− | + | Note that the first set of characters can be obtained by clicking on the 'signature' button as demonstrated above, but may not appear when you are using safari. However, you can just type the characters as they appear here, and it will automatically put in your signature and timestamp. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
-begin example- | -begin example- | ||
<pre> | <pre> | ||
Line 74: | Line 72: | ||
</pre> | </pre> | ||
-end example- | -end example- | ||
− | + | #OPTION 3: if you have a ppt file or anything else: | |
− | + | ##type the following in the page where you want to make your addition. | |
− | + | Note that the first set of characters can be obtained by clicking on the 'signature' button as demonstrated above, but may not appear when you are using safari. However, you can just type the characters as they appear here, and it will automatically put in your signature and timestamp. | |
-begin example- | -begin example- | ||
<pre> | <pre> | ||
Line 83: | Line 81: | ||
</pre> | </pre> | ||
-end example- | -end example- | ||
− | + | ALL OPTIONS CONTINUE HERE: | |
− | + | #Whichever option you use, then click the "save page" button to save your changes! | |
− | + | #When you save your edits, the bracketed will show up as a red link on the page. Click on the link. It will then ask you to upload the file. NB: if your link does not show up as red, it is linking to an existing file on the server, and you need to find a new filename for your file. Go back and edit the page and change the filename. | |
− | + | #Find the file on your local disk and upload it. It might give you a warning regarding file size. tell it to ignore the warning and upload anyway. | |
− | + | #After you upload the file, it will give you a page that includes among several other things a link that is worded something to the effect of "what links here". Click on that link to be taken back to the talk page which has the embedded link to your image or file. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− |
Latest revision as of 01:48, 20 February 2012
Here are some general semi-random bits of helpful documentation we've written or found.
Contents
Where can I find things? Where am I supposed to add things, or ask questions?
There is a LOT of stuff on this wiki, and we know it. For someone new, we do realize that it can be overwhelming. Here is a crash course to get started:
- See the navigation bar on the left? You can use this to get to each of the main sections, or this page, from anywhere in the wiki. You can also use the search box to see if we have anything yet on your favorite section.
- By all means, click around and see what we have. If you find a red link, it means that the destination you would reach, were you to click on that link, does not exist yet. Even some of the pages that do exist have spots that say "to be filled in more later" or similar text. This wiki is not "done" and it probably never will be -- it is a constantly evolving and changing forum.
- Each of the pages we have is called (in wiki parlance) an "article." Each of the pages also has a "discussion" tab on the top left of each page. If that discussion tab is red, the so-called "talk page" doesn't exist yet. But, for several of the pages, that discussion tab is blue and the talk page does exist. If you click on the discussion tab, you might find a long or a short discussion about the contents of the main article. (Example: main article is this working area for writing our AAS posters, and the discussion about it is here. See how the main article has introductory and summary information, but the discussion page has the back story, earlier versions, questions, interactions? that's the idea ....)
- If you have questions about some of the things you find here, or you find things that you think are wrong, or should be changed, most likely, you should add your question or correction to the talk page to see if anyone else agrees or disagrees with you. (The exception would be simple typos - if you find a simple typo, by all means correct it.) There is general wiki editing help below, including instructions for signing your question when you enter it on the talk page.
- In order to find what has been going on lately on the wiki, click on "recent changes" on the menu bar on the left hand side. This will show you all of the most recent changes to the wiki, and through the options on the top, you can control how far back in time it goes & whether or not it shows your changes as well as everyone else's. You can also use the "diff" and "hist" links on each line to see exactly what that person changed when they edited that page.
Be polite.
Please:
- Be polite.
- Use good grammar.
- Sign your questions or comments.
General wiki editing help
Consult the User's Guide for tons of information on using (including editing files with) the wiki software. Playground to experiment with formatting.
- Formatting tags for editing pages
- Configuration settings list
- MediaWiki FAQ
- MediaWiki release mailing list
Guidelines for posting a comment
Please start a new thread if you are starting a new comment.
--Dani 10:53, 4 December 2007 (PST)When posting, rather than typing your name and time, simply click the icon above the Subject/Headling square that looks like a squiggle. It is the second icon from the right. Click that before you start your post, it will post your name date and time for you. and then at the end of the post, simply type [end]
--Spuck 12:08, 4 December 2007 (PST) This is a very useful tool, so please use it. This is what it looks like on your editing screen:
--DanielleYeager 07:34, 5 December 2007 (PST) if you go into your preferences and change your 'nickname' it changes what comes up as your name for your signature.[end]
Guidelines for posting a file
Here is a step-by-step example on how to post a file. Be sure that you are on the right page for what you want to do, and name your file something other than this example filename -- if you pick a filename that already exists, it will link to that existing file.
Example posting of a contribution for the 2008 Jan AAS poster.
- Follow the link to here: https://coolwiki.ipac.caltech.edu/index.php/Working_area_for_AAS_jan_2008_poster This is the 'overview' page.
- For contributed pieces for the poster, click on the "discussion" tab on the top left. It will take you here: https://coolwiki.ipac.caltech.edu/index.php/Talk:Working_area_for_AAS_jan_2008_poster
- Log in if you haven't already.
- Scroll down past the large graphic and see the conversations already taking place about what to put in the poster. Find the end of the conversation where you can add your contribution.
- Edit the page.
- Scroll down to the end of the conversation where you can add your contribution.
- OPTION 1: if you have plain text to contribute:
- type the following in the page where you want to make your addition.
Note that the first set of characters can be obtained by clicking on the 'signature' button as demonstrated above, but may not appear when you are using safari. However, you can just type the characters as they appear here, and it will automatically put in your signature and timestamp.
-begin example-
--~~~~ Hi, here is what Esseim and I have been working on: (type in or copy-and-paste your text contribution here)
-end example-
- OPTION 2: if you have a jpg file beyond plain text:
- type the following in the page where you want to make your addition.
Note that the first set of characters can be obtained by clicking on the 'signature' button as demonstrated above, but may not appear when you are using safari. However, you can just type the characters as they appear here, and it will automatically put in your signature and timestamp.
-begin example-
--~~~~ Hi, here is what Esseim and I have been working on: [[Image:ourdraft.jpg]]
-end example-
- OPTION 3: if you have a ppt file or anything else:
- type the following in the page where you want to make your addition.
Note that the first set of characters can be obtained by clicking on the 'signature' button as demonstrated above, but may not appear when you are using safari. However, you can just type the characters as they appear here, and it will automatically put in your signature and timestamp.
-begin example-
--~~~~ Hi, here is what Esseim and I have been working on: [[Media:ourdraft.ppt]]
-end example-
ALL OPTIONS CONTINUE HERE:
- Whichever option you use, then click the "save page" button to save your changes!
- When you save your edits, the bracketed will show up as a red link on the page. Click on the link. It will then ask you to upload the file. NB: if your link does not show up as red, it is linking to an existing file on the server, and you need to find a new filename for your file. Go back and edit the page and change the filename.
- Find the file on your local disk and upload it. It might give you a warning regarding file size. tell it to ignore the warning and upload anyway.
- After you upload the file, it will give you a page that includes among several other things a link that is worded something to the effect of "what links here". Click on that link to be taken back to the talk page which has the embedded link to your image or file.