Changes to the master branch can be viewed at https://latex3.github.io/, which is the staging environment. If everything looks fine, you can merge master with live to have the server running https://www.latex-project.org/ pick up the changes.
The latex-project.org staging
https://latex3.github.io/ - main branch
The latex-project.org website
https://www.latex-project.org/ - live branch
If you want to develop locally first, this is the way to contribute:
- Fork this repository (and make sure you are in sync with it if you forked a while ago).
- Create a new branch for your changes:
git checkout -b branch-name. - Make your changes.
- Commit locally and push that to your repo.
- Send in a pull request based on the above.
You can also edit/commit directly to the main branch on github:
- Go to the file/directory you want to edit.
- Make your changes.
- Add a message describing your edit.
- Commit directly to the main branch / Create a new branch for this commit and start a pull request.
In either case, the page will be automatically build through GitHub Actions and uploaded to the staging or live site depending on the branch.
In order to contribute to the website’s codebase, you’ll need to know a bit about Git, Jekyll, CSS or Sass, Markdown, and some Command Line-fu. You'll also need to know how to install Ruby Gems and of course have Ruby installed on your machine.
Use the bundle command to install the necessary gems for the LaTeX Project. If you don't have bundler installed you'll need to run gem install bundler before using bundle.
$ bundle install
Trigger the local server by executing the jekyll serve task.
$ jekyll serve
Your local copy will now be accessible at http://localhost:4000. Then use CTRL + C to stop the server.
- Git Documentation
- Jekyll Documentation
- CSS Documentation
- SASS Documentation
- Markdown Documentation
- Kramdown Documentation
The latex-project.org webdesign by Jonas Jacek is licensed under a Creative Commons Attribution 4.0 International License. Based on a work at https://github.com/latex3/latex3.github.io.
This is a Free Culture License!
However, the license requires you to give appropriate credit to Jonas, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests Jonas or the LaTeX Project endorses you or your use.
Please credit Jonas with a link to his website (https://www.j15k.com/) and state the license somewhere on your page. Everything else brings bad karma.
If you think you've found a bug on our website you can report it to the website team at mailto:webmaster@latex-project.org. If you do submit a report, thanks for taking the time!