a gopher server for Hyde sites
Project description
hyde-gopher
Serve your Hyde site over Gopher. (This is primarily made possible by flask-gopher, yay.)
Installation
Release
You can install the latest relase from PyPI by running
python3 -m pip install hyde-gopher
From source
If you want to use the latest development snapshot (which may be broken), you'll need to clone or download the repository and then install the package with:
python3 -m pip install .
If you don't want to install anything, you can replace hyde-gopher
with
python3 -m hyde_gopher.main
in the following steps.
Usage
Setup
As Gopher supports only absolute links and there's no such thing as a Host
header,
hyde-gopher needs to know the absolute base path of your site when generating the
static site. (If you're using the built-in webserver this is currently being guessed
from the bind configuration which may lead to broken links. Please use the built-in
webserver just for local tests and not for internet-facing deployments.)
There are also a few things you might want to configure but don't have to.
To do so, add the following lines to your site.yaml
:
gopher_base_url: gopher://gopher.mysite.invalid:71/~user/ # needed
gopher_layout_root: layout_gopher # this is the default
gopher_width: 70 # this is the default
If you don't want to create your layout from scratch you can use a bundled one
– to do so, run hyde-gopher init
.
Serve
You can use the built-in webserver for a quick test – and also for pre-viewing your site while editing it.
To do so, run hyde-gopher serve
.
Per default, this will serve the site from the current working directory
at gopher://localhost:7070/, placing generated files into deploy_gopher/
.
(You can change this, see hyde-gopher -h
and hyde-gopher serve -h
for more options.)
Generate
The primary purpose of hyde-gopher is to generate a static site (just like hyde's).
To do so, run hyde-gopher gen
.
Per default, this will generate a static version of the site from the current
working directory to the folder deploy_gopher/
.
(You can change this, see hyde-gopher -h
and hyde-gopher gen -h
for more options.)
Knonwn issues / TODO
- links in pages are not rendered as links
- images are only linked if you use a macro to render them
- just HTML files, binaries and folders are considered
Gotchas
hyde-gopher needs Python >= 3.6.
The currenty stable release of hyde (0.8.9) needs Python < 3. You'll need to install the pre-release of hyde 0.9.0 to get this working:
python3 -m pip install git+https://github.com/hyde/hyde.git@V0.9.0
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for hyde_gopher-0.2.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 164a78d192b1922aeaed5e5a77d8ac946e9e7944ec0518fb74a3480dfebfc6f3 |
|
MD5 | cb0e1957f59f79bf1f17f320f244a6e7 |
|
BLAKE2b-256 | e7a09e42e9e797574696f88bcbd6ae48f1cb3fbec3439de5484f232f53ff651d |