From CFIR Wiki
How do I contribute to discussions?
To see the ongoing dicussions, threads and topics for a particular construct, click the "discussion" tab toward the top-left of the page. The resulting page is where you can contribute to discussion of the construct through forum-like threaded topics.
The top portion of the discussion page is reserved for the discussion header. Here, the moderator of the site may post guiding dicussion points or rules for contribution.
Adding and replying to topics
Below the header is where you can view the ongoing discussions, start new threads, reply to suggestions and questions, etc. Each posted comment can be replied to individually. If you would like to start a new subject for discussion, click "Start a new discussion." To reply to a post or comment, click "Reply" on the signature bar at the end of the comment.
How do I upload a file (e.g., an instrument I used) and include it in a discussion?
- Click "Upload file" from the Toolbox section of the wiki sidebar.
- Click the "Browse" button and select the file.
- The "Destination filename" box is the name that the file will have in the wiki's database. It is also the name that you will use to reference it.
- If desired, fill in the summary and click upload.
- You can now refer to this file from any discussion or page in the wiki by using the following syntax:
[[media:<destination.filename>|<name to display in page>]]
For instance, if I uploaded a file called "Example.pdf" with the destination filename "Test.pdf" the form would be like this:
[[media:Test.pdf|An example upload]]
and appear as An example upload within the text.
For additional information for displaying images, formatting, etc., please see the official documentation for displaying these links at MediaWiki Help:Links
How do I monitor certain pages or discussion threads?
Most every page in this wiki has a "watch" tab along the top of it. Clicking this will add it to your watchlist. Once on your watchlist, the following can happen depending on the settings you have in your preferences:
- All changes pertaining to watchlist items appear in bold on the "Recent changes" page
- An email is sent when edits are made
On the discussion pages, each thread can be watched independently. The functionality is the same as that for pages, only specific threads are monitored instead. The watch option for threads are displayed on the thread subject line (the one that is underlined) on the far right.
How do I get emails when items that I'm monitoring are changed?
First, make sure you have an authenticated email address associated with your account.
- Log in and go to "my preferences" at the top-right of the page
- Ensure that the E-mail field is filled out. If it is not, you will have to enter one and click the authentication link in the email CFIR Wiki sends to you
- Once an email address has been authenticated (this most likely already happened when you registered), the options for email notification are at the bottom of the "User profile" tab of the preferences page
How can I get the Hot Topics/Recent changes page to be less cluttered?
To declutter the Hot Topics (aka Recent Changes) page:
- Click "my preferences" from the top-right of the page
- Click the "Recent changes" tab
You can also check the other options available to your liking.
What do all the tabs at the top of the CFIR Wiki pages do?
Unless you are an administrator, you will only see a subset of these tabs. Some tabs, such as "edit with form" only display on certain pages.
- page: clicking this tab takes you to the wiki page for the current article
- discussion: each wiki page has its own discussion page. This is where you post comments, suggestions, etc. for the current wiki page. (the red discussion tab in the second image means that no discussions have been posted yet for that page)
- edit with form: some pages in this wiki, namely the constructs, domains, and glossary terms, are editable with a form-like layout. clicking this tab will give you pre-defined text-boxes and upload forms for the current page. This lets you edit a page safely without needing to know about wiki formatting, templates, and parser functions. You want to use this instead of "edit"
- edit: gives you a single text-area input for the entire page. This is mainly used by site administrators to edit pages other than constructs, domains, etc. You will most likely not need this.
- history: gives you the subset of "Recent changes" that applies to the current page only. Site administrators use this page to roll back changes as well.
- delete: removes the page from the wiki. You can roll back deletions as well.
- move: this is used for make a certain page redirect to a new one. For instance, if a single page can be known by two different names, you can create the page under the first name and then use the move tab to redirect it to the second name. Afterward, both names with point to the same page.
- protect: protecting a page prevents anyone aside from administrators from editing the page. Administrators need to protect a page to prevent non-admins from editing them. Template, Category, and the MediaWiki namespaces are automatically protected.
- watch/unwatch: This adds or removes the page from your watchlist. Having a page on your watchlist makes its entries in the "Recent changes" page display in bold for easy tracking.
- refresh: forces a refresh of the page, bypassing the wiki's cache. Some changes take time to be cached for display to the users.
If you are editing with the rich-editor (you will have a 2-line toolbar of icons, similar to Microsoft Word), you need to:
- click the icon of a globe with a chain link ovelaying it. This will present you with a pop-up.
- begin typing the name of the page you want to link to. As you type, it will give you a list of matching pages within CFIR wiki.
- select the correct suggested link and click OK!
If you are not using the rich-editor, such as when you are typing in a field of the "edit with form" tab, you can create what is called an internal link (points from one wiki page to another) by surrounding the name of the page you want to link to with double square-brackets []. These links are case-sensitive, so writing [[Implementation Climate]] will show up as the legitimate link Implementation Climate, but [[Implementation climate]] will not link to the intended page, instead it will show Implementation climate as text. It should be noted that construct and domain names within CFIR wiki follow regular header-style capitalization (everything but articles, preposistions, conjuntions, etc. are capitalized). Note that if "and" is in the title, it is most likely using "&" instead.
How do I add a citation so it shows up as a footnote?
In general, you may cite references within your text. If, however, you want to format your contribution so that references show up as a footnote at the bottom of the page (with hyperlinks back and forth), it will take considerably more input. There is not a simple What-You-See-Is-What-You-Get (WYSIWYG) procedure. You will need to manually enter them using XML or HTML-esque syntax: <ref name=""></ref>
- If the section you are editing uses the rich-text editor (the one with the two-line toolbar depicted above) you need to either disable it (by clicking the "Disable rich editor" link) or switch it to Wikitext mode.
- Once you have done this, find the place in the text that you want to cite a reference. Here is where you place the <ref name=""></ref> tags. between the "" in the <ref name=""> tag add a short word or phrase (it cannot be numbers only, such as "123").
- Between <ref name=""> and </ref> is where you place the source citation.
- If you want to bold or italicize certain portions, follow the syntax described in Help:Wiki markup
- If you re-use the same source multiple times, you only need to do steps 3-4 once. The re-citations can be implemented by placing <ref name=""/> wherever you want (as long as it is on the same wiki page). The name="" must be the same as in step 2.
Sentence of useful information requiring a citation.<ref name="ref1">LastName XY, et al. '''Title of paper: Subtitle.''' ''Academic Journal Name'' 1994. '''<volume #>'''.<page numbers>.</ref> == References == <references/>
Note: Pages with the "Edit with form" option have the "References" section with the <references/> tag already included at the bottom of the form. However, pages with the "Edit" tab option will need to enter it maually.