如果你需要在页面中运行自定义的 Javascript 脚本,这个是需要基于 JQuery 和 Bootstrap 来进行运行的。 请确定 <script> 标记存储在页面的最后(在所有页面都被载入完成以后)。这是因为,如果你的脚本在页面之前的话,很有肯能导致你的页面在 JQuery 和 Bootstrap JS 载入完成之前运行,这会导致脚本错误。 Note: 通常来说这个是一个糟糕的决定。 https://www.ossez.com/t/javascript-javascript/726
如果你需要在页面中运行自定义的 Javascript 脚本,这个是需要基于 JQuery 和 Bootstrap 来进行运行的。 请确定 <script> 标记存储在页面的最后(在所有页面都被载入完成以后)。这是因为,如果你的脚本在页面之前的话,很有肯能导致你的页面在 JQuery 和 Bootstrap JS 载入完成之前运行,这会导致脚本错误。 Note: 通常来说这个是一个糟糕的决定。 https://www.ossez.com/t/javascript-javascript/726
字体格式将会告诉页面在 Markdown 文件的最上端,使用 3 个横线作为开始和结束。其中包括有 YAML 内容,下面为可以支持的关键字,包括有表头,描述和关键字是否是必须的。 关键字 是否必须 描述 title 是 这个字段定义的是页面的标题,将会添加到 HTML 输出中的 <h1> 级别的头部。 description 是 一个描述页面内容的例子,将会添加到 HTML 的 metadata 上面。 keywords 是 一个使用逗号分隔符的关键字列表,将会添加到 HTML 的 metadata 上面。 redirect_from 否 一个 YAML 的列表,这个将会显示链接到当前页面的的所有页面列表。在页面处理的过程中,这个地方配置的页面内容,将会为那些页面创建一个 302 重定向链接到这个页面上。 notoc 否 可以使用 true 或者 false。如果选择 true 的话, TOC 将不会在 HTML 输出的时候创建。默认的配置选项是 false。针对没有页面头部内容,将会创建相同的显示页面。 toc_min 否 如果 notoc 设置为 true 的话,这个选项将会被忽略。包括在页面 TOC 中头部,最小的页面级别为。默认配置为 2, 意思是显示页面头部最小的开始为 <h2>。 toc_max 否 如果 notoc 设置为 false 的话,这个选项将会被忽略。包括在页面 TOC 中头部,最大的页面级别为。默认配置为 3, 意思是显示页面头部最小的开始为 <h3>。如果这个设置和 toc_min 相同的话,那么只有 toc_min 的级别标题被显示。 no_ratings 否 可以使用 true 或者 false。设置是否为页面设置投票,如果设置为 true 的话,页面将不会显示投票。默认为 false。 skip_read_time 否 设置 true 的话,将不会在页面中设置页面的估计阅读时间。 sitemap 否 通知这个页面将不会被搜索引擎进行索引,当设置为 false 的时候,这个页面将会从 sitemap.xml 中进行剔除,并且在页面的头部(header)将会添加 <meta name="robots" content="noindex"/> 这个内容。 下面显示的内容是一个有效的页面 Metadata 配置(没有转换为 HTML)页面。在预页面格式中内容的顺序是没有关系的,你可以随意调整上面参数的顺序。 --- description: Instructions for installing Docker on Ubuntu keywords: requirements, apt, installation, ubuntu, install, uninstall, upgrade, update redirect_from: - /engine/installation/ubuntulinux/ - /installation/ubuntulinux/ - /engine/installation/linux/ubuntulinux/ title: Get Docker for Ubuntu toc_min: 1 toc_max: 6 skip_read_time: true no_ratings: true --- 上图显示的是一个预页面格式。 https://www.ossez.com/t/docker/724
为了在页面中使用标签页,例如测试页面中的标签页:https://docker.ossez.com/test/ 这个需要使用 HTML 文件。 标签页使用的是 Bootstrap CSS/JS,因此请参考相关的文档来获得有关标签页使用的更多有关内容和信息。针对标准的水平标签页,你可以拷贝和粘贴下面的表单内容,在上面的表单内容中关键的地方在 href="#id" 和 id="id"。 这个需要和你的标签页配置进行对应。以便于添加和删除标签页。 <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> 有关更多标签页的内容,请参考 https://docker.ossez.com/test/ 页面中的内容。 如果上图显示的标签页。 https://www.ossez.com/t/docker-tab/725
的是你将会得到 Jekyll 模板的通知。 {% such as this %} 将会被读成原始文档,而不会被处理。因此最好的办法就是访问官方 https://docs.docker.com/ 文档链接来进行阅读文档。 测试修改和实践指南 如果你希望对修改的样式表进行测试,或者你希望对 Markdown, Bootstrap, JQuery 或者其他的一些内容进行测试的话,请参考 test.md 中的内容(访问路径为 /test/)。 https://www.ossez.com/t/docker-github/723
/_data/toc.yaml 定义了文档的左侧导航 /js/docs.js 定义了文档使用的主要 JS 文本,例如 TOC 创建,菜单同步等 /css/style.scss 定义了文档使用的主要样式表规则 /_layouts/docs.html 为 HTML 的模板文件,包括定义了 header 和 footer,同时也包括了所有文档内容需要使用的 JS/CSS https://www.ossez.com/t/docker/722
启用文档的部署特性 在默认的本地构建文档中,我们禁用了一些特性来缩短文档的构建时间。在针对 docs.docker.com 网站中部署的文档和本地构建的文档有下面的一些配置不同: 使用 js/metadata.json 的自动搜索完成 google analytics 配置 页面评分配置(page ratings) 创建站点地图 sitemap.xml 样式表的压缩和小型化(css/style.css) 针对内容在其他仓库中的 “编辑页面(edit this page)” 页面的链接 如果你对上面的内容进行了修改的话,你可以在你的本地使用 “服务器(Production)” 构建。 为了能够预览针对服务器的部署环境的特性是否被启用了,你需要在对你的文档进行构建的时候设置 JEKYLL_ENV 环境变量。 JEKYLL_ENV=production docker-compose up --build 当构建完成后,请访 http://localhost:4000 地址中的内容来确定构建的正确。 如果你对文档进行了修改,并且需要重新构建的话,你需要重复上面的步骤。 https://www.ossez.com/t/docker/720
安装方法 基于你的需求,你可以使用不同的方法安装 Docker 引擎(Docker Engine): 绝大部分用户使用 设置 Docker 的仓库 ,然后从设置成功后的仓库进行安装。为了更加容易进行安装和升级任务,Docker 的官方推荐使用这种安装方式来进行安装。 一些用户可以使用下载的 RPM 包 ,然后 手动进行安装 然后你需要手动来进行升级。这种方法主要针对一些系统不具有联网环境,你需要下载后进行安装。 在一些测试和部署环境中,一些用户采用自动化脚本来安装 Docker,请访问链接: 自动化安装脚本 来了解更多。 使用仓库进行安装 在你对新安装的机器安装 Docker 之前,你需要设置 Docker 仓库。当仓库设置好以后,你可以从设置的仓库中对 Docker 进行安装和更新。 设置仓库 安装 yum-utils 包(这个安装包将会提供 yum-config-manager 工具)然后设置 稳定(stable)的仓库。 $ sudo yum install -y yum-utils $ sudo yum-config-manager \ --add-repo \ https://download.docker.com/linux/centos/docker-ce.repo 可选的:启用 晚间构建(nightly) 或 测试(test) 仓库。 上面的这些仓库包含有 docker.repo 文件,但是在默认情况下是禁用的。你可以和稳定版本仓库地址一样来启用它们。下面的内容显示的是启用 **晚间构建(nightly)**仓库的命令。 $ sudo yum-config-manager --enable docker-ce-nightly 希望启用 **测试(test)**仓库,请使用下面的命令: $ sudo yum-config-manager --enable docker-ce-test 你可以通过运行 yum-config-manager 命令,并在命令后面添加 --disable 标记来禁用 晚间构建(nightly) 或 **测试(test)**仓库。 下面的命令是表示禁用 **晚间构建(nightly)**仓库: $ sudo yum-config-manager --disable docker-ce-nightly 了解更多有关晚间构建(nightly) 和 **测试(test)**的通道。。 安装 Docker 引擎 安装最新版本的 Docker 引擎和容器,或者使用后续的步骤来为安装的指定特定的版本: $ sudo yum install docker-ce docker-ce-cli containerd.io 如果按照的时候提示需要校验 GPG Key,请确定指纹与字符串 060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35 是吻合的,然后选择接受。 获得了多个 Docker 的仓库? 如果你有多个 Docker 仓库被启用了,在使用 yum install 或 yum update 命令对 Docker 进行安装和升级的时候,如果你没有指定版本, 那么上面的命令将会尝试使用最新的版本进行安装。这有可能导致安装的版本不是你需要的。 Docker 被安装了,但是没有启动。这是因为 docker 组已经被创建了,但是还没有用户添加到组中。 针对 Docker 的安装指定版本的 Docker 引擎(Docker Engine),列出给定仓库中可用的 Docker 版本,然后选择需要的版本来进行安装: a. 分类列出你仓库中可用的 Docker 版本。下面的示例列出了通过版本好进行分类的结果,从高到低的分类: $ yum list docker-ce --showduplicates | sort -r docker-ce.x86_64 3:18.09.1-3.el7 docker-ce-stable docker-ce.x86_64 3:18.09.0-3.el7 docker-ce-stable docker-ce.x86_64 18.06.1.ce-3.el7 docker-ce-stable docker-ce.x86_64 18.06.0.ce-3.el7 docker-ce-stable 上面的列表是基于你启用的仓库不同来指定你 CentOS 操作系统的版本(如上面所示,使用 el7 后缀来标记)。 b. 通过提供完整的包的名字来安装指定的版本的 Docke 引擎。完整的路径包括有包的名字(docker-ce)并且加上第二列提供的版本字符串。 从第一个冒号(:)后的字符开始计算,截止于分隔符(-)之前的字符。 例如: docker-ce-18.09.1。 $ sudo yum install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io Docker 被安装了,但是没有启动。这是因为 docker 组已经被创建了,但是还没有用户添加到组中。 启动 Docker $ sudo systemctl start docker 通过运行 hello-world 镜像(image)来确定 Docker 安装成功了。 $ sudo docker run hello-world 这个命令将会下载一个测试镜像并且在容器中运行。如果容器是运行的话,这个命令将会打印出一些信息后退出。 Docker 引擎已经安装并且运行了,你需要使用 sudo 来运行 Docker 的命令。请继续阅读页面 Linux 安装 Docker 的后续步骤 中的内容来允许你操作系统中没有权限的用户来允许 Docker 命令和其他的一些配置选项。 升级 Docker 引擎 希望对 Docker 引擎进行申请, 请按照 使用仓库进行安装 步骤,来选择你希望安装的新版本。 操作系统上的安装结果。 所有执行的完整命令: sudo yum install -y yum-utils sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo sudo yum install docker-ce docker-ce-cli containerd.io sudo systemctl start docker sudo docker run hello-world https://www.ossez.com/t/docker-centos/717#install-using-the-repository
如果希望在 CentOS 操作系统上安装 Docker ,请确定你需要安装的操作系统 满足安装要求,然后请参考 安装 Docker 页面中的内容。 安装要求 操作系统(OS) 要求 要在 CentOS 上安装 Docker,最低的操作系统版本需要为 CentOS 7。其他的早期版本不能够获得支持。 centos-extras 仓库需要被启用。这个仓库在默认情况下是启用的,但是可能因为其他的原因被关闭了,请参考 重新启用 centos-extras 仓库 页面中的内容。 推荐使用 overlay2 存储驱动。 卸载老的版本 老的 Docker 版本可能被称为 docker 或 docker-engine。如果这些老的 Docker 版本被安装的话,请首先进行卸载,同时也请卸载关联的依赖。 $ sudo yum remove docker \ docker-client \ docker-client-latest \ docker-common \ docker-latest \ docker-latest-logrotate \ docker-logrotate \ docker-engine 如果在使用 yum 的时候,提示没有任何上面的包被安装的话,也没有关系。你可以跳过这个卸载的过程。 路径 /var/lib/docker/ 下的内容包含有 镜像(images),容器(containers),卷(volumes),网络(networks)这些内容。这些内容是 Docker 容器运行需要的必要配置。 Docker 引擎(Docker Engine)的包,当前被修改称为 docker-ce。 通过上面的提示,显示没有 package 安装。 https://www.ossez.com/t/docker-centos/716
GitHub 提交 合并请求(PR) 之前的预存(staging ) 针对提交到 master 分支的每一次合并请求,一个针对站点使用 Netlify 的预存 staging 将会被创建。 如果站点被重构创建,将会看到 deploy/netlify — Deploy preview ready** 文字。 否则的话,你将会看到一个错误信息,单击 Details 来查看暂存的站点或者阻止站点重构的错误。重新查看暂存的站点来确定是不是你提交的内容导致的错误。 在 PR 合并到 master 分支之前,其他的项目相关人员同时也会查看暂存的站点。通过这个选项,我们来保护 https://docs.docker.com 站点不会有错误。 https://www.ossez.com/t/docker-github-pr-staging/715
贡献 我们非常重视你对文档的贡献,我们也希望能够尽可能的在文档仓库中间的的工作。 在你决定对文档进行贡献的时候,你需要首先确定你希望工作的分支。如果你在这个上面有什么困惑的话,你只需要向我们提问即可,官方和我们都会尽可能的帮助你。 如果官方的开放人员或者其他人发现了你可能提交了错误的分支,将会有人提醒你的,这个时候你只需要 rebase 你的工作就可以了。 希望对 Docker 的开发贡献你自己的力量?请参考下面文档的内容:Contributing Docker 不需要在这里编辑的文件 文件或者目录列在为 .NOT_EDITED_HERE.yaml 关键字的路径被其他仓库使用的是不应该进行编辑的。 对上面字符串进行编辑后提交的 PR 请求会被驳回(rejected),请确定你编辑的仓库中的文件和路径是正确的。 文档改善计划概述 合并请求(PR)应该是针对 master 分支提出的,这个内容包括有: 不针对新特性的概念性的内容和基于任务的信息 重新格式化或者重写部分内容 文档错误的修改 拼写或者语法错误 你是否享受创建一些图形呢?好看漂亮的图形和设计是一个好文档的关键,我们尤其欢迎您在这个方面的贡献和帮助。 https://www.ossez.com/t/docker/714