From 95809fc4a07f4edb4892798dbcd33b062a3239ea Mon Sep 17 00:00:00 2001 From: Brent Simmons Date: Thu, 16 May 2019 21:31:19 -0700 Subject: [PATCH] Start Help Book. --- Technotes/HelpBook5.0/5.0/en/README.md | 7 +++++ .../5.0/en/images/websitediagram.png | Bin 0 -> 1719 bytes Technotes/HelpBook5.0/5.0/en/index.markdown | 4 +++ .../HelpBook5.0/5.0/en/what-is-rss.markdown | 29 ++++++++++++++++++ 4 files changed, 40 insertions(+) create mode 100644 Technotes/HelpBook5.0/5.0/en/README.md create mode 100644 Technotes/HelpBook5.0/5.0/en/images/websitediagram.png create mode 100644 Technotes/HelpBook5.0/5.0/en/index.markdown create mode 100644 Technotes/HelpBook5.0/5.0/en/what-is-rss.markdown diff --git a/Technotes/HelpBook5.0/5.0/en/README.md b/Technotes/HelpBook5.0/5.0/en/README.md new file mode 100644 index 000000000..04ef1ff98 --- /dev/null +++ b/Technotes/HelpBook5.0/5.0/en/README.md @@ -0,0 +1,7 @@ +# About the NetNewsWire 5 Help Book + +The Help book goes here. Text files go at the top level, and images go in the images directory. + +Text files are markdown files. A script ([wildcat](https://github.com/brentsimmons/wildcat)) will turn this into a web site that will appear at [https://ranchero.com/netnewswire/help/5.0/en/](https://ranchero.com/netnewswire/help/5.0/en/). (The /en/ directory because we hope to have localized versions.) + +If you’d like to write or edit the Help book, or help with screenshots, please bring it up on the [NetNewsWire Slack](https://netnewswire.slack.com/join/shared_invite/enQtNjM4MDA1MjQzMDkzLTNlNjBhOWVhYzdhYjA4ZWFhMzQ1MTUxYjU0NTE5ZGY0YzYwZWJhNjYwNTNmNTg2NjIwYWY4YzhlYzk5NmU3ZTc) group. We’ll coordinate there. \ No newline at end of file diff --git a/Technotes/HelpBook5.0/5.0/en/images/websitediagram.png b/Technotes/HelpBook5.0/5.0/en/images/websitediagram.png new file mode 100644 index 0000000000000000000000000000000000000000..70496c1df53f3777a51462e79c1f796cd6d10087 GIT binary patch literal 1719 zcmZuyeN{-Tc>g2Op{92Fj#m_M$ShkmvtX;a7IV!l?mA+EM|by(@W`5<9b&)UG(Kgn%h zp>`EUyM$*vx|_YGaWqpq6;xfmI&P%9GJvi^K#!!v8_6uaY>uuSzPh|D<*&S#cn%$u z#kjrR($dztyJF>70#WT~D71tk*TGFy>KGKx6tEB@tUTdH_&oRd@qO=Y+@Y6n2za2o z2CZ)e4I0ftGW^`DUy%o0VefuQ-p>l*CBfEc-Lunr)k5%m*`+sUc?#Qi4Y1c?Pf7HN zE)ypn&7BDRG-1d$y2O&6G0geLSsbwj7{+5EgL+7&YQ0j=|K_`D1rxC7$@1KS^ZAYCKZ>$%* z3X6Mbh4_iaHKG4M1234$px4yrvKWhxd(K0WEZK-ca67w8=2f|$?9$V^)4wPAiu|gJ zvTdhJ#G<@M`uS23v)Rc2+^`zwxHjv})D8UB8ozPswxpD6jXyW;AirgFJ2cE@Pi&bg z9MP>$yJgd@AM+KF&ZKzo25z^d8)0u#Ar}-nh&$-E4pyQKw$C zgHSxtNq%|~A_bZe3gqPcvklQ6W{VBY8^aKm4hdXtQ!6;^t;QtuxC7hgSzbd9!4!J- zOLyLh?T3qWA4OUN_zv>6KKjz!S5Mcd9rN0A0TD-(de?lwL7YhV#_Su`?7fW8h}Q~ z4%sy{zbfkpds^X)7|+$o@x_sW*x4wPM(_s&KtIS3x1(j-zuKE^q!=fx4RGNY@p=Q@ zL<-I_+{uk*UdVbn_h){9r?)ld)dPjLsA0e+3Kc~k&)&QsRg}zMw_Or{ea_fK*O!V1 zBq?5_)DM5!Z7yi)#_iB z3Vgp`=?Y&Psd^l-xK0%>8&kcOi3Ovo2F+51eU2rUPqr-`7B4I5kfQ)CU*C5Hmh8vg z|HHaM>xgBV4h2{{waxH^b;Qf=9Yb!pfVDgsRc{oV7O=G6H8UT-b}!GjxL{Cizn6ox zP8@O6TCJ;o&>f@;;wz%-d8zhv595tsUc0Vf0Q9y7zZF%fFJ=s8Vm(hIBm;boMd`(U zQ4~gZ2FDWYT@k~t9jE!PT<|a5GSxUz#WmAXWg72Gx0Q+26;IfEh^y}WYCF3t^Zayr z`Z6iMq(U|)8cJsG1BIrjA7_uCuz>!9R9VnorzsH0Te zg4BA!P>Gte++6YJ@%nJ + +The good part is the part in the middle — that’s the part with the news. That’s the part that you read. That’s the part you’re interested in. + +

And that’s what RSS is — it’s just that part, minus the rest of the stuff. + +#### Details + +That “good part” is actually made available as a *feed.* A feed is just a specially-formatted text file that readers like NetNewsWire can read. The files look weird — they kind of look like the source behind web pages, with angle brackets and everything. + +The important thing is: it’s NetNewsWire’s job to know how to read the feed. And it’s NetNewsWire’s job to show you what articles you haven’t read yet. + +By doing this — by running NetNewsWire — you can let NetNewsWire find out when there’s something new. You don’t have to go to the websites and check to see if there’s something new. You can save time, and not have to rely on your memory. + +#### Types of feeds + +People often talk or write about RSS — but sometimes they mention Atom, too. Atom does the same thing as RSS. Sometimes they mention the JSON Feed format, which does the same thing as RSS too. + +If you see RSS or Atom or JSON Feed, just know that NetNewsWire handles all these, no problem. \ No newline at end of file