HandBrake/HandBrake-docs
1
0
Fork 0
mirror of https://github.com/HandBrake/HandBrake-docs.git synced 2025-12-10 00:44:52 -06:00
Code Issues Packages Projects Releases 1 Wiki Activity

meta: Update build instructions in Contributing.

Browse Source
This commit is contained in:
Bradley Sepos 2016-11-12 17:44:11 -05:00
parent 69c8265d36
commit 713e5dc912
1 changed files with 2 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
CONTRIBUTING.markdown
View File

@ -174,11 +174,9 @@ Every copy of the source files includes additional third-party tools needed buil
### Building
Copy the example configuration file `config-example.yaml` to `config.yaml`.
Run `build-tools` from the main directory to build all associated third-party tools.
Once the tools are built, run `build-docs` from the main directory to build the HTML documentation in the `public/docs` directory. You may now view and interact with the documentation by opening `public/docs/index.html` in your web browser.
Once the tools are built, run `marsh build` from the main directory to build the HTML documentation in the `public/docs` directory. You may now view and interact with the documentation by opening `public/docs/index.html` in your web browser.
Security restrictions in modern web browsers may prevent web fonts from displaying properly when viewing local files. One workaround is to serve the files instead of opening them directly. From the `public` directory, run `python -m http.server 8000 || python -m SimpleHTTPServer 8000` and then open `http://localhost:8000/docs/` in your web browser (requires Python).
@ -186,7 +184,7 @@ Security restrictions in modern web browsers may prevent web fonts from displayi
Before editing the documentation, first create and switch to an appropriately named local branch to track your changes (e.g. `git checkout master; git checkout -b branch-name`). This allows you to make as many changes as you like without affecting the `master` branch, and helps identify groups of changes when submitting pull requests later on.
To make a change, edit the appropriate file(s) in the `source` directory. Run `build-docs` again from the main directory to rebuild the HTML documentation in `public/docs` including your changes.
To make a change, edit the appropriate file(s) in the `source` directory. Run `marsh build` again from the main directory to rebuild the HTML documentation in `public/docs` including your changes.
### Submitting your changes