Website

This page is not up to date, the website is no longer using ghost and has been migrated to a new CMS. For more info please contact the site admin at magari[(at)]eauchat.org

The administration interface of the website (to add posts, events, wiki articles...) is available here.

Posting on the website blog

Anyone is welcome to post contents on our website blog.
To post contents, you will need an account on the website. To create one, contact someone in the it team so that they create it for you.
You can create new posts from the posts section, then don't forget to add some tags to your post clicking on the little gear in the top right of the screen. One tag that should be on every post is the languages in which it is written, language tags should be in the format "lang:en", "lang:it"...
When you're done writing, click on "publish" in the top right corner, and click on the publish button to set your post live now.

Adding an event

Similarly to creating individual posts, you can add events that will be displayed on the calendar page of the website.
Please only add an event if it was previously discussed and agreed collectively in a meeting.

To add an event, the process is the same as for a post, you will just have to add the "#event" tag, so that the system knows to display it in the calendar page. Also, for events, please use the "excerpt" section to add the date and location where the event will take place (in the format "YYYY-MM-DD · Location") so that the page can sort them in the appropriate order and make the display more straightforward.

Contributing to the wiki

The wiki is a section of the website documenting tools we use in the community, what they are and how to use them.
Similarly to creating individual posts, you can add and modify wiki pages that will be displayed in the wiki section of the website.
Anyone is welcome to contributing to the wiki, but please remember that it's meant to be a place to share about tools used by the community, and not necessarily a general documentation about how to live life. Also the wiki should be used to share factual information, not opinions or views (this you can do in posts ;)).

To add or modify a wiki page, follow the same process as for posts, but don't forget to set the "#wiki" tag, so that the system knows to display in the wiki section. Also, the excerpt field should be in the format "CATEGORY-00.0" where "CATEGORY" is one of the wiki categories (currently "IT" or "MEETING") and "00.0" a number representing the index where to display the page in the list of wiki posts of this category. So check other wiki posts to see their index, to chose yours accordingly, so that the ordering of items make it more straightforward to find info in the wiki.

Note that if you want to modify existing wiki pages, if you're not site administrator, you should ask the person who created them (or a site admin) to add you as co-author, which will give you the right to modify them.

I made a drawing, can you add it to the site?

Yep, sure, wonderful, we're super happy of anyone sending us some drawings they made :)
The easiest is that you send it to magari[(at)]eauchat.org, and the it team will take care of adding it.

Is there a way to see all the drawings ?

Yep, you can visit this page, and there are all the drawings that people made :)

Administration of the website

To manage the website, you will need to be part of the IT team, to have access to credentials.

Modifying pages:

Modification of pages is restricted to the IT team and should be done only after a collective decision in a community meeting. Pages present the community vision, so the content of them should be agreed collectively in meetings.

Modification of pages is pretty straightforward from the interface, it's just important not to forget that if a page is modified in one language, it should simultaneously be modified in all other languages. So that we don't end up with a mess of different visions in different languages ;)

Adding a new page:

To add a new page, the same process should be followed as for modifying existing ones.
Additionally, if the page is multilingual (which most pages should be), you will have to register each version in the "Code injection" section of the administrative interface. Add it to the "pages" section for each language, with the appropriate "path" and "title" (the path is what you chose as url when creating the page).
If the page should be displayed in the navigation bar, you should also add it to the "navbar" section for each language.
Please be very careful with the markup in the "Code injection" section, and don't modify anything if you're not sure of what you're doing, because you can break the whole site if this section is messed up.

If you need more info on how to handle other more advanced aspects of the website, you can visit this page for a full documentation on how to use the maghost theme, and also check the ghost documentation.

Adding backgrounds to the sides:

To add a background on the sides of the pages, first make sure you have an image with the appropriate dimensions, optimized and with size maximum 400x300 pixels (the idea being that images should be very light in order not to bloat pages loading with decorations for people who visit the website, images should be between 20 and 50kb max if well optimized, with good enough quality of display when small).
Also it would be nice to remove the metadata from the image if you can, which will save a bit more space, and improve privacy.

Once you got your nice optimized image, you just can open the "#backgrounds#" page (from the pages list), create if necessary a new "Gallery", upload your images to the gallery, and update the page.

Adding new users:

Adding a new user is not as easy as it seems. We cannot rely on the general way to add users proposed by the administration interface, since the server is not able to send subscription emails.

You will need to create a file in your computer called "newuser.json", and add the following content inside it:

{
  "data": {
    "posts": [],
    "tags": [],
    "posts_tags": [],
    "users": [
      {
        "id":"1",
        "name":"<User name>",
        "slug":"<username>",
        "email":"<user@email.dom>",
        "visibility":"public",
        "created_at":"2000-01-01 12:00:00"
      }
    ]
  },
  "meta": {
    "version": "3.40.5"
  }
}

replace all values in between by the corresponding name, username and email of the new user. (You could also modify the "created_at" to set it to the moment you're doing this.)

Then visit the "Labs" section of the website admin interface, scroll to "Import content", and upload the json file you just created.
Now visit the "Staff" section, you should see the user you just added, open it, click on the little gear in top right of the screen, click "suspend user", validate, then redo the same clicking "unsuspend user" and validate.
Now you can let the user enter their password two times and validate (if you do this distantly, set a temporary password, share it in a secure way with the person, and ask them to modify it themselves from the admin interface after logging in).
The person should now be able to login with the newly created account.

Roles:
Once you created the user account, by default, their role will be set to "Author", this allow the user to post freely and modify their own posts. If you want the user to be allowed to modify other people's post, you can give them the "Editor" role. If they are in the IT team and should be able to modify the whole website (modify pages, add users...), you can set them as "Administrator".