update README

This commit is contained in:
stev 2023-09-09 14:08:04 +02:00
parent 99288c294a
commit e364217734

View file

@ -3,8 +3,19 @@
This tool was made so I could write my content only in `gmi` and publish both a
gemini capsule and a website.
For now, this is very rudimentary and things are bound to change, especially the way
I structure the directory where my content lives.
For now, this is very rudimentary and things are bound to change... and break from
version to version.
## Features
- generates HTML from gemtext
- can synchronise your files with your server using rsync
## Notes on usage
Good practice for gemini dictates that we don't use multiple `h1` titles in one page
and for that reason, the last (and therefore the first) `h1` title encountered will
be used as the title of the HTML page.
## TODO
@ -23,12 +34,14 @@ I structure the directory where my content lives.
- [ ] move config file to `~/.config` with placeholder values
- [X] check for a config file in `~/.config`
- [ ] maybe save the old Bash script somewhere for posterity ?
- [ ] reorganise the directory where the content is
## My setup
My current folder structure for my capsule+website looks something like this:
```
my-internet
myinternet
├── assets
│ ├── favicon.ico
│ └── style.css
@ -37,9 +50,20 @@ my-internet
│ │ └── index.gmi
│ ├── index.gmi
│ └── projects.gmi
├── footer.gmi
├── html-output
└── html-parts
├── footer-part.html
└── header-part.html
├── gmi-helper
│ └── footer.gmi
├── html-helper
│ ├── footer-part.html
│ └── header-part.html
├── README.md
└── web
├── favicon.ico
├── gemlog
│ └── index.html
├── index.html
├── projects.html
└── style.css
```
This is only meant as a reference if my code isn't clear enough and had too much
implicits