Example Octopress website using GitLab Pages.
Table of Contents generated with DocToc
image: ruby:2.3 pages: script: - bundle install -j4 - bundle exec rake generate - mv public .public - mv .public/octopress public artifacts: paths: - public only: - master
To work locally with this project, you'll have to follow the steps below:
- Fork, clone or download this project
Install Octopress and its dependencies:
- Generate the website:
- Preview your project:
- Visit http://localhost:4000/octopress
- Add content
Read more at the Octopress documentation.
GitLab User or Group Pages
To use this project as your user/group website, you will need one additional
step: just rename your project to
groupname. This can be done by navigating to your
Finally, Octopress needs to be configured to be deployed in the root directory. In short:
- Run locally:
_config.ymland change the
gitlab-ci.ymlto look like:
image: ruby:2.3 pages: script: - bundle install -j4 - bundle exec rake generate artifacts: paths: - public only: - master
Commit and push your changes
When you hack locally, remember that the preview location will be at http://localhost:4000.
Follow http://octopress.org/docs/deploying/subdir/ for more details.
Did you fork this project?
If you forked this project for your own use, please go to your project's Settings and remove the forking relationship, which won't be necessary unless you want to contribute back to the upstream project.
CSS is missing! That means two things:
Either that you have wrongly set up the CSS URL in your templates, or your static generator has a configuration option that needs to be explicitly set in order to serve static assets under a relative URL.