______ _______ ______ ___ ____ / __/ // / _/ |/ / __ \/ _ )/ _/ _\ \/ _ // // / /_/ / _ |/ / /___/_//_/___/_/|_/\____/____/___/ /\ ,vvvvvvv\\-------------------------, `^^^^^^^//========================" \/ 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] CREATE YOUR OWN --------------- 1. Simply clone/download the project below 2. Make sure you edit the parameters at the top of the script.sh (in your favorite text editor) ```shell #!/bin/sh DOMAIN="YOUR-DOMAIN" POST_DIR="posts/" AUTHOR="YOUR-EMAIL (YOUR-NAME)" TIME="00:00:00 EST" ``` 3. Write your posts/pages as plain text files (.txt) inside a sub-folder (/posts) 4. Run the `make` in you terminal when a new post/page is added 5. (Optional) Run `make serve` to test your changes locally 6. Update your site files and RSS feed to your web server 7. Profit! THE CODE -------- I hardly consider myself a hardcore "developer" (I'm actually a UI designer - if you can believe it!) so please go easy on judging my ugly coding skills. It gets the job done quickly and renders valid RSS syntax. That's all that matters. You can find the very basic project code on sourcehut (licensed under MIT): > https://git.sr.ht/~tdarb/shinobi-script WRITING A POST OR PAGE ---------------------- There are only a few minor caveats you need to be aware of when writing your plain text files. If you have the technical skills, you have the freedom to change these settings within the script.sh file itself. 1. The first line of each text file needs to be the post's date 2. The second line of each text file needs to be the post's title 3. The third line of each text file needs to be blank 4. The fourth line of each text file needs to be the post's description Example: 01| Wed, 13 Dec 2045 02| MY AMAZING BLOG POST FROM THE FUTURE 03| 04| This blog post is ahead of it's time since it only exists in the future That's it. The script will take care of everything and render things perfectly for most RSS readers. READ THE OFFICIAL SHINOBI.WEBSITE --------------------------------- Simply add https://shinobi.website/feed.xml to your RSS reader of choice. For Apple devices, I strongly recommend using the NetNewsWire[2] family of applications. For those on other platforms I would recommend the web-based application Feedly. Articles posted here will mostly cover topics about minimalism, open source software, writing prompts, HTML/CSS hacks and *possibly* video game reviews. If any of that sounds interesting to you, consider subscribing! HELP BY CONTRIBUTING! --------------------- I am far from a good developer, so my code is most likely lacking. Please don't hesitate to submit patches or suggest changes by using the mailing list below: ~tdarb/shinobi-script@lists.sr.ht FOOTNOTES --------- [0]: https://daverupert.com/rss-club/ [1]: http://len.falken.directory/misc/writing-for-the-internet-across-a-human-lifetime.txt [2]: https://netnewswire.com Thanks for reading, -- Brad ------------ => ../ Retour => http://matograine.fr Accueil