[ https://issues.apache.org/jira/browse/KAFKA-13882?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17536544#comment-17536544 ]
ASF GitHub Bot commented on KAFKA-13882: ---------------------------------------- mimaison commented on code in PR #410: URL: https://github.com/apache/kafka-site/pull/410#discussion_r872225024 ########## start-preview.sh: ########## @@ -0,0 +1,9 @@ +#!/usr/bin/env bash + +set -euxo pipefail + +docker build -t kafka-site-preview . + +docker run -dit --rm --name mypreview -p 8080:80 -v "$PWD":/usr/local/apache2/htdocs/ kafka-site-preview + +echo "You can stop the preview server by running `docker stop mypreview`" Review Comment: What about doing something like this to make it even easier to use? ```suggestion #!/usr/bin/env bash set -euo pipefail clean() { docker stop site-preview exit 0 } trap clean SIGINT docker build -t kafka-site-preview . docker run -dit --rm --name site-preview -p 8080:80 -v "$PWD":/usr/local/apache2/htdocs/ kafka-site-preview echo "The preview is available on http://localhost:8080." echo "Press CTRL+C to stop it." read -r -d '' _ </dev/tty ``` > Dockerfile for previewing website > --------------------------------- > > Key: KAFKA-13882 > URL: https://issues.apache.org/jira/browse/KAFKA-13882 > Project: Kafka > Issue Type: Task > Components: docs, website > Reporter: Tom Bentley > Assignee: Lim Qing Wei > Priority: Trivial > Labels: newbie > > Previewing changes to the website/documentation is rather difficult because > you either have to [hack with the > HTML|https://cwiki.apache.org/confluence/display/KAFKA/Contributing+Website+Documentation+Changes#ContributingWebsiteDocumentationChanges-KafkaWebsiteRepository] > or [install > httpd|https://cwiki.apache.org/confluence/display/KAFKA/Setup+Kafka+Website+on+Local+Apache+Server]. > This is a barrier to contribution. > Having a Dockerfile for previewing the Kafka website (i.e. with httpd > properly set up) would make it easier for people to contribute website/docs > changes. -- This message was sent by Atlassian Jira (v8.20.7#820007)