index.html
Check out this branch in a new repo directory, or use git-worktree. You
will need the original README.md
as source for the generation. For example,
if you want to create the new working tree in
Development/YouCompleteMe-website
:
$ git worktree add ../Development/YouCompleteMe-website gh-pages
Install the required Python packages. It is recommended to do this with virtualenv:
$ virtualenv -p python3 ~/Virtualenvs/ycm-website
$ source ~/Virtualenvs/ycm-website/bin/activate
(ycm-website)$ cd ../Development/YouCompleteMe-website
(ycm-website)$ pip install -r requirements.txt
Run the generator script, passing it the path to the YCM README.md
.
Continuing the example, this would be done as follows:
(ycm-website)$ ./update_from_readme.py ../../YouCompleteMe/README.md
The command prints nothing if it succeeds. Check the output with git status
(etc.) then submit a PR to the YouCompleteMe project with the generated changes.