BayTeam:Conversion to wiki

From BayTeam

This projet page is for the conversion to wiki of the old bayteam.org site. Will add various notes, links, instructions here.

Currently of interest:

• BayTeam:Conversion list of articles
• Category:Wiki conversion project
• Help:Administrative tasks#Redirecting old web site's page to wiki page

[edit] How to convert an article

1. In the Conversion list of articles, click the article name.

   If the page doesn't yet exist, this displays an empty edit page for this title.

2. Go to old site's page.
3. Decide whether to convert from the old HTML or just from the plain text--for simple pages, the latter is probably easier.
   • To convert plain text as displayed on the page, just select the text as it appears on the screen--not the headers or the footers, just the main information from that page.

     Example text conversion to wiki

   • To convert from the old HTML, in your browser, select Page Source from the View menu (actual labels may vary from browser to browser). Then select the main text--look for the first sentence of what appears on the original page and select from there to the last sentence that appears on the original page.

     Example HTML conversion to wiki

4. Copy what you've selected and paste into the wiki edit window for the new title.
5. Convert headings:
   • Use "sentence case" not "title case" for headings; e.g., "Converting a page", not "Converting A Page".

   From HTML:

   • Get rid of the <h1> and </h1>; that probably duplicates or nearly duplicates the new article title & isn't needed.
   • Replace <h2> and </h2> with == (two equal signs).
   • Replace <h3> and </h3> with === (three equal signs).
   • Etc.

   From plain text:

   • Surround main headers with left-justified == (two equal signs).
   • Surround next-level headers with === (three equal signs).
   • Etc.

6. Convert bulleted lists as follows:
   • Start each bullet with a left-justfied asterisk (*). If the lists are nested, use 2 or more ** left-justified as needed.
   • (If converting from HTML, that would be: Change each <li> to an *, and then remove </li>,<ul>,</ul>)
7. Convert bold and italic as follows:
   • Make something bold by surrounding with ''' (three single quote marks) (In HTML, replace <b> and </b> with ''' (three single quote marks))
   • Make something italic by surrounding with '' (two single quote marks) (In HTML, replace <i> and </i> with '' (two single quote marks))
   • Other HTML text formatting--just remove, or replace with bold or italic as needed to convey the meaning. Can even make bold AND italic (three single quotes with two more single quotes).
8. Convert paragraph breaks by leaving a blank line between paragraphs (and, in HTML, by removing <p> and </p>).
9. Remove <br> in most cases--either they're not needed or replace with a blank line. In rare cases they'll need to stay.
10. Convert tables as follows:
    • Replace <table blah blah blah> with {| blah blah blah.
    • Replace </table> with |} on its own line.
    • Replace <tr> with |- on its own line. Remove </tr>
    • Replace <td> with | at the beginning of a new line,immediately followed by whatever used to be between <td> and </td>. Remove </td>
11. Convert links to FILES (e.g., PDFs, GIFs, JPGs, etc.) like this:
    • Surround the text to be linked (e.g., "read this document") with single square brackets, like this: [read this document].
    • Immediately after the first square bracket, insert the full current URL and leave a space after the URL before the label text. For example: [http://www.bayteam.org/docs/somedocument.pdf read this document].
    • Get rid of all the <a href= or <img src= that's left, and also the </a>.
12. Get rid of pretty much all the rest of the HTML. If in doubt, ask.
13. At the bottom of the page, add the category indicated in the list of pages to be converted like this: [[Category:indicated category]].
14. If it's fully converted, also add at the bottom [[Category:Converted pages]]. If it's NOT completely converted, add this text at the top of the page: {{finish-converting}}.
15. Click Show preview to be sure it looks OK.
16. Click save page to save the new page.
17. Update the status in the list of pages to be converted.
18. There are other things to convert, but that's the major stuff I hope.
19. IMPORTANT: Notify webmaster (at) bayteam (dot) org so that he/she can redirect old web site's page to new wiki page.