aboutsummaryrefslogtreecommitdiff
path: root/posts/patch-1.txt
blob: f6e582a09df6d1383768786e3cbf74fc729ef7e5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
Sun, 15 May 2022
FIRST MAJOR PATCH AND QOL IMPROVEMENTS

The main shinobi script has received its first external patch!

It's getting just past 10PM on this stormy Sunday night, but I have an 
urge to share this post now instead of waiting for next week. 
Afterwards I'll be going to bed before the start of a new week.

If you've been following along, you might have noticed a pretty solid 
patch has been added to the core shinobi script project:

https://git.sr.ht/~tdarb/shinobi-script

Special shout out to Matthew Graybosch[0] for putting together these 
improvements and working towards a more consistent experience across 
all RSS readers.


THE CHANGES AT A GLANCE
-----------------------

In a nutshell:

- text inside the CDATA tag is now wrapped with <pre> tags
- <pre> tag has inline CSS to specify reasonable wrapping
- tail command to retrieve post text now pipes into sed to escape HTML 
tags.
- added test posts
- added makefile for local testing

Please take a look at the changes directly in the official patch 
notes[1]. Take notice of some of the new folders/files included with 
the default project. You'll also see updated instructions in the README 
to help with testing and local development.


QUALITY OF LIFE
---------------

In addition to the first major patch, I've included basic styling to 
properly render the RSS feed directory in supported browsers. To see it 
in action, simply check out:

https://shinobi.website/feed.xml

The styles are included in the new `rss.css` file of the shinobi 
project. The current layout is taken from Len Falken's main 
directory[2]. Feel free to change this to however you see fit! I've 
kept them consistent with the remainder of the project, but there is 
nothing stopping you from including things like XSLT.

To reflect these changes, I've updated some of the details found in the 
original "SIMPLE GUIDE FOR CREATING YOUR OWN SHINOBI.WEBSITE"[3]


TESTING, TESTING, TESTING
-------------------------

I'm trying my best to test every RSS reader available to me. My main 
machine is running macOS and my phone iOS, thus making me somewhat 
limited in my access to other OS-specific RSS applications. Even still, 
I've added a growing list to the project README documenting readers 
that have been tested, along with their support "grade". Feel free to 
include your own testing in tickets or patches on your own!

That is really all there is to say. Enjoy your week!


LINKS
-----

[0]: https://matthewgraybosch.com
[1]: 
https://git.sr.ht/~tdarb/shinobi-script/log?from=7e2f8bd312d648ff1c8d3cf
dc747d2e5634100d7#log-7e2f8bd312d648ff1c8d3cfdc747d2e5634100d7
[2]: http://len.falken.directory
[3]: https://shinobi.website/posts/create-your-own-shinobi-website.txt


***

Thanks for reading,
-- Brad