About this documentation
Aim of the documentation
The documentation aims to help developers from getting started with OpenCms up to getting familiar with advanced development topics regarding OpenCms. Some topics are also interesting for content managers, but most of the documentation is focused on template development, content design, configuration options and user management.
Using the documentation
The documentation is mainly topic based. Each page can be your first page when reading it. And dependent on your pre-knowledge and your current question, each page can be the perfect place to start. If you get lost, links may bring you quickly to the missing information. Some pages just provide overviews on topics to help you getting the "big picture".
The documentation provides some interactive demos. Some features are best explained by seeing them in action and playing with them. The topics placed in the section "Demo" provide such demos. To use them you must read the documentation in your local OpenCms installation. It is shipped with the standard OpenCms installation.
Searching in the documentation
The documentation provides various ways to navigate:
- Site navigation: At the left-hand side of each page of the documentation you find a site navigation. It may be a good way to just browse the documentation or to search for something you cannot name exactly enough to search it directly.
- Integrated search: The OpenCms demo pages contain a site-wide search that is perfectly suitable to search inside the documentation. Use the magnifier in the right-hand side of the main navigation at the top of each page to start searching. You should restrict the results to the documentation subsite and to container pages for optimal search results.
- (Related) links: Each topic itself is richly linked. Use these links to find related topics, read more details or get a more abstract view on a topic.
- Overview topics: Overview topics provide an alternative to the site navigation. Some of these topics link also to external resources. Watch out for overview topics if you want the "big picture" of some concept, task or feature. Starting from an overview topic you can easily move on to various special topics.
Contributing to the documentation
Corrections via GitHub
You can edit the documentation source on GitHub. Click "Show GitHub edit links" to get links for each content element. The links will appear as edit symbols at the upper-right corner for each content snippet. Clicking the symbol, the GitHub edit page for the content snippet opens in a new tab.
Once you edited the content, send us a pull request for your change.
Suggestions on the OpenCms wiki
If you like to see a topic of the documentation improved or extended, or you have any hints on it. Then, the OpenCms wiki is the correct place for your suggestions. At the end of each page, you find a link to a wiki page that is dedicated only for suggestions for that documentation page.
This documentation has been developed by Alkacon Software - The OpenCms Experts. We offer standard service and support packages for OpenCms, providing an optional layer of security and convenience often required for mission critical OpenCms projects. For more information about our services, please contact us at firstname.lastname@example.org.