Google Git
Sign in
apache / kafka-site / refs/heads/minor-rmr-migration
commit1012a4a5a4da0441bcb0da8837dbfdea1d746875[log] [tgz]
authorDavid Arthur <mumrah@gmail.com>Tue Aug 06 09:33:43 2024 -0400
committerDavid Arthur <mumrah@gmail.com>Tue Aug 06 09:33:43 2024 -0400
treeaa7a918967c23c48f545df88058e81de7582b795
parent8bb9f75ea21fae47506916a2b179e179edbc86a3 [diff]
add second mention of rmr /migration
2 files changed
tree: aa7a918967c23c48f545df88058e81de7582b795
  1. 0100/
  2. 0101/
  3. 0102/
  4. 0110/
  5. 07/
  6. 08/
  7. 081/
  8. 082/
  9. 090/
  10. 10/
  11. 11/
  12. 20/
  13. 21/
  14. 22/
  15. 23/
  16. 24/
  17. 25/
  18. 26/
  19. 27/
  20. 28/
  21. 30/
  22. 31/
  23. 32/
  24. 33/
  25. 34/
  26. 35/
  27. 36/
  28. 37/
  29. 38/
  30. api-docs/
  31. css/
  32. diagrams/
  33. documentation/
  34. fonts/
  35. images/
  36. includes/
  37. js/
  38. logos/
  39. .asf.yaml
  40. .gitignore
  41. .htaccess
  42. blog.html
  43. books-and-papers.html
  44. code.html
  45. coding-guide.html
  46. committers.html
  47. contact.html
  48. contributing.html
  49. cve-list.html
  50. Dockerfile
  51. documentation.html
  52. downloads.html
  53. events.html
  54. get-started.html
  55. index.html
  56. intro.html
  57. KEYS
  58. performance.html
  59. podcasts.html
  60. powered-by.html
  61. project-security.html
  62. project.html
  63. protocol.html
  64. quickstart.html
  65. README.md
  66. start-preview.sh
  67. trademark.html
  68. uses.html
  69. videos.html
README.md

How to preview documentation changes locally?

The documentation can be hosted on a local webserver via httpd.

You can run it with the following command, note that it requires docker:

./start-preview.sh

Then you can open localhost:8080 on your browser and browse the documentation.

To kill the process, just type ctrl + c.

How to preview the latest documentation changes in Kafka repository?

  1. Generating document from kafka repository:
# change directory into kafka repository
cd KAFKA_REPO
./gradlew clean siteDocTar
# supposing built with scala 2.13
tar zxvf core/build/distributions/kafka_2.13-$(./gradlew properties | grep version: | awk '{print $NF}' | head -n 1)-site-docs.tgz
  1. Copying the generated documents from Kafka repository into kafka-site, and preview them (note that it requires docker):
# change directory into kafka-site repository
cd KAFKA_SITE_REPO
# copy the generated documents into dev folder
rm -rf dev
mkdir dev
cp -r KAFKA_REPO/site-docs/* dev
# preview it
./start-preview.sh

Then you can open http://localhost:8080/dev/documentation/ on your browser and browse the generated documentation.