1 Star 1 Fork 0

Haiwera / magento-devdocs

Create your Gitee Account
Explore and code with more than 8 million developers,Free private repositories !:)
Sign up
This repository doesn't specify license. Please pay attention to the specific project description and its upstream code dependency when using it.
Clone or Download
Cancel
Notice: Creating folder will generate an empty file .keep, because not support in Git
Loading...
README.md

Magento 中文文档

欢迎使用Magento中文文档,由于此文档使用Jekyll在github上编译会出现超时问题,故本文档每周五从master由笔者本地编译到gh-pages分支。请不要直接在gh-pages分支上进行翻译。本仓库起于magento/devdocs ddec2e4af6d,最后更新日期为2018年5月27. 英文文档请参考Magento Devdocs

为了减小本仓库大小以方便贡献者克隆,本文档所有图片、PDF、zip文件引用Magento Devdocs原网站内容,在_config.yml中定义了变量magentourl,笔者已悉数修改,若有遗漏,欢迎参与修改。

站点环境构建

你可以使用下面的方式在本地构建文档站点:

使用Jekyll构建

为了保证能在本地进行构建,你须要安装Ruby 2.4或更新。

要检查您的系统的Ruby版本,可以在终端执行

$ ruby -v

安装最新版的Ruby (如果您的Ruby版本小于2.4)

MacOS 用户

  1. 安装 Homebrew. 安装指令请参考Homebrew site.

  2. 使用homebrew安装最新版的Ruby:

    $ brew install ruby

Unix, Windows或其它系统的用户

请参考Ruby site安装.

安装Bundler

安装Bundler gem,用于解决Ruby依赖:

$ gem install bundler

一但你完成上述步骤,你便可以在本地构建并使用浏览器来查看你的文档站点了。

安装devdocs

克隆或下载本仓库,完成后首先你会进到devdocs目录,执行

$ bundle install

本地构建:

使用rake

rake是一个本地的Ruby工具,用于自动化任务。

1.使用rake请求所有依赖并启动Jekyll服务:

$ rake preview
  1. Ctrl+C终止命令.

如果rake在你的环境出现错误,请using jekyll

使用Jekyll

  1. 首先来到devdocs目录,当你要应用你的Gemfile.lock改变时(比如,主题改变)请使用下面的命令来重新解决依赖.

    $ bundle install
  2. 生成本地预览

    $ bundle exec jekyll serve --incremental
     
     Configuration file: /Users/username/Github/devdocs/_config.yml
                 Source: /Users/username/Github/devdocs
            Destination: /Users/username/Github/devdocs/_site
      Incremental build: enabled
           Generating...
                         done in x.x seconds.
      Auto-regeneration: enabled for '/Users/username/Github/devdocs'
         Server address: http://127.0.0.1:4000//
       Server running... press ctrl-c to stop.
  3. 使用 服务器地址 http://127.0.0.1:4000/在浏览器查看站点

  4. Ctrl+C终止命令

小提示
离开服务终端打开并执行,每当你保存某个文件的修改,它将自动重成重新生成站点,因此你可以立即测试输出的内容。修改_config.yml文件必须要重新构建。使用--incremental选项将限制重新构建修改的页面

本地最小化构建时间

  1. 在项目跟目录创建一个_config.local.yml文件,排除所有你不须要的版本

下面的例子将只生成Magento2.2的文档

 exclude:
  - community/
  - swagger/
  - vagrant/
  - guides/m1x/
  - guides/v2.0/
  - guides/v2.1/
 # - guides/v2.2/
  - guides/v2.3/
 
 # Excluded in config.yml
  - scss/
  - bin/
  - node_modules/
  - vendor/
  - .*
  - Rakefile
  1. 执行预览命令

    $ rake preview

    此命令将:

    • 根据Gemfile.lock检查你的环境所需的依赖:
    • 删除包含了之前生成结果的_site/目录
    • 生成新的预览并在浏览器打开

如果在你的devdocs/目录下没有_config.local.yml文件,rank将为所有版本生成文档

使用docker构建

本仓库已经有了docker必要的用于构建Devdocs的配置文件,参考Docker, 使用Docker Compose.

要使用docker和docker compose,首先要下载并安装与你的系统相应的docker,然后安装docker composer来执行docker-composer.yml配置文件

Mac下使用Docker

  • 参考 这里,了解官方的安装命令.

Docker for Windows

  • 参考 这里,了解官方的安装命令.

Docker Compose

  • 参考 这里,了解官方的安装命令.

执行步骤

  1. 使用 git, clone本仓库.
  2. 定位到你的安装目录
  3. 执行 docker-compose up来初始化构建过程. 参考 这里,了解更多docker-compose的细节.
  4. 在浏览器访问http://localhost:4000/, 你可以看到一个本地的devdocs文档. 你可以在docker-compose.yml文件中找到你默认配置的端口 (默认情况下是4000).如果你要使用其它端口, 请参考这里,了解Docker composer端口映射的特性及细节。

docker构建的问题定位

  1. 验证你的系统的docker引擎是否安装
  2. 验证docker composer是否安装
  3. 验证仓库是否克隆正确
  4. 验证你是否在docker-composer.yml相同的目录下执行了正确的docker compose命令
  5. 如果还有问题,请在此向我们提交你的问题

使用Vagrant构建

你可以在本地使用this Vagrant project部署devdocs站点


如果你遇到任何问题,请向我们提交你的问题,我们将密切关注

支持

Repository Comments ( 0 )

Sign in to post a comment

About

Magento2 中文文档 expand collapse
Cancel

Releases

No release

Contributors

All

Activities

Load More
can not load any more
1
https://git.oschina.net/Haiwera/magento-devdocs.git
git@git.oschina.net:Haiwera/magento-devdocs.git
Haiwera
magento-devdocs
magento-devdocs
master

Search

184635 d8eb8a04 1850385 161156 f1cf3f24 1850385