在线时间:8:00-16:00
迪恩网络APP
随时随地掌握行业动态
扫描二维码
关注迪恩网络微信公众号
开源软件名称:docker-docs开源软件地址:https://gitee.com/honeymoose/docker-docs开源软件介绍:CWIKIUS Docker 文档和手册欢迎来到 CWIKIUS Docker 文档和手册的空间 本文档的编译发布版本访问地址:docker-docs.ossez.com CWIKIUS 的有关 Docker 相关文档:https://www.cwiki.us/display/DockerZH/Docker GitHub 上有关 CWIKIUS Docker 的项目的源代码文件:https://github.com/cwiki-us-docs/docker-docs 如果您有兴趣参与我们的小组和项目,请使用下面的联系方式和我们联系:
微信及公众平台我们建议您通过社区论坛来和我们进行沟通,请关注我们的微信公众号。 CWIKIUS 文档和手册快速导航有关相关文档和我们参考过的一些内容的快速导航。
欢迎来到 Docker 文档的代码仓库。本代码仓库是文档 https://docs.docker.com 的源代码。 如果你发现这个文档有任何问题,Docker 官方欢迎你来创建 合并请求(Pull Requests)。Docker 的文档是完全开源的,Docker 官方也非常感谢社区对 Docker 的贡献。 提供反馈Docker 的官方和 CWIKIUS 都非常欢迎您对我们的内容进行反馈,并且我们将这个提供反馈的方法进行了调整,以便于更好的进行访问和提交。你可以对页面进行编辑或者针对 https://docs.docker.com 上每一个页面的右上角提供的链接来对内容进行编辑和提交合并请求。 你也可以对每一个页面来进行评分,评分的链接在页面的页脚。 本仓库只针对文档的内容进行修改。 如果你考虑对文档进行修改的话,在提交 PR 之前你应该先考虑下这个问题应该是和文档相关的,比如说文档描述的不清楚,文档出现了错误,或者在文档让用户非常困惑等。
贡献我们非常重视你对文档的贡献,我们也希望能够尽可能的在文档仓库中间的的工作。 在你决定对文档进行贡献的时候,你需要首先确定你希望工作的分支。如果你在这个上面有什么困惑的话,你只需要向我们提问即可,官方和我们都会尽可能的帮助你。 如果官方的开放人员或者其他人发现了你可能提交了错误的分支,将会有人提醒你的,这个时候你只需要 rebase 你的工作就可以了。
不需要在这里编辑的文件文件或者目录列在为 关键字的路径被其他仓库使用的是不应该进行编辑的。 对上面字符串进行编辑后提交的 PR 请求会被驳回(rejected),请确定你编辑的仓库中的文件和路径是正确的。 文档改善计划概述合并请求(PR)应该是针对
GitHub 提交 合并请求(PR) 之前的预存(staging )针对提交到 如果站点被重构创建,将会看到 deploy/netlify — Deploy preview ready** 文字。 否则的话,你将会看到一个错误信息,单击 Details 来查看暂存的站点或者阻止站点重构的错误。重新查看暂存的站点来确定是不是你提交的内容导致的错误。 在 PR 合并到 master 分支之前,其他的项目相关人员同时也会查看暂存的站点。通过这个选项,我们来保护 https://docs.docker.com 站点不会有错误。 在本地构建和查看文档在你的本地计算机上,克隆这个仓库: git clone --recursive https://github.com/cwiki-us-docs/docker-docs.gitcd docker-docs 然后使用 Docker Compose 来运行和构建这个文档,Docker Compose 的访问链接为:https://docs.docker.com/compose docker-compose up -d --build
一旦容器被构建和运行了,请通过浏览器来访问 [http://localhost:4000](http://localhost:4000]地址来查看构建成功的文档页面。 当你对文档进行了新的修改后,你可以再次运行 docker-compose up 命令。这个命令将会重新构建文档,并且将你的容器进行更新。 docker-compose up -d --build 一旦容器被构建和运行了,请通过浏览器来访问 [http://localhost:4000](http://localhost:4000]地址来查看构建成功的文档页面。 如果你想停止预存(staging)的容器,请使用 docker-compose down 命令 docker-compose down 启用文档的部署特性在默认的本地构建文档中,我们禁用了一些特性来缩短文档的构建时间。在针对 docs.docker.com 网站中部署的文档和本地构建的文档有下面的一些配置不同:
如果你对上面的内容进行了修改的话,你可以在你的本地使用 "服务器(Production)" 构建。 为了能够预览针对服务器的部署环境的特性是否被启用了,你需要在对你的文档进行构建的时候设置 JEKYLL_ENV=production docker-compose up --build 当构建完成后,请访问 http://localhost:4000 地址中的内容来确定构建的正确。 如果你对文档进行了修改,并且需要重新构建的话,你需要重复上面的步骤。 重要的文件
GitHub 查看的相关链接你可以自由的链接到 测试修改和实践指南如果你希望对修改的样式表进行测试,或者你希望对 Markdown, Bootstrap, JQuery 或者其他的一些内容进行测试的话,请参考 预页面字体格式字体格式将会告诉页面在 Markdown 文件的最上端,使用 3 个横线作为开始和结束。其中包括有 YAML 内容,下面为可以支持的关键字,包括有表头,描述和关键字是否是必须的。
下面显示的内容是一个有效的页面 Metadata 配置(没有转换为 HTML)页面。在预页面格式中内容的顺序是没有关系的,你可以随意调整上面参数的顺序。 ---description: Instructions for installing Docker on Ubuntukeywords: requirements, apt, installation, ubuntu, install, uninstall, upgrade, updateredirect_from:- /engine/installation/ubuntulinux/- /installation/ubuntulinux/- /engine/installation/linux/ubuntulinux/title: Get Docker for Ubuntutoc_min: 1toc_max: 6skip_read_time: trueno_ratings: true--- 创建标签(Tab)页为了在页面中使用标签页,例如测试页面中的标签页:https://docker.ossez.com/test/,这个需要使用 HTML 文件。The use of tabs, as on pages like https://docs.docker.com/engine/api/, requires 标签页使用的是 Bootstrap CSS/JS,因此请参考相关的文档来获得有关标签页使用的更多有关内容和信息。针对标准的水平标签页,你可以拷贝和粘贴下面的表单内容,在上面的表单内容中关键的地方在 这个需要和你的标签页配置进行对应。以便于添加和删除标签页。 <ul class="nav nav-tabs"> <li class="active"><a data-toggle="tab" data-target="#tab1">TAB 1 HEADER</a></li> <li><a data-toggle="tab" data-target="#tab2">TAB 2 HEADER</a></li></ul><div class="tab-content"> <div id="tab1" class="tab-pane fade in active">TAB 1 CONTENT</div> <div id="tab2" class="tab-pane fade">TAB 2 CONTENT</div></div> 有关更多标签页的内容,请参考 运行页面中的 Javascript如果你需要在页面中运行自定义的 Javascript 脚本,这个是需要基于 JQuery 和 Bootstrap 来进行运行的。 请确定
图片不要忘记删除所有不需要的图片,将图片保存在 images/ 目录中,这个目录为通常我们保存图片的路径。 通常的,这个文件夹中的图片文件是按照图片文件名的字母进行排和分组的。例如,相对命名方式来说 你还可以添加数字,尤其你是针对图片有使用和显示顺序的情况下。例如, 在可能的情况下,对需要的内容进行截图,并且避免对整个桌面进行截图,这样避免一些重要的配置信息被泄漏也能够为编辑节约不少的编辑时间。 在 Mac 的计算机中,请对创建进行截图而且不要保存为阴影。你可以使用下面的方法进行操作:当你按下 如果你想全局进行禁用,请运行下面的脚本: $ defaults write com.apple.screencapture disable-shadow -bool TRUE$ killall SystemUIServer # restart it. 在后面,你可以通过设置 为了保持我们的 Git 仓库不至于过大,请尽量对图片进压缩。在 Mac 的计算中,你也许可以使用 https://imageoptim.com 来对图片进行压缩。 请对图片进行压缩之后,才上传图片到 Git 的仓库中。如果你在这个之前操作的话,你可能还是增加了 Git 仓库的内容,但是针对网络传输方面的内容进行了优化。 版权和许可证Copyright 2013-2020 Docker, inc, 文件的发布是基于 Apache 2.0 license 下进行发布。 中文版本的翻译和维护由 CWIKIUS 进行。我们允许在非商业的情况下自由扩散分发,并保留适当的权利。您可以对我们的作品进行演绎,但需要保留版权信息和来源。 本中文版本请参考:https://docker.ossez.com/ 页面中的编译部署内容和 https://docker-docs.ossez.com/ 基于 MD 的编译版本。 |
请发表评论