Google Git
Sign in
apache / kafka-site / de82c8faa60039fdecb57915ed9543d84c2409b1
commitde82c8faa60039fdecb57915ed9543d84c2409b1[log] [tgz]
authorMickael Maison <mimaison@users.noreply.github.com>Thu Sep 04 11:52:02 2025 +0200
committerGitHub <noreply@github.com>Thu Sep 04 11:52:02 2025 +0200
tree29b424f39902720d49e11e9ebe1f3eaf6424e5c2
parent7021dd2a9633017f288f71a320f2d6c2fd112aab [diff]
MINOR: Fix broken link in 4.1.0 blog post (#720)
1 file changed
tree: 29b424f39902720d49e11e9ebe1f3eaf6424e5c2
  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. 41/
  33. api-docs/
  34. css/
  35. diagrams/
  36. documentation/
  37. fonts/
  38. images/
  39. includes/
  40. js/
  41. logos/
  42. .asf.yaml
  43. .gitignore
  44. .htaccess
  45. blog.html
  46. books-and-papers.html
  47. code.html
  48. coding-guide.html
  49. committers.html
  50. contact.html
  51. contributing.html
  52. cve-list.html
  53. Dockerfile
  54. documentation.html
  55. downloads.html
  56. events.html
  57. get-started.html
  58. index.html
  59. intro.html
  60. KEYS
  61. performance.html
  62. podcasts.html
  63. powered-by.html
  64. project-security.html
  65. project.html
  66. protocol.html
  67. quickstart.html
  68. README.md
  69. start-preview.sh
  70. trademark.html
  71. uses.html
  72. 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.