Specifically, this chapter provides a writing syntax guide selecting knowledge for writing content of the site.
Currently, the source of the site is located at the apache/pulsar-site repo.
The Pulsar site pages are of:
|Client feature matrix||docs|
|Other pages||JSX pages|
Besides, the site serves multiple static pages generated outside the framework, including API docs, reference docs, and swagger files. You can find them under the
The most commonly used tool is
preview.sh. You can preview your local changes by:
See the previewing content guide for more details.
preview.sh script uses the Docusaurus dev server for testing, which is different from the real Apache Web Server based env that serves the site online.
To emulate the server-side logics, like
.htaccess rewrite rules, you can run:
The site repo has a set of Python scripts for generating content and syncing/updating/publishing the site.
You can read the README file of pytools for details.
This section holds common how-tos about website maintenance and troubleshooting.
How to fix search index mismatches?
The most common fix for search index mismatches is to re-index the pages. You can do so by clicking "Restart crawling" button on the crawler page. Typically, it takes about 1 or 2 hours to complete.
How to preview changes locally?
If you make any changes to the site, before submitting a pull request, you're supposed to preview the changes locally. Read the previewing content guide about instructions.
How to update reference pages?
If you're gonna to update the content, read the update reference docs guide about the sources of reference pages.
If you're gonna to debug the reference generation process, read the reference-doc-generator usage section and its source code.
How to update data-driven pages?
The following pages contain data-driven tables:
- Case studies
- Release notes
- Client feature matrix
Additionally, PMC members can generate the
team.js file as @lhotari did in https://github.com/apache/pulsar-site/pull/387.