log inhelp

View
 

WikiTips

Page history last edited by Duncan Maru 1 month, 3 weeks ago

This page lists handy tips on creating and editing wiki pages.

  1. Private vs. Public Pages
  2. Folders
  3. Tagging
  4. Sandbox Pages
  5. Inviting New Members
  6. Don't Add Formatting to Section Headings
  7. Troubleshooting Table of Contents Links
  8. Importing Content from Word, PDF, Excel Documents

 

Tips

  • your work here doesn't have to look pretty (we have volunteers who periodically clean for formatting and style). Just post your ideas, make new wikipages, put links to the wikipages, etc.
  • Choose a short, relevant title.
  • The first few lines of each page should explain what the page is (e.g. see the top of this page)
  • use table of contents by clicking 'insert plugin'... "pbwiki magic"... table of contents... 3 deep; then highlight the desired headers and click format... "header 2" or for a subheader "header 3" ("header 1" tends to be too big and ugly).  Owing to a pbwiki bug, you have to highlight text from right to left to get headers to work out properly (not left to right). 
  • link back to other pages within the wiki liberally. 
  • you can download the wiki to view it offline at: https://wiki.nyayahealth.org/settings/backup
  • use tags to help organize:

          1) open the page

          2) click on the add tag icon to the right of the page
          3) type in your tag.
          4) now you have a URL for your tagged pages, e.g.: http://wiki.nyayahealth.org/w/tags/show?tag=data 

 

 

Private vs. Public Pages

The default security setting for this wiki is "public".  For public pages, you do not have to change anything when you create the page.

 

We do not use private wiki pages since they are inefficient.   For any pages that have private content, such as passwords, email addresses, or contact information, please put them within our google apps spreadsheets or docs and create a link to the webpage.  These google apps spreadsheets should be shared across our domain to allow easy and efficient login. 

 

Folders

All of the content in this wiki is organized by a folder system. Therefore, it is important to ensure that all new pages that are created or new files that are uploaded must be neatly filed away into its respective folder. 

 

Tagging

 

Sandbox Pages

Sandbox pages are ideas-generating pages on which we brainstorm.  They are created like any other page, but with the Sandbox_ZZZ in the title.  They  should be linked to the corresponding formal page, and the formal pages should be updated.  Sandbox pages allows us to organize our creativity without overwhelming the formal pages for content. 

For example: BloggingGuidelines is the formal page for the Sandbox_Blog

 

Inviting New Members

Go to https://wiki.nyayahealth.org/settings/users.  Add the user.  If you need to add a core member who should have administrator prilviledges and be able to see ALL hidden private pages, select "user settings" and add through that portal.  If you want a writer to have access to only one of the private pages, click on "page security" of that page and add that user.

 

Alternatively, on the right-hand side of any page, go to "share this wiki" and add the email address of the person you would like to add as a writer. 

 

Finally, tell the person: "i have invited you to the wiki via your email address.  please create an account with your email address at wiki.nyayahealth.org by clicking on "create account" on the upper right hand corner.  please see http://wiki.nyayahealth.org/WikiTips for some quick pointers on how to get started." 

 

Don't Add Formatting to Section Headings

When creating new sections in a page, don't format the title of the section with anything other than a header style, i.e. Heading 1, Heading 2, etc.  The Table Of Contents plugin can get confused by these, and fail to generate the anchor takes for the heading lines.  The result is that any link that refers to point to a particular section of a page will take the user to the top of the page instead.

 

Troubleshooting Table of Contents Links

Symptom: Clicking on a line in the table of contents for a page doesn't take you to the section.  The link may be in either the Table of Contents for the page, or some other web page.

Probable cause: See above.  The <h1>, <h2>, ... HTML tag in the section  heading has a style attribute.  It may take editing of the HTML source to get rid of the style attribute, as the Remove Formatting button on the WYSIWYG editor doesn't always seem to do it.

 

Importing Content from Word, PDF, Excel Documents

Many times, we create documents in word, pdf, or excel, save them on dropbox, and want to share them on the wiki.  There are three options to do this: 

1) import the document as a word document, ie create a new page... upload word document.   the challenge with this option is regular uploading to the wiki.  

2) link the created pdf or word file from within dropbox.  this is beneficial if you prefer the formatting professionalism of word or pdf; if link within dropbox, you can update it within dropox and the link will take the reader to the updated document. 
3) paste the contents of the file into the wiki.  this is beneficial if you like the style of the wiki with its hyperlinks and readability.

The choice is dependent upon the particular wiki page and style of the editor/manager of the page.  The most important thing is not to duplicate information, and to have a plan for maintenance that is simple.   

No matter which way you choose, make sure to tag and store your page so that they are easily accessible/searchable for your readers!

 

 

Comments (0)

You don't have permission to comment on this page.

PDF version