Differences

This shows you the differences between two versions of the page.

--- how_to_contribute [2024/01/22 16:56] – [Text formatting] johnsoevans
+++ how_to_contribute [2025/09/19 15:18] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== How to contribute (users only)======
+====== How to contribute (registered users only)======
+Wiki software is a type of collaborative software allowing web pages to be created and edited using a simple web browser interface. This means that everyone who is a member of the wiki can contribute.
-====Welcome to the topas wiki website!====
+Because of hacking problems we've had to disable automatic user registration and login.  To get an account please email John on his Univesity email address.  Tell him the username you want and the email you want to register under.  If you want to use a non-university or non-company email, please provide sufficient evidence that he know's you're not a computer.  For example, include your favourite space group.
+If you're new to wiki software, there are some instructions below on how to get started.  We suggest you go to the [[playground:playground|PlayGround]] page before you make your first real pages.
-Wiki software is a type of collaborative software allowing web pages to be created and edited using a common web browser. This means that everyone who is a member of this website can contribute to it and is very welcome to do so. Firstly you can go to the [[playground:playground|PlayGround]] page and try making a wiki page if you want before editing other pages.  Note that some pages (e.g. the [[manual]]) are read only.  Only registered users can change pages.
+If you're familiar with wikis, some site-specific guidance is:
+  * To add a topic that others can find by browsing we suggest you add to the alphabetical list at: [[alphabetical_listing_of_key_words|Alphabetical listing of keywords]]
+  * If you want to contribute a macro go to: [[macros|User Macros]]
+  * Add a page anywhere you like by typing the a new url in the top bar like "https://topas-test.awh.durham.ac.uk/doku.php?id=mypage" then clicking the grey pencil icon on the right to "Create this page"
+  * Try to keep images and other files as small as sensible
+  * Be aware that the moderators will remove any pages they think are inappropriate
+Most pages can be editted by users but some (e.g. manual pages) are read only.
+Enjoy!
 \\
 ----
 \\
 ==== Editing wiki pages ====
@@ Line 22: / Line 31: @@
   - You can change text styles, upload images and files and more complex text formatting (see [[how_to_contribute#text_formatting]]).
   - The information that you have typed will appear on the page you have edited.
 \\
 ----
 \\
 ==== Creating wiki pages ====
@@ Line 37: / Line 44: @@
 \\
 Alternatively, insert an external link  ({{:linkextern.png?18|}})  to an existing web page, so that people can access what you want to contribute.
 \\
 ----
 \\
 ==== Text formatting ====
@@ Line 56: / Line 61: @@
   * {{:h3.png|}} - This is a smaller header, used for subtitles (h3)
-  * {{:macro.png|}} - This is a button for formatting macros that you may see (see [[how_to_contribute#formatting_macros]] below)
+  * {{:macro.png|}} - This is a button for formatting TOPAS INP code and macros that you may see (see [[how_to_contribute#formatting_macros]] below)
 \\
 For help with text formatting go to [[wiki:syntax]]
 \\
 ----
 \\
+==== Formatting TOPAS snippets ====
-==== Formatting macros ====
+On lots of the wiki pages you'll see that TOPAS INP file snippets are colour coded in a similar way to in jEdit. It is very simple to make your macros colour coded too.  If you can see {{:macro.png|}} in the editor toolbar press it and this will appear:
-On the [[macros]] page on this dokuwiki site, the macros are colour coded. It is very simple to make your macros colour coded too, just read these basic instructions:
-  - After creating a link to a new macro, put a title, a description (a why) and contributed by.
-  - Press {{:macro.png|}} in the editor toolbar and paste your macro where it says Macro Code (the highlighted text).
-\\
-e.g. Press {{:macro.png|}} and this will appear
   <code topas>Macro Code</code>
-Insert your macro where it says Macro Code.
+Insert your TOPAS snippet where it says Macro Code.
+If you don't see {{:macro.png|}} then you can just type the formatting flags in yourself as below:
+   <code topas> ...[your topas code over several lines if needed]... </code> as text.
 \\
 ----
 \\
 ==== Word files to dokuwiki format ====
@@ Line 103: / Line 99: @@
 Alternatively add images manually to the topaswiki page you have created using this button {{:image.png|}} in the editor toolbar in <html><span style="color:blue;">edit this page</span></html>.
 \\
 ----
 \\
+For any questions or queries, ask them in the [[https://topas-test.awh.durham.ac.uk/flarum/public/|TOPAS forum]] or look at the [[frequently asked questions]] link.
-For any questions or queries, ask them in the <html><a href="http://topas.dur.ac.uk/unb/forum.php">forum</a></html> or look at the [[frequently asked questions]] link.