The DRESDEN CODE OF CONDUCT website
This project is in public beta phase. Please leave us feedback or report any objections via GitHub issue here.
If you like to contribute further translations of this code of conduct, please clone the project and provide a pull request.
We really appreciate any help to improve or extend this website.
Your community / event is committed to this code of conduct?
If you like to be listed on the website as a community or event, that commits to this code of conduct, please open an issue and add all the (contact) information of your community or event you consider to be noteworthy. You can also provide a logo, if you want.
Edit the website
The website is (obviously) generated static content.
If you want to make changes, fix typos or add missing content, please follow these steps.
1. Fork & clone the respository
- Please fork the repository to your github account.
- Clone the repository to your local machine
$ git clone https://github.com/<your-github-user>/dresden-code-of-conduct.org.git $ cd dresden-code-of-conduct.org/
2. Install the static page generator
$ composer update
The static page generator PHAR is placed to
vendor/bin/spg.phar and is executable.
3. Make it a Document Root of a webserver
The simplest way is to use the build-in PHP webserver, like this:
$ php -S 127.0.0.1:8080 # Should print something like this PHP 7.1.1 Development Server started at Fri Apr 14 11:03:32 2017 Listening on http://127.0.0.1:8080 Document root is /Users/hollodotme/Sites/dresden-code-of-conduct.org Press Ctrl-C to quit.
4. Generate the pages and sitemap for your locale base URL
In order to generate the pages for your local URL (http://127.0.0.1:8080/public or whatever your webserver's URL is), you need
to run the static page generator with the option
$ vendor/bin/spg.phar generate:pages --baseUrl="http://127.0.0.1:8080/public" $ vendor/bin/spg.phar generate:sitemap --baseUrl="http://127.0.0.1:8080/public"
5. Open in browser
Now you should be able to view the pages in your browser when visiting http://127.0.0.1:8080/public.
6. Make changes
- You can edit the content files located in the
- Please do not edit the
.htmlfiles, those changes will be gone when generating the pages.
- You can add new images in
- You can add new pages in the
./Project.jsonfile. Please refer to the already existing page configs there.
If you're using PhpStorm, you can set up a FileWatcher for the
./contents directory and let the page generator
automatically be executed as soon as you saved changes. You won't need to trigger the generator every time yourself.
7. Commit & push your changes
THIS IS IMPORTANT!
Before you commit your changes, please generate the pages and sitemap again without the
so that the real base URL from the settings will take effect.
$ vendor/bin/spg.phar generate:pages $ vendor/bin/spg.phar generate:sitemap $ git add -A $ git commit -m '...' $ git push
8. Create a pull request
Please create a pull request to the origin repository. We'll then check your changes and merge them.
Thanks for your help!