mnw
69d6b370b2
- Update README with gopher/phlog section, publishing commands, URLs, and first-time SDF setup instructions - Add gopher workflow documentation to execution-notes.txt - Include planning docs in docs/ directory
91 lines
1.9 KiB
Markdown
91 lines
1.9 KiB
Markdown
# marcus-web
|
|
|
|
Personal blog powered by Hugo with gopher/phlog support. Many references to I Saw The TV Glow its a fantastic movie.
|
|
|
|
## Clone
|
|
|
|
```bash
|
|
git clone ssh://git@git.sdf.org/mnw/marcus-web.git
|
|
cd marcus-web
|
|
```
|
|
|
|
## Setup
|
|
|
|
```bash
|
|
./scripts/setup.sh
|
|
source .venv/bin/activate
|
|
```
|
|
|
|
## Usage
|
|
|
|
See `scripts/execution-notes.txt` for full details, but the short version:
|
|
|
|
```bash
|
|
# Movies (Frank's Couch)
|
|
python scripts/import_letterboxd.py
|
|
|
|
# Beer Calls (Luna Juice)
|
|
python scripts/new_beercall.py
|
|
|
|
# Beer Events
|
|
python scripts/new_lunajuice.py
|
|
|
|
# Tech Posts (Fun Center)
|
|
python scripts/new_techpost.py
|
|
```
|
|
|
|
## Publishing
|
|
|
|
```bash
|
|
# Hugo site only
|
|
./scripts/remote_publish.sh
|
|
|
|
# Hugo + Gopher
|
|
./scripts/remote_publish.sh --gopher
|
|
|
|
# Gopher only
|
|
./scripts/remote_publish.sh --gopher-only
|
|
```
|
|
|
|
Hugo builds happen on SDF via git pull. Gopher content is built locally and rsynced to `~/gopher/blog/`.
|
|
|
|
## Gopher / Phlog
|
|
|
|
Posts can be published to SDF gopherspace by adding `phlog: true` to the frontmatter:
|
|
|
|
```yaml
|
|
---
|
|
title: 'My Post'
|
|
phlog: true
|
|
---
|
|
```
|
|
|
|
### First-Time Gopher Setup on SDF
|
|
|
|
Before the first gopher deploy, make sure the `blog/` directory exists on SDF:
|
|
|
|
```bash
|
|
ssh mnw@sdf.org "mkdir -p ~/gopher/blog"
|
|
```
|
|
|
|
Then run the initial deploy:
|
|
|
|
```bash
|
|
./scripts/remote_publish.sh --gopher-only
|
|
```
|
|
|
|
### Gopher URLs
|
|
|
|
| Location | URL |
|
|
|----------|-----|
|
|
| Gopher root | `gopher://sdf.org/1/users/mnw/` |
|
|
| Blog index | `gopher://sdf.org/1/users/mnw/blog/` |
|
|
| Frank's Couch | `gopher://sdf.org/1/users/mnw/blog/franks-couch/` |
|
|
| Fun Center | `gopher://sdf.org/1/users/mnw/blog/fun-center/` |
|
|
| Web proxy | [Floodgap Proxy](https://gopher.floodgap.com/gopher/gw?a=gopher://sdf.org/1/users/mnw/) |
|
|
|
|
### References
|
|
|
|
- [SDF Gopher Setup](https://wiki.sdf.org/doku.php?id=gopher_site_setup_and_hosting_features)
|
|
- [Tilde.town Gopher Guide](https://tilde.town/wiki/editing-your-homepage/gopher.html)
|