magento/devdocs

Name: devdocs

Owner: Magento

Description: Magento Developer Documentation

Created: 2014-03-10 20:54:08.0

Updated: 2018-01-14 04:33:12.0

Pushed: 2018-01-17 21:35:35.0

Homepage: http://devdocs.magento.com

Size: 454160

Language: HTML

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Magento Developer Documentation

Welcome! This site contains the latest Magento developer documentation for ongoing Magento 2.x releases.

To contribute, please fork the develop branch.

Building this site

You can build this site locally in the following ways:

• Installing the project dependencies locally (Mac, Linux)
• Using a Docker container (Mac, Linux)
• Using a Vagrant virtual machine (Mac, Linux, Windows)

Build using Jekyll

For local builds, you need to install Bundler, and Ruby version manager.

To prepare your MacOS environment:

1. Install Homebrew. See the Homebrew site for instructions.

2. Use Homebrew to install a Ruby version manager.

   ew install rbenv ruby-build
   

3. Add rbenv to bash so that it loads every time you open a terminal.

   ho 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.bash_profile
   

4. Source your .bash_profile file.

   urce ~/.bash_profile
   

5. Install a specific version of Ruby.

   env install 2.4.x
   env global 2.4.x
   by -v
   

6. Install the Bundler gem, which helps with Ruby dependencies.

   m install bundler
   

7. Run bundle install the first time you are in the devdocs directory or when you need to pick up theme changes.

To build locally:

Once you have completed preparing your environment, you can build locally and review the site in your browser.

1. Run the serve command.

   ndle exec jekyll serve --incremental
   
   iguration file: /Users/username/Github/devdocs/_config.yml
           Source: /Users/username/Github/devdocs
      Destination: /Users/username/Github/devdocs/_site
   remental build: enabled
     Generating...
                   done in x.x seconds.
   o-regeneration: enabled for '/Users/username/Github/devdocs'
   Server address: http://127.0.0.1:4000//
   rver running... press ctrl-c to stop.
   

2. Use the Server address URL http://127.0.0.1:4000/ in a browser to preview the content.

3. Press Ctrl+C in the serve terminal to stop the server.

TIP
Leave the serve terminal open and running. Every time you save changes to a file, it automatically regenerates the site so you can test the output immediately. Changing the _config.yml file requires a fresh build. Using the --incremental option limits re-builds to posts and pages that have changed.

Build using Docker

This Docker container contains everything necessary to run Jekyll3 for working with Magento DevDocs.

Build using Vagrant

You can deploy the devdocs site locally using this Vagrant project.

---

If you have questions, open an issue and ask us. We're looking forward to hearing from you!

• Follow @MagentoDevDocs

• E-mail us

• Visit our documentation site, built using GitHub pages.