blob: 9b33f26a4cb05c21bf9b521661be5f728b8bf23b [file] [log] [blame]
[[HowdoIeditthewebsite-HowdoIeditthewebsite]]
= How do I edit the website?
There are two ways to edit the website:
* Directly on the GitHub website
* In local repositories
NOTE: All contributions are licensed under the http://www.apache.org/licenses/LICENSE-2.0[Apache Software License version 2.0]
== Directly on the GitHub website
The website pages can be edited on the GitHub website. It's a very quick process and ideal for fixing typos or updating information.
Steps to edit a file:
. Go to the page you want to edit.
. Look for a link called "Edit this Page" and click on it.
. Edit the file.
. Preview your changes.
. Provide a title and description for your pull request.
. Click on the "Propose file change" button.
== In local repositories
To edit files locally, it's important to understand how the website is generated and where the files are located. The https://github.com/apache/camel-website[site generator] is located in its own repository. The documentation is located in the main https://github.com/apache/camel[Apache Camel] repository and sub-project repositories, such as https://github.com/apache/camel-k[Camel-K] and https://github.com/apache/camel-quarkus[Camel Quarkus]. Have a look at the xref:faq/how-does-the-website-work.adoc[How does the website work?] page for more details.
Steps to edit a file:
. Fork and clone the https://github.com/apache/camel-website[site generator repository] and the Camel repository that contains the documentation you want to change.
. Follow the build instructions located in the site generator's https://github.com/apache/camel-website/blob/master/README.md[README file].
. Open Antora's https://github.com/apache/camel-website/blob/master/site.yml[`site.yml`] configuration file and change the content sources to https://docs.antora.org/antora/2.1/playbook/configure-content-sources/#local-urls[local repositories].
. Edit the file.
. Build the website.
. Preview your changes locally.
. Revert changes to `site.yml`.
. Push your changes to your forked repositories and send a pull request.
NOTE: It's a good idea to spend some time and learn how https://antora.org[Antora] and https://gohugo.io/[Hugo] work.