~fredg/tiweb

KISS engine to publish your log on the Gemini network and on the Web (RSS feed and simple txt files)
add extra infos to setup tiweb
add templates dir
add config file

refs

master
browse  log 

clone

read-only
https://git.sr.ht/~fredg/tiweb
read/write
git@git.sr.ht:~fredg/tiweb

You can also use your local clone with git send-email.

TIWEB
=====

Python KISS engine to publish your logs on the Gemini network and on the
internet. No extra python modules required, you just need python
installed.

RSS feed and txt files only (no html, no javascript, no tracking,
no DRM, no... ). Just focus on the content :P

Original posts are written in gemtext for your gemini capsule.
Those files are renamed to txt files for the internet.
I changed the link schema to make it easily selectable.
So, a gemini link is:

```
=> https://galusik.fr A wonderfull website
```

Tiweb text link is:

```
=> A wonderfull website
https://galusik.fr
```

Your capsule respect the gemini specs (index file with posts date
and title and links).

Your web index file (your blog welcome page) is the RSS file.
It is adapted to a browser view.  

Tiweb is an engine, it is up to you to sync thoses files to your
gemini capsule and to your online web server (tip: sourcehut can do
it for you ;)).

So, yes, your articles are best viewed in a feed reader or/and on the
gemini network.


INSTALL
-------
- Dowload this repo
- move tiweb.ini config file in ~/.config/tiweb (default that can be changed)
- Edit this file with your information (name, title, dirs...)
- move tpl/ templates dir in ~/.config/tiweb/tpl
- Edit these templates to suit your needs
- Write your posts in gemtext
https://gemini.circumlunar.space/docs/gemtext.gmi 
- Run tiweb
- Sync (git, rsync, ...)
- Write & Enjoy!


SHINOBI
-------
Tiweb is a shinobi fork
https://shinobi.bt.ht/

If you don't mind about gemini and/or prefer bash over python, just
go to shinobi ;)


Quoted from there:
```
WHAT IS A SHINOBI WEBSITE?
==========================

A shinobi website is a text-based, RSS focused blogging "system". I put
the word system in quotes since it's really just a simple bash script
that converts plain text files into an RSS feed. So, it isn't an actual
blogging platform or website in the traditional sense.

Why the name "shinobi"? Well, a shinobi was a covert agent or mercenary
during the time of feudal Japan. Due to their focus on infiltration and
assassination, they required a strong focus on stealth and being unseen.

A shinobi website follows the same principles of being secretive and
unseen (minus the assassinations and espionage). Only those who
*choose* to include your feed in their respective RSS readers can view
your content via the included URL.

It's like an exclusive club[0] for your true, real audience.


A SHINOBI WEBSITE IS PURE MINIMALISM
------------------------------------

Imagine writing *just* content. No dependencies. No heavy-duty build
process. Nothing but simple plain text files. One bare-bones bash
script is all you need to generate a valid RSS file from your existing
text files.

This concept isn't anything new. In fact, this entire project was
greatly influenced by WRITING FOR THE INTERNET ACROSS A HUMAN
LIFETIME[1]
```