{"id":16103302,"url":"https://github.com/ytvwld/hyde-gopher","last_synced_at":"2025-07-18T08:33:23.782Z","repository":{"id":62569905,"uuid":"260333757","full_name":"YtvwlD/hyde-gopher","owner":"YtvwlD","description":"Serve your Hyde site over Gopher","archived":false,"fork":false,"pushed_at":"2023-06-23T16:41:51.000Z","size":102,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-12T21:29:27.360Z","etag":null,"topics":["gopher","hyde","static-site-generator"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/YtvwlD.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-04-30T22:42:34.000Z","updated_at":"2023-01-11T16:10:23.000Z","dependencies_parsed_at":"2025-02-12T07:44:29.660Z","dependency_job_id":"5ad88ed0-2fc4-4890-8685-b270c6614980","html_url":"https://github.com/YtvwlD/hyde-gopher","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YtvwlD%2Fhyde-gopher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YtvwlD%2Fhyde-gopher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YtvwlD%2Fhyde-gopher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YtvwlD%2Fhyde-gopher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/YtvwlD","download_url":"https://codeload.github.com/YtvwlD/hyde-gopher/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247423496,"owners_count":20936622,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gopher","hyde","static-site-generator"],"created_at":"2024-10-09T18:56:36.345Z","updated_at":"2025-04-06T01:43:29.738Z","avatar_url":"https://github.com/YtvwlD.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hyde-gopher\n\n[![Build Status](https://travis-ci.org/YtvwlD/hyde-gopher.svg?branch=main)](https://travis-ci.org/YtvwlD/hyde-gopher)\n\nServe your [Hyde](https://hyde.github.io/) site over\n[Gopher](https://en.wikipedia.org/wiki/Gopher_(protocol)).\n(This is primarily made possible by [flask-gopher](https://github.com/michael-lazar/flask-gopher), yay.)\n\n## Installation\n\npandoc is needed to parse Markdown, so you'll need to have this installed.\n\n### Release\n\nYou can install the latest relase from PyPI by running\n\n```shell\npython3 -m pip install hyde-gopher\n```\n\n### From source\n\nIf you want to use the latest development snapshot (which may be broken),\nyou'll need to clone or download the repository and then install the package with:\n\n```shell\npython3 -m pip install .\n```\n\nIf you don't want to install anything, you can replace `hyde-gopher` with\n`python3 -m hyde_gopher.main` in the following steps.\n\n## Usage\n\n### Setup\n\nAs Gopher supports only absolute links and there's no such thing as a `Host` header,\nhyde-gopher needs to know the absolute base path of your site when generating the\nstatic site. (If you're using the built-in webserver this is currently being guessed\nfrom the bind configuration which may lead to broken links. Please use the built-in\nwebserver just for local tests and not for internet-facing deployments.)\n\nThere are also a few things you might want to configure but don't have to.\n\nTo do so, add the following lines to your `site.yaml`:\n\n```yaml\ngopher_base_url: gopher://gopher.mysite.invalid:71/~user/ # needed\ngopher_layout_root: layout_gopher # this is the default\ngopher_width: 70 # this is the default\n```\n\nIf you don't want to create your layout from scratch you can use a bundled one\n – to do so, run `hyde-gopher init`.\n\n### Serve\n\nYou can use the built-in webserver for a quick test\n – and also for pre-viewing your site while editing it.\n\nTo do so, run `hyde-gopher serve`.\n\nPer default, this will serve the site from the current working directory\nat \u003cgopher://localhost:7070/\u003e, placing generated files into `deploy_gopher/`.\n(You can change this, see `hyde-gopher -h` and `hyde-gopher serve -h` for more options.)\n\n### Generate\n\nThe primary purpose of hyde-gopher is to generate a static site (just like hyde's).\n\nTo do so, run `hyde-gopher gen`.\n\nPer default, this will generate a static version of the site from the current\nworking directory to the folder `deploy_gopher/`.\n(You can change this, see `hyde-gopher -h` and `hyde-gopher gen -h` for more options.)\n\n## Knonwn issues / TODO\n\n * links in HTML pages are not rendered as links (it works in Markdown, though)\n * images are only linked if you use a macro to render them\n * just HTML files, binaries and folders are considered\n\n## Gotchas\n\nhyde-gopher needs Python \u003e= 3.6.\n\nThe currenty stable release of hyde (0.8.9) needs Python \u003c 3.\nYou'll need to install the pre-release of hyde 0.9.0 to get this working:\n\n```shell\npython3 -m pip install git+https://github.com/hyde/hyde.git@V0.9.0\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fytvwld%2Fhyde-gopher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fytvwld%2Fhyde-gopher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fytvwld%2Fhyde-gopher/lists"}