[
https://issues.apache.org/jira/browse/FLINK-33680?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17791414#comment-17791414
]
wangshiheng edited comment on FLINK-33680 at 11/30/23 4:00 AM:
---------------------------------------------------------------
Thank you for your reply. I checked my execution record and found that I had
executed the `git submodule update --init --recursive` command, but I ignored
the alarm and executed it successfully in the root directory.
I plan to optimize the documentation description to make it more detailed, so
as to avoid the same problem in the future.
{panel}
[root@bigdatadev docs]# git clone
[https://github.com/apache/flink.git|https://github.com/section9-lab/flink.git]
[root@bigdatadev docs]# cd flink/docs/
[root@bigdatadev docs]# git submodule update --init --recursive
You need to run this command from the toplevel of the working tree.
[root@bigdatadev docs]# ./setup_docs.sh
...
{panel}
was (Author: JIRAUSER303015):
Yes, I executed it and it still failed,
You can also try to rebuild it in a new local environment.
Here is my command execution record:
{panel}
575 git clone [https://github.com/section9-lab/flink.git]
576 cd flink/docs/
577 vim README.md
578 git submodule update --init --recursive
579 vim README.md
580 ./setup_docs.sh
581 vim README.md
582 docker pull jakejarvis/hugo-extended:latest
583 vim README.md
584 docker run -v $(pwd):/src -p 1313:1313 jakejarvis/hugo-extended:latest
server --buildDrafts --buildFuture --bind 0.0.0.0
585 cat content/_index.md
{panel}
[~mapohl]
> Failed to build document with docker
> ------------------------------------
>
> Key: FLINK-33680
> URL: https://issues.apache.org/jira/browse/FLINK-33680
> Project: Flink
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 1.19.0
> Reporter: wangshiheng
> Priority: Major
> Labels: doc-site, docement
>
> Follow the documentation, the documentation comes from
> [https://github.com/apache/flink/blob/master/docs/README.md]
>
> The implementation results are as follows:
> {code:java}
> [root@bigdatadev workpace]# git clone https://github.com/apache/flink.git
> ...
> [root@bigdatadev workpace]# cd flink/docs/
> [root@bigdatadev docs]# ./setup_docs.sh
> [root@bigdatadev docs]# docker pull jakejarvis/hugo-extended:latest
> latest: Pulling from jakejarvis/hugo-extended
> Digest:
> sha256:f659daa3b52693d8f6fc380e4fc5d0d3faf5b9c25ef260244ff67625c59c45a7
> Status: Image is up to date for jakejarvis/hugo-extended:latest
> docker.io/jakejarvis/hugo-extended:latest
> [root@bigdatadev docs]# docker run -v $(pwd):/src -p 1313:1313
> jakejarvis/hugo-extended:latest server --buildDrafts --buildFuture --bind
> 0.0.0.0
> Start building sites …
> hugo v0.113.0-085c1b3d614e23d218ebf9daad909deaa2390c9a+extended linux/amd64
> BuildDate=2023-06-05T15:04:51Z VendorInfo=docker
> Built in 515 ms
> Error: error building site: assemble: "/src/content/_index.md:36:1": failed
> to extract shortcode: template for shortcode "columns" not found
> {code}
>
> [root@bigdatadev docs]# vim content/_index.md
> {panel}
> 30 # Apache Flink Documentation
> 31
> 32 {{< center >}}
> 33 *{*}Apache Flink{*}* is a framework and distributed processing engine for
> stateful computations over *unbounded* and *bounded* data streams. Flink has
> been designed to run in {*}all common cluster en vironments{*}, perform
> computations at *in-memory* speed and at {*}any scale{*}.
> 34 {{< /center >}}
> 35
> {color:#de350b} 36 \{{< columns >}}{color}
> 37
> 38 ### Try Flink
> 39
> 40 If you’re interested in playing around with Flink, try one of our
> tutorials:
> 41
> 42 * [Fraud Detection with the DataStream API]({{{}< ref
> "docs/try-flink/datastream" >{}}})
> {panel}
>
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
