Elastic stack产品相关的文档是由专门的文档团队维护的，内容详实、更新及时，几乎能够通过查找文档的方式解决大部分平时使用上的问题，如此优秀的文档，可以被认为是业内的标杆。我的日常工作中，就需要非常频繁的访问官方文档。
国内访问的Elastic官网的障碍
然而，故事总有另外一面，虽然频率不是特别高，但仍然有不少客户或者用户会向我询问或者要求提供离线的官方文档。特别是对于一些网络受限的用户来说，访问部署在https://www.elastic.co/guide/index.html上的官方文档是一件非常痛苦，甚至是无法办到的事情。比如金融行业里的IT运维的同学，就常年处于网络受限的环境，不仅是访问国外网站走单独的低带宽、高延迟的通道，并且很多总所周知的网址是无法访问的。而偏偏elastic的官网，却有非常多的外部链接：
这些外部链接中，一旦有那么几个是访问缓慢或者无法访问的。就会造成整个页面无法正确渲染或者打开。这就使用离线访问官方文档成了一项能被理解并且应被满足的需求。
我们曾经探讨过将官方文档部署在腾讯云或者阿里云上的可能，但因为产品发布和文档更新频率，以及其他的一些阻碍，至今没能完成这一目标。
因此，我们将在本文中讨论自己构建一个特定版本的离线官方文档的方法。
构建一个特定版本的离线官方文档
作为最成功的开源项目的上市公司的工程团队，我们也有一套完整且优秀的工具和流程来自动发布产品的文档。并且，这个项目是以public的方式开放于github的：
- https://github.com/elastic/docs
- https://github.com/elastic/built-docs
这里我提供了两个github的地址，第一个（/elastic/docs）是我们修改、更新内容和构建文档的工具，而第二个（/elastic/built-docs）是构建出来的内容存放的仓库。
构建自发布的官方文档
对于需要自己更改文档内容的团队来说，可以使用第一个github仓库。
git clone https://github.com/elastic/docs
然后按照HowTo里的教程进行构建和发布。
比如说，腾讯云的elasticsearch service的团队，可以将自己的内核改动、插件、高级功能的特性变成整体文档的一部分放到elasticsearch的文档当中，就可以采用/elastic/docs里描述的方式进行文档的更新、修改和生成。再讲生成好的HTML 文档进行发布即可。
获取已发布的离线官方文档
而对于我们其他的用户来说，大部分的需求以获取一份离线文档为主，则不需要这么麻烦。我们需要的是把第二个仓库保存到本地：
git clone https://github.com/elastic/built-docs
这里的内容是通过运行docs 构建生成的，包含了产品的历史版本的文档。因此，如果要整个项目clone下来，体积是很庞大的（有10多个GB）。
仓库的目录结构如下：
如果我们要下载特定版本的elasticsearch的文档，一路导航即可。
然后通过svn等工具，只下载特定目录下的内容。这时，下载下来的文档中会包含一些外部链接，比如，我们看这个文档，https://github.com/elastic/built-docs/blob/master/html/en/elasticsearch/reference/7.10/_actions.html
就包含了：
- <linkrel=“stylesheet” type=“text/css” href=“/guide/static/styles.css” />
- <spanclass=“breadcrumb-link”><ahref=“/guide/”>Elastic Docs<spanclass=“chevron-right”>›
- <scriptsrc=“/guide/static/jquery.js”>
- <scripttype=“text/javascript” src=“/guide/static/docs.js”>
而目录/guide, 却并不包含在你下载的离线文档包了。因为这里的相对路径，都是按照elastic.co官网上的部署目录来进行配置的。
因此，为了能在离线文档中也能够正确的加载对应的资源，渲染出页面，我们还需要下载另外一个目录(https://github.com/elastic/built-docs/tree/master/html/static) 里的内容：
然后在所有的文档中，将/guide替换为你保存static 的位置（path_to_your_static）
使用同样的方法，我们可以获取所有产品文档的离线内容：
比如，我们下载了以下内容：文章来源：https://www.toymoban.com/news/detail-424477.html
tree -L 1
.
├── elasticsearch_7.10
├── hadoop_7.10
├── index.html
├── kibana_7.10
├── ml_7.10
└── static
可以构建这样的一个Index.html来访问：文章来源地址https://www.toymoban.com/news/detail-424477.html
<!DOCTYPE html>
<html lang="en-us">
<head>
<meta charset="UTF-8">
<title>Elastic Stack and Product Documentation | Elastic</title>
<meta name="DC.type" content="Learn/Docs/"/>
<meta name="DC.subject" content=""/>
<meta name="DC.identifier" content=""/>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<到了这里，关于Elasticsearch进阶教程：生成离线官方文档的文章就介绍完了。如果您还想了解更多内容，请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章，希望大家以后多多支持TOY模板网！
