How to Contribute to The Web Site
Table of Contents:
- How to add and edit information
- Useful references
This website is implemented using GitHub Pages service which makes it easy to create a website associated with a GitHub account or project. GitHub Pages uses Jekyll, a tool to automatically build a website from source files (which are kept in GitHub). The site content is written using the easy Markdown syntax (which is used by GitHub itself).
A beginner’s guide provides some useful hints to make using Jekyll in the HEPiX context easier.
How to add and edit information
For adding information to this site or modifying it, we follow the pull request workflow in GitHub.
Just fork our website repository and clone your fork, edit the files you want to add or modify, push them to your fork, and open a pull request.
If you wish (and it is recommended), you can easily set up a local instance of this web site in order to preview your submissions. See the documentation on installing and running Jekyll. The website uses the master branch of the hepix-forum.github.io repository.
If you are not familiar with GitHub and Git, you can read our survival kit!
General structure of website content files
All Markdown files of this site start with a section surrounded by
so-called front-matter section contains metadata about the content. Such metadata are
e.g. the author of the document or the title of the document.
In the front-matter (but not in the text itself), you need to replace any
& characters (which has a special meaning in HTML) by
This is particularly important for the
Adding a working group
To add a working group in the main menu and to allow to add pages attached to this working group, it is necessary to:
- Create a file at the top level, whose name represents the working group name, e.g.
mywg, and with the extension
.md. Look at
benchmarking.mdfor an example.
- In the front-matter section of this file, add the attribute
menuwhose value will be the menu name in the page main menu.
- Create a directory
_mywg(if the group name is
mywg) to contain additional pages for the working group