https://github.com/pyconuk/2025.pyconuk.org
PyCon UK 2025 website
https://github.com/pyconuk/2025.pyconuk.org
Last synced: 15 days ago
JSON representation
PyCon UK 2025 website
- Host: GitHub
- URL: https://github.com/pyconuk/2025.pyconuk.org
- Owner: PyconUK
- Created: 2024-11-06T14:23:10.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-02T20:35:36.000Z (about 1 year ago)
- Last Synced: 2025-03-02T21:28:29.932Z (about 1 year ago)
- Language: HTML
- Size: 9.63 MB
- Stars: 0
- Watchers: 4
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 202x.pyconuk.org
PyCon UK 202x website
If you're starting with this base, you'll need to update the dates, etc in the `_config.yml` to reflect those for the current year.
You probably only need to care about the stuff that is called con_.
You'll also need to put appropriate links everywhere you find "There will be a link".
Also, don't forget to update the 'Schedule' link in the header when the schedule is available.
## Building Locally
### Installing Jekyll
This site is made using [Jekyll](https://jekyllrb.com).
Jekyll is a static site generator written in ruby.
To build the project we first need to check that we have Jekyll's requirements installed.
These are:
* [Ruby](https://www.ruby-lang.org/en/downloads/) (tested with Ruby 3.0.2- you will also need the development headers)
* [RubyGems](https://rubygems.org/pages/download)
* [GCC](https://gcc.gnu.org/install/)
* [Make](https://www.gnu.org/software/make/)
On Ubuntu 22.04 this can be achieved by: sudo apt-get install -y ruby ruby-dev gcc make build-essential
You can check if you have these installed by typing ` -v` in your terminal.
If the program is available on your system then you should see the version of the program that is installed outputted in your terminal.
For example if Ruby in installed and you run `ruby -v`, you should get output like this `ruby 3.0.2p107 (2021-07-07 revision 0db68f0233) [x86_64-linux-gnu]`.
If RubyGems is not installed an you run `gem -v` you should get an error like this `bash: gem: command not found`
See the [Jekyll documentation](https://jekyllrb.com/docs/installation/) for more information on install Jekyll and its requirements.
Now that you have all of Jekyll's requirements installed you can install and run Jekyll:
```bash
./run
```
This will start a webserver on [http://127.0.0.1:4020/](http://127.0.0.1:4020/).
To view the website open [http://127.0.0.1:4020/](http://127.0.0.1:4020/) in your favorite web browser.
This will also automatically rebuild the project when a change to the source is detected.
If you change the `_config.yml`, you will need to restart.
If port 4020 is not available on your computer, you can run on another port with `--port `, e.g. `./run --port 4090`
You can disable livereload with `--nolivereload`, and not show future blog posts (the default after deployment, see below) with `--nofuture`.
If you need to check options, run `./run --help` to see available flags/etc which you can then pass directly to `./run`.
### Adding blog posts
Blog posts live in `src/_posts`. Each post is a file with a name of the form
`2025-01-30-.md`; for example `2025-01-30-new-year-new-pycon.md`.
**Note a post with a date in the future will not automatically get deployed
when the main branch is updated. A manual deployment run will be required on or
after the post date.**