ulovliglogning.dk/README.md

48 lines
1.7 KiB
Markdown
Raw Normal View History

2018-01-21 00:05:45 +00:00
# Jekyll site for ulovliglogning.dk
2018-01-23 00:44:22 +00:00
## To work on the code, either
2018-01-21 00:05:45 +00:00
2018-01-23 00:44:22 +00:00
### Use docker
2018-01-23 00:44:22 +00:00
You need docker-compose. Simply run
`docker-compose up` to launch the site in a docker container with livereload support.
### Or install Jekyll locally
#### Install Jekyll and Bundler gems through RubyGems
2018-01-21 22:08:25 +00:00
`gem install jekyll bundler`
2018-01-23 00:44:22 +00:00
#### Install dependencies
2018-01-21 22:08:25 +00:00
`bundle install`
2018-01-23 00:44:22 +00:00
#### Build the site local
2018-01-21 22:08:25 +00:00
`bundle exec jekyll serve`
You can now see the site at [localhost:4000](http://localhost:4000)
### Or install Jekyll localy on Windows
If using Ruby >=2.5 be sure to remove version numbers from dependency
Gemfile gems and remember to also delete Gemfile.lock compiling
Jekyll site.
You will also need to recompile the gem 'eventmachine' locally.
`gem install --platform ruby eventmachine`
2018-01-22 14:57:08 +00:00
## Deploy
If not using Docker, it's **important** that you build the site with `JEKYLL_ENV=production bundle exec jekyll build` before deploying the contents of the `_site` directory. We're doing some debugging stuff when the project is build in the development env.
### Deploy to FTP with Docker
Make sure that you have created a file in `_scripts/` called `config.sh`, (protip: just duplicate the `config-example.sh` file, and set the correct values, you should only need to change username and password.) Then you can build the site ande deploy it by running `docker-compose -f docker-compose-deploy.yml up`
2018-01-22 14:57:08 +00:00
2018-04-18 20:18:02 +00:00
This will execute a Docker container and do the following:
2018-04-22 08:36:18 +00:00
1. Build the site **but** fail if there are any Frontmatter errors
2018-04-18 20:18:02 +00:00
2. Upload the contents of the `_site/` directory to the FTP server
3. That's it…
2018-01-21 22:08:25 +00:00
## Structure
The contents of the index pages is defined in the frontmatter of the files `_pages/index-<language>.md`