Editing Pages
To avoid loads of clicking about, this information is all on one page for the moment. It will probably be split into 4 or 5 pages eventually as it gets bigger.
Page 1: Signing Up and Logging In
In order to edit the content on this web site, you need to be logged in. At present, you also need to ask charles-wicksteed on Mattermost to make you an Editor or Contributor -- this will change!
The user accounts on this web site are tied to the accounts on the Communications Hub. See below for more information about the Communications Hub.
To sign up to this web site, click the 'Sign up' link at the top of the home page. Make sure you click on the "SIGN UP WITH UK HUB"HUB button first and ignore the name, email and password fields on the Sign Up page. You will need your Hub user name and password, unless you are already logged in to the Hub.
Logging in subsequently is done also with your Hub user name and password. Click on LOGIN WITH XR UK HUB on the Log In page.
At present, new users do not have the ability to edit the content until they are made Editors or Contributors by an admin. TheThis policyis has yetlikely to be worked out.change.
Page 2: Editing Pages
This web site runs on a software package called BookStack. Their home page is at https://www.bookstackapp.com/. We have our own copy of BookStack running on one of our servers in Switzerland.
The user documentation is at https://www.bookstackapp.com/docs/. We won't duplicate that here, but we will add things which are specific to this site or need extra clarification.
You can edit the pages on this web site, for example to fix a typo, correct a link or add extra information.
To do this, you need to sign up and log in (TBD references across to the relevant page when they are made, see above for the moment).
Then go to the page you want to edit.
On wide screens a sidebar will appear on the left hand side which includes an "Edit"Edit link.
On narrow screens, you have to click the Info tab at the top of the page to make the sidebar appear.
The editor accepts both Markdown and HTML. You may find that the page that you are editing is in Markdown or HTML or a mixture of both. For example in Markdown a bold word is indicated like this: **bold words** (rendered as 'bold words'). In HTML, you get the same effect with <b>bold words</b> (rendered as 'bold words').
For information about Markdown see: https://daringfireball.net/projects/markdown/basics and https://daringfireball.net/projects/markdown/syntax. You may wish to get yourself a summary of the Markdown codes by searching on the Internet for 'Markdown cheat sheet' -- there are lots.
For plain text content, no special markup is needed. Put a blank line between paragraphs.
It is a good idea to keep a copy of your text yourself locally in case it gets lost, through computer failure or user action. This can done by clicking in the editing area and doing Ctrl-A (Select All), Ctrl-C (Copy), then open Notepad, Ctrl-V (Paste), Ctrl-S (Save) and choose a place and name for it. These are the instructions for Windows. It will be similar for other operating systems.
When you have made your changes, make them visible by clicking Save Page in the top right hand corner.
Page 2B: Markdown Hints
This page contains tips for formatting your pages. Feel free to add things which you have found useful but were not obvious from the Markdown and BookStack documentation (see Editing Pages (above) for the links to those).
In addition to classic Markdown, BookStack supports the Markdown Extra extensions, see https://michelf.ca/projects/php-markdown/extra/. This provides a number of extra facilities in addition to the original Markdown, in particular support for tables. Here is a quick example of how to insert a table.
| Item | Value |
| --------- | -----:|
| Computer | $1600 |
| Phone | $12 |
| Pipe | $1 |
This renders as:
| Item | Value |
|---|---|
| Computer | $1600 |
| Phone | $12 |
| Pipe | $1 |
Page 3: Creating New Pages
You can create a new page by going to the Book or Chapter where you want the new page, and clicking New Page in the sidebar. You can change the order of pages by clicking Sort later, which lets you set the exact order you want.
If you think we should have another Shelf or another Book, please discuss it on the appropriate Mattermost channel or forum first so that we keep some kind of coherence. (Each Shelf needs to have a note of where discussions should be held)
Only users with the higher level of permissions (Editors) can create new Shelves, Books and Chapters. If you want to create a new Book, and you don't see the required link saying "New Book"Book under Actions on the parent Shelf page, please ask on the appropriate Mattermost channel and an Editor will create the Book for you.
Page 4: About This Web Site
At present, this site is intended for the United Kingdom only.
OtherBook Stuff2: About Extinction Rebellion
Eventually it may be helpful to have another Book here, eg:
Book 2: About Extinction Rebellionhere.
Page 1: Sources of Further Information
The main public-facing site for Extinction Rebellion in the United Kingdom is https://extinctionrebellion.uk/.
The global site is at https://rebellion.global/.
We encourage everyone in the UK to sign up to the Communications Hub, which gives you access to chat, forum and cloud storage (online documents) facilities to communicate with other rebels. For security reasons, you can't just sign yourself up -- you need to contact a Tech Champion in your Local Group or Community Group. To contact a Local Group or Community Group, look at the https://extinctionrebellion.uk/ web site.