Google Git
Sign in
apache / kafka-site / refs/heads/minor-fix-matomo-url
commitc0a9bb1c7e749229f619ce11921aff98d384f76a[log] [tgz]
authorDavid Arthur <mumrah@gmail.com>Tue Feb 25 11:47:47 2025 -0500
committerDavid Arthur <mumrah@gmail.com>Tue Feb 25 11:47:47 2025 -0500
treeea3e7762cf3fbd0b8fbeaf2cd362c525d66bab6c
parentfc52e3a6def4fd0bd480420c7acffd3f926de8a1 [diff]
fix the url
1 file changed
tree: ea3e7762cf3fbd0b8fbeaf2cd362c525d66bab6c
  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. 39/
  31. 40/
  32. api-docs/
  33. css/
  34. diagrams/
  35. documentation/
  36. fonts/
  37. images/
  38. includes/
  39. js/
  40. logos/
  41. .asf.yaml
  42. .gitignore
  43. .htaccess
  44. blog.html
  45. books-and-papers.html
  46. code.html
  47. coding-guide.html
  48. committers.html
  49. contact.html
  50. contributing.html
  51. cve-list.html
  52. Dockerfile
  53. documentation.html
  54. downloads.html
  55. events.html
  56. get-started.html
  57. index.html
  58. intro.html
  59. KEYS
  60. performance.html
  61. podcasts.html
  62. powered-by.html
  63. project-security.html
  64. project.html
  65. protocol.html
  66. quickstart.html
  67. README.md
  68. start-preview.sh
  69. trademark.html
  70. uses.html
  71. 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.