How to add content to the Innovations in Fundraising wiki

It's great to see you joining our community of people interested in Innovations in Fundraising. We want this to be a rewarding experience for you; by adding content you will gain feedback and be given credit for your contributions. This page will introduce you to the most important things you will need to know if you want to contribute directly to this wiki. It may look complicated at first, but actually there are only a few things to learn, and wikis are a fun and useful tool to have under your belt.

  • Read about the project: This wiki is part of a larger project on practical and data-driven innovations in fundraising. Follow this link to familiarise yourself with the purpose of this project before you start adding any content.
  • Get an account: Most pages will be accessible for you to read even without an account, and to add comments at the bottom. However, for most pages editing is usually possible only if you're signed up and logged in. This allows the project team to track changes and follow up on interesting additions to the wiki. So if you're considering contributing, we suggest you get an account. At the moment, this is only possible by getting in touch with one of the administrators, who will create an account for you. Please email “daaronr at gmail dot com”. Getting an account is also the only way to create new pages with your own content.
  • Get to know the structure of the wiki: Wiki content exists as pages that we organised in several overarching categories – similar to how files can be organised in folders. If you examine the sitemap, you can see the following structure:
    • several top-level files not stored in any folder: these are primarily responsible for interactive features within the wiki and cannot be edited
    • iifproject folder contains material related to the project in general
    • iifwiki folder contains the main wiki articles on various aspects of fundraising innovations and related themes; we refer to these articles as our knowledge base
    • playground folder contains pages that explain how to use this wiki (as the page you are currently reading) and a PlayGround draft page that allows you to try things out
    • papers, tools and tables folders are special in that they contain material that has been automatically “fed” to the wiki from our collaborative database rather than written; these comprise what we call our evidence base and are not editable via the wiki interface but rather require adding content through special forms or directly through the database – if you would like to contribute to these, contact “daaronr at gmail dot com”
  • Get started and don't be afraid: To collaborate with others through a website like this can seem daunting. You might be afraid to offend someone if you change some of their work or you feel like you don't know enough to add to the wiki. Don't worry about either! If you found your way here, you're interested in the area and that's all that matters. If you treat others and their work the same way as in the offline world, no one will be upset. Lastly, if you're worried about the technical challenges that come with working with a new tool like this, you're in the right place to learn the few things you need to know.

There are 4 main ways in which you can contribute to this wiki:

  1. Editing or creating pages (described below): This requires registration.
  2. Adding comments in the Discussion section of different pages: This does not require registration. You can simply quickly suggest modifications or ideas for new content by leaving a comment.
  3. Filling out one of the forms that can be found on this wiki: This option is currently under construction.
  4. Editing one of the tables in our database: This option is also currently under construction. It will require registration to our collaborative database.

We encourage you to edit and add content to existing pages.

There are two ways of viewing and editing the source of a page:

  1. One is through a so-called “What you see is what you get”-editor (WYSIWYG). You can access this by clicking on the Edit page option in the sidebar, which opens if you click on the pen in the top-right corner of the page. It will show you the page source in the same way it will appear once you save it. It is like most word processors you will have come across, including the ubiquitous Microsoft Word.
  2. The other way is by viewing the page source as the DokuWiki markup it is stored in. You can access this by clicking on the DW Edit button under the editor window. If you ever worked with any other markup language such as LaTeX or Markdown, this might be easier for you. This page summarise the syntax of the DokuWiki markup and the image below shows an example of what that looks like.
  3. In order to switch back from the DokuWiki editor to the WYSIWYG editor, just push on the CKG Edit button under the editor window.

If you edit a page, please be aware of the following things:

  • Once you start editing, the page will acquire a lock. This is to prevent simultaneous editing by different people, which might result in conflicting changes. If you have been inactive for a certain time, the lock will expire and the page will become available to other users.
  • If you finish editing or decide to leave the editing mode without saving changes, please use the corresponding buttons and do not make use of the “back button” on your browser, as this can have unexpected side effects. Rather, use the Save or Cancel buttons.
  • If you edited a page and are about to save it, please leave a note in the Edit summary field at the bottom of the page. This will make understanding the history of a page a lot easier for other users and yourself.
  • If you made a change and something unexpected happened or you accidentally deleted parts of the page, don't panic. You can find a list of all previous versions from within the last four weeks by clicking on the Old revisions button in the sidebar. You can then view any of the available versions by clicking on them. Once you do, you will notice the “This is an old revision!” message at the top of the page and you can either restore this version of the page by using the Restore button in the sidebar or simply continue editing it and save as you normally would.

You can try things out on the playground and move on to the wiki page of your interest once you're feeling ready to go.

In order to create a new page you can use two methods:

  1. Creating a link to it from an existing page. If you are using the WYSIWYG editor, click on the Link button in the editor toolbar. If you are using the DokuWiki markup, just type in the link as explained in the syntax guide.
  2. Manually navigating to the page you would like to create in the address bar of your browser.

Now, both of these methods require understanding one of the underlying principles of the wiki - namespaces. They are very similar to folders on your own computer insofar as they help organise content by assigning each page to a certain group. For example, the namespace this page is residing in is “playground”. The page itself is actually called “howto”. The namespace and the page name are separated with a colon. Together, this makes the internal link of the current page “playground:howto”. You can easily see that this is so in the address bar: If you want to see more examples of this, leave your cursor hovering over any of the internal links (such as this one) and it will show you the precise structure.

Having now an understanding of namespaces, the procedure to create a new page is as follows:

  • Build the link to your new page by typing in “your desired namespace name:your desired page name” either in the editor or in the address bar. Since most of the contributions will deal with our knowledge base the namespace will typically be “iifwiki”.
  • Both the namespace and the page names should be all lower case and instead of spaces you should use underscores (_).
  • If you now click on the link you just added, it will take you to your new page. A message will appear notifying you that the page does not exist yet. Simply click on the Edit page button, add your content, save and you'll have your new page.
  • If at any point you change your mind, deleting all page content deletes the page.

More Resources

  • The DokuWiki homepage is always a good place to go to.
  • Here are a few screencasts on DokuWiki. Most are done using older versions of DokuWiki but the basic functionality has not changed.
  • Wiki syntax documentation gives both the syntax and a good idea of useful features

Have any issues or suggestions? Please let us know by filling in this form.

  • playground/howto.txt
  • Last modified: 2018/04/18 16:51
  • by katja