Home Verkennen Help
Inloggen
apache
/
zookeeper
spiegel van https://gitee.com/apache/zookeeper.git
2
0
Vork 0
Bestanden Issues 0 Wiki

Geen omschrijving

Aftakking: website
Aftakkingen Labels
zookeeper
ZIP TAR.GZ
Andor Molnar 0cd6648d08 Updated website content for CVE-2024-51504 1 jaar geleden
_released_docs 6b70d29d68 Updated website content for release 3.9.3. 1 jaar geleden
src 0cd6648d08 Updated website content for CVE-2024-51504 1 jaar geleden
.gitignore a0fb79f811 ZOOKEEPER-3184: Use the same method to generate website as documentation 7 jaren geleden
LICENSE.md a0fb79f811 ZOOKEEPER-3184: Use the same method to generate website as documentation 7 jaren geleden
NOTICE.md b3ec907225 ZOOKEEPER-3765: Use https everywhere possible 5 jaren geleden
README.md b3ec907225 ZOOKEEPER-3765: Use https everywhere possible 5 jaren geleden
pom.xml 97d78e7256 set a version for spotbugs 5 jaren geleden

README.md

Generating the static Apache ZooKeeper website

In the src/main/resources/markdown directory you will find text files formatted using Markdown, with an .md suffix.

Building the site requires Maven 3.5.0 or newer. The easiest way to install Maven depends on your OS. The build process will create a directory called target/html containing index.html as well as the rest of the compiled directories and files. target should not be committed to git as it is generated content.

You can generate the static ZooKeeper website by running:

  1. mvn clean install in this directory.
  2. cp -RP _released_docs target/html/doc - this will include the documentation (see "sub-dir" section below) in the generated site.

At this point the contents of target are "staged" and can be reviewed prior to updating the ZooKeeper production website.

Docs sub-dir

The product documentation creation is not part of the website generation process. They are built separately for each release of ZooKeeper from the ZooKeeper source repository.

Typically during a release the versioned documentation will be recreated and should be copied, and committed, under the _released_docs directory here.

Steps to update the website

  1. git clone -b website https://gitbox.apache.org/repos/asf/zookeeper.git
  2. update the appropriate pages, typically a markdown file e.g. credits.md, etc...
  3. mvn clean install
  4. cp -RP _released_docs target/html/doc These are the static release docs, not generated in this process.

At this point verify that the generated files render properly (open target/html/index.html in a browser). If you are happy with the results move on to the next step, otherwise go to step 2 above.

  1. git status should show modified files for the markdown that you changed
  2. git add <the changed files>
  3. git commit -m "<appropriate commit message>"
  4. git push origin website

The source for the site is committed, now we need to push the generated files to the live site.

  1. git checkout asf-site
  2. rm -fr content
  3. mv target/html content
  4. git add content

Verify that content/index.html and other generated files are proper, e.g. open them in a browser

  1. git status should show modified files for the markdown that you changed
  2. git commit -m "<appropriate commit message>"
  3. git push origin asf-site