Reviewed-on: #3 |
||
---|---|---|
site | ||
.drone.yml | ||
.gitignore | ||
Dockerfile | ||
LICENSE | ||
README.md | ||
TRANSLATE.md | ||
docker-compose.yml | ||
publiccode.eu.conf |
README.md
Public Money Public Code – Source of publiccode.eu
This website is the core of the "Public Money, Public Code" campaign. It is based on Hugo, a modern static website generator.
The page is visible at publiccode.eu.
Table of Contents
Contribute
Prerequisites
In order to modify the website, you need hugo
and git
installed on your
computer. If Hugo isn't available in your package manager, obtain it from its
official website. We tested the website build with Hugo
from version 0.20.7 upwards. Please make sure that you use an as recent version
as possible to avoid errors.
Configuring Git
First of all, you'll need an account on git.fsfe.org. FSFE supporters and registered volunteers can just log in with their username and password. Interested newcomers can apply for a volunteer account (consider @max.mehl to be the group coordinator in this case). In the FSFE's wiki, you'll find information about our Git service, how to get access, and some guides for basic procedures like configuration, commits, and pushes.
As part of the campaign team you can get full write access to this repository. Please contact one of pmpc's admins to give your account the necessary privileges.
Cloning the website
Although the mentioned Git guides will enable you to understand how to download
the website's repository, here's a short howto: Navigate to a directory on your
computer where you want the PMPC website to be stored. In this example, it's
FSFE/PMPC/website
in your user's directory.
mkdir -p ~/FSFE/PMPC/ # Create the directory if it doesn't exist yet
cd ~/FSFE/PMPC/ # go to the newly created PMPC directory
git clone git@git.fsfe.org:pmpc/website.git # clone the website to the folder website
In the newly created folder pmpc-website
you'll find all source files the
website consists of now. The hugo files are located under site/
, whereas in
the root directory you'll only find files informational files and those
relevant for our build process (Drone, Ansible, Docker, Apache).
Translate
Visit TRANSLATE.md for detailed instructions how to translate publiccode.eu.
Build
To see a preview of the website you need to have Hugo installed and be able to execute Bash scripts in your command line.
- Navigate to the website's root directory (in the last example
~/FSFE/PMPC/website/
) and open a terminal window there. Type ingit pull
. This will get the latest changes from the server - In the terminal, execute
cd site/
to navigate in the right directory for hugo's website build. You are now in~/FSFE/PMPC/website/site/
- In your terminal, execute
hugo server
. This command will build the website and enable you to browse the result on your computer only. Open localhost:1313 in your web browser to see it.
If you want to make changes to the official website, please read our
Git guides. There you'll find out
about the necessary commands pull
, status
, add
, commit
, and
push
.
There are three ways to upload/edit files in the Git repository, sorted by preference and complexity:
- For more experienced Git users we recommend the Fork & Pull Request workflow, which you'll also find a detailed wiki's Git Guide for.
- Advanced and interested beginners can directly commit to the repository ("push to master") which saves them some steps, but they have to ask @max.mehl in advance to give them the necessary permissions. You'll find guides in the Wiki's Git section.
- Beginners can work directly in the web interface of git.fsfe.org. As soon as you have given write permissions by @max.mehl, you can edit opened text files and upload/create new files. This is the least preferred option because it may cause conflicts, but it is easy and may give you some first experience with the system.
HowTos and FAQs
Important file paths
The website structure is very easy. The most important files and directories are:
site/config.toml
: Static texts, URLs and variables which are the same for any languagesite/i18n/{en,fr...}.toml
: Headlines, site title, many texts for the various languages.site/content
: Markdown-files for sub-pages like /openletter, can be translatedsite/data/{en,de...}/share
: Services and their very short translatable strings where people can share to. Is being used in the "Spread" section and the left-side sharing iconssite/static/
: CSS, images, and Javascript files for the design.site/static/css/custom.css
: File where all custom CSS code should be written to.site/layouts/
: HTML structure (scaffold) for the website. Useful if you want to add another section or modify anchor links or CSS classes.site/layouts/page
: Template for a sub-page like /privacysite/layouts/shortcodes
: HTML/Hugo code which can be important from within a Markdown filesite/public/
: Built files which are used to display the website. Generated by runninghugo
.
Add a new supporting organisation
Adding a new supporting organisation requires a few simple steps:
- Add a new entry in site/data/organisations/organisations.json in valid JSON format, the file should be self-explaining: name is the full name of the organisation, img is the name of the logo file (case-sensitive!), and url the web address of the organisation. To make sure that the file has a valid JSON syntax you can use jsonlint.com or another tool before committing your changes.
- Add the organisation's logo to the site/static/img/organisations directory. Please only upload PNG files with maximum 150px width or 100px height – ideally using transparency instead of white as background so we can also use it on other backgrounds some day. Consider using
pngcrush
or a similar tool to reduce the file's size and remove metadata. - Add further contact and background information about the organisation to our database (only accessible to PMPC core team members).
Technical information about the online build
The FSFE uses Drone to automatically deploy the PMPC website. The website is automatically deployed when there's a push to the master branch of the repository, a PR merged, as well as once an hour (to update signatures).
To trigger a build manually, use something like this:
git commit --allow-empty -m 'Trigger build'
Maintainers
Licence
This software is copyright 2018 by the Free Software Foundation Europe e.V. and licensed under the GPLv3 license. For details see the "LICENSE" file in the top level directory of https://git.fsfe.org/pmpc/website/