sheet.xsl: make text more self explanatory

morss/crawler.py

@@ -221,7 +221,7 @@ class GZIPHandler(BaseHandler):
 def detect_encoding(data, resp=None):
     enc = detect_raw_encoding(data, resp)
 
-    if enc == 'gb2312':
+    if enc.lower() == 'gb2312':
         enc = 'gbk'
 
     return enc
@@ -261,14 +261,10 @@ class EncodingFixHandler(BaseHandler):
         if 200 <= resp.code < 300 and maintype == 'text':
             data = resp.read()
 
-            if not self.encoding:
-                enc = detect_encoding(data, resp)
-            else:
-                enc = self.encoding
+            enc = self.encoding or detect_encoding(data, resp)
 
-            if enc:
-                data = data.decode(enc, 'replace')
-                data = data.encode(enc)
+            data = data.decode(enc, 'replace')
+            data = data.encode(enc)
 
             fp = BytesIO(data)
             old_resp = resp
@@ -655,5 +651,8 @@ class MySQLCacheHandler(BaseCache):
 if __name__ == '__main__':
     req = adv_get(sys.argv[1] if len(sys.argv) > 1 else 'https://morss.it')
 
-    if not sys.flags.interactive:
+    if sys.flags.interactive:
+        print('>>> Interactive shell: try using `req`')
+
+    else:
         print(req['data'].decode(req['encoding']))

morss/feeds.py

@@ -780,6 +780,9 @@ if __name__ == '__main__':
     req = crawler.adv_get(sys.argv[1] if len(sys.argv) > 1 else 'https://www.nytimes.com/', follow='rss')
     feed = parse(req['data'], url=req['url'], encoding=req['encoding'])
 
-    if not sys.flags.interactive:
+    if sys.flags.interactive:
+        print('>>> Interactive shell: try using `feed`')
+
+    else:
         for item in feed.items:
             print(item.title, item.link)

morss/readabilite.py

@@ -351,5 +351,8 @@ if __name__ == '__main__':
     req = crawler.adv_get(sys.argv[1] if len(sys.argv) > 1 else 'https://morss.it')
     article = get_article(req['data'], url=req['url'], encoding_in=req['encoding'], encoding_out='unicode')
 
-    if not sys.flags.interactive:
+    if sys.flags.interactive:
+        print('>>> Interactive shell: try using `article`')
+
+    else:
         print(article)

www/sheet.xsl

@@ -33,7 +33,8 @@
 				}
 
 				header {
-					text-align: center;
+					text-align: justify;
+					text-align-last: center;
 					border-bottom: 1px solid silver;
 				}
 
@@ -112,7 +113,6 @@
 				}
 
 				header > form {
-					text-align: center;
 					margin: 1%;
 				}
 
@@ -176,7 +176,7 @@
 					<select>
 						<option value="">full-text</option>
 						<option value=":proxy">original</option>
-						<option value=":clip">original + full-text</option>
+						<option value=":clip" title="original + full-text: keep the original description above the full article. Useful for reddit feeds for example, to keep the comment links">combined (?)</option>
 					</select>
 					feed as 
 					<select>
@@ -185,12 +185,12 @@
 						<option value=":html">HTML</option>
 						<option value=":csv">CSV</option>
 					</select>
-					using 
+					using the 
 					<select>
-						<option value="">the standard link</option>
-						<option value=":firstlink" title="Useful for Twitter feeds for example, to get the articles referred to in tweets rather than the tweet itself">the first link from the description (?)</option>
+						<option value="">standard</option>
+						<option value=":firstlink" title="Pull the article from the first available link in the description, instead of the standard link. Useful for Twitter feeds for example, to get the articles referred to in tweets rather than the tweet itself">first (?)</option>
 					</select>
-					and 
+					link and 
 					<select>
 						<option value="">keep</option>
 						<option value=":nolink:noref">remove</option>
@@ -199,7 +199,8 @@
 					<input type="hidden" value="" name="extra_options"/>
 				</form>
 
-				<p>Click <a href="/">here</a> to go back to morss</p>
+				<p>You can find a <em>preview</em> of the feed below. You need a <em>feed reader</em> for optimal use</p>
+				<p>Click <a href="/">here</a> to go back to morss and/or to use the tool on another feed</p>
 			</header>
 
 			<div id="header" dir="auto">