mirror of
https://github.com/honeymoose/OpenSearch.git
synced 2025-03-25 17:38:44 +00:00
[DOCS] Update doc build info in README
Original commit: elastic/x-pack-elasticsearch@c93986436c
This commit is contained in:
parent
1e7f61b4c8
commit
fe0c5cd3dc
@ -97,36 +97,24 @@ gradle clean install
|
|||||||
|
|
||||||
= Building documentation
|
= Building documentation
|
||||||
|
|
||||||
From version 5.5 onward, the source files in this repository can be included in either the X-Pack Reference or the Elasticsearch Reference.
|
The source files in this repository can be included in either the X-Pack Reference or the Elasticsearch Reference.
|
||||||
|
|
||||||
To build the X-Pack Reference (5.4 and later) on your local machine:
|
NOTE: In 5.5 and later, the Elasticsearch Reference includes X-Pack-specific content when it is built from this repo.
|
||||||
|
|
||||||
* Use the `index.asciidoc` file in the x-pack/docs/en repository.
|
To build the Elasticsearch Reference on your local machine:
|
||||||
* Specify the locations of the `x-pack-kibana/docs` and
|
|
||||||
`elasticsearch-extra/x-pack-exlasticsearch/docs` directories with
|
* Use the `index.asciidoc` file in the docs/en directory.
|
||||||
the `--resource` option when you run `build_docs.pl`.
|
* Specify the location of the `elasticsearch/docs` directory with the `--resource` option when you run `build_docs.pl`.
|
||||||
|
|
||||||
For example:
|
For example:
|
||||||
|
|
||||||
[source, txt]
|
[source, txt]
|
||||||
-----
|
-----
|
||||||
docs/build_docs.pl --doc x-pack/docs/en/index.asciidoc
|
./docs/build_docs.pl --doc elasticsearch-extra/x-pack-elasticsearch/docs/en/index.asciidoc
|
||||||
--resource=x-pack-kibana/docs/ --resource=elasticsearch-extra/x-pack-elasticsearch/docs/
|
--resource=elasticsearch/docs --chunk 1
|
||||||
-----
|
-----
|
||||||
|
|
||||||
To build the Elasticsearch Reference (5.5 and later) on your local machine and include the X-Pack content:
|
For information about building the X-Pack Reference, see the README in the x-pack repo.
|
||||||
|
|
||||||
* Use the `index-all.asciidoc` file in the elasticsearch/docs/reference repository.
|
|
||||||
* Specify the location of the `elasticsearch-extra/x-pack-exlasticsearch/docs` directory with
|
|
||||||
the `--resource` option when you run `build_docs.pl`.
|
|
||||||
|
|
||||||
For example:
|
|
||||||
|
|
||||||
[source, txt]
|
|
||||||
-----
|
|
||||||
docs/build_docs.pl --doc elasticsearch/docs/reference/index-all.asciidoc
|
|
||||||
--resource=elasticsearch-extra/x-pack-elasticsearch/docs/
|
|
||||||
-----
|
|
||||||
|
|
||||||
== Adding Images
|
== Adding Images
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user