blog_helper 0.0.9 → 0.0.10

data/README.md

@@ -33,14 +33,12 @@ For example, to use seo friendly titles, your layout.rhtml should be looking lik
         <% require 'blog_helper'
            page_title = BlogHelper::seo_friendly_title(@path, title, 'yourSitesTitle.com')
         %>
-    .
-    .
-    .
         <title><%=  page_title %></title>
         <link rel="alternate" type="application/atom+xml" title="<%= page_title %> - feed" href="/index.xml" />
     .
     .
     .
+
 ### Tags
 Adding the tagging feature requires the _toto_prerelease_ as mentioned above, since we need the http request to apply our little hack.
 
@@ -76,9 +74,7 @@ And again: piece of caked ;-). Now all we need to add is a page that displays ar
 
 Create a page called `tagged.rhtml` in your `templates/pages` directory that looks like this:
 
-    <%#
-    # search given tags...
-    %>
+
     <%
      require 'blog_helper'
      desired_tag = BlogHelper::desired_tag(env["QUERY_STRING"])
@@ -106,7 +102,20 @@ To use a bit.ly shortened URL, just call the followin function inside a .rhtml f
 
 ### disqus comment counter
 
-TBD... I have to refer to the source & ri for now.
+Basically just adds the necessary java script to enable the disqus comment counter. For best performance, place it near the end of the page:
+
+        <%= BlogHelper::disqus_comment_count_js(@config[:disqus]) %>
+      </body>
+
+    </html>
+
+Mind the usage of `@config[:disqus]`, this enables configuration via `config.ru`.
+
+To access the comment count, use `#disqus_thread` at the end of the permalink to the post & it will be replaced with the disqus comment count:
+
+    <a href="<%= article.path %>#disqus_thread">&nbsp;</a>
+
+Will result in the number of comments of the article the permalink posts to.
 
 ### serious custom yaml field reader
 

data/Rakefile

@@ -12,7 +12,7 @@ require 'rake/testtask'
 
 spec = Gem::Specification.new do |s|
   s.name = 'blog_helper'
-  s.version = '0.0.9'
+  s.version = '0.0.10'
   s.has_rdoc = true
   s.extra_rdoc_files = ['README.md', 'LICENSE']
   s.summary = 'Some handy helpers for serious, toto and the likes...'

data/lib/blog_helper.rb

@@ -2,10 +2,13 @@ require 'cgi'
 require 'net/http'
 require 'uri'
 
-
+#
 # Some useful feature for serious, toto and the likes. Basically, any ruby based blog or site.
+#
 module BlogHelper
+  #
   # create a list of links to tagged articles, default link_format: <code>%&amp;&lt;a href=&quot;/tagged?tag=#{tag}&quot; alt=&quot;articles concerning #{tag}&quot; &gt;#{tag}&lt;/a&gt; &amp;</code>
+  #
   def BlogHelper.tag_link_list(csv_string)
     # read csv-string into array
     tag_list = csv_to_array(csv_string)
@@ -16,13 +19,17 @@ module BlogHelper
     end
     tag_string
   end
+  #
   # processes a csv-string into an array
+  #
   def BlogHelper.csv_to_array(csv_string)
       #split & handle forgotten spaces after the separator. then flatten the multidemnsional array:
       csv_string.split(', ').map{ |e| e.split(',')}.flatten if csv_string
   end
+  #
   # pass the path (@path for a toto blog) & the desired SEO ending, e.g. the name of your blog.
   # example for toto: <code>seo_friendly_title(@path, title, "mysite.com") will produce 'subpage | mysite.com' as seo friendly page title.</code>
+  #
   def BlogHelper.seo_friendly_title(path, title, seo_ending)
     #TODO use custom title separator...
        if path == 'index'
@@ -34,6 +41,7 @@ module BlogHelper
       end
       page_title
   end
+  #
   #Generates javascript to include to the bottom of your index page.
   #Appending '#disqus_thread' to the end of permalinks will replace the text of these links with the comment count.
   #
@@ -54,13 +62,21 @@ module BlogHelper
 
     & if disqus_shortname
   end
+  #
   # Retrieve bit.ly shortened url
+  #
   def BlogHelper.short_url_bitly(url, login, api_key)
     if api_key != "" && login != ""
       rest_call=%{http://api.bit.ly/v3/shorten?login=#{login}&apikey=#{api_key}&longUrl=#{url}&format=txt}
-      Net::HTTP::get(URI.parse(rest_call)) # handle http errors (esp. timeouts!)
+      begin
+        Net::HTTP::get(URI.parse(rest_call)) # handle http errors (esp. timeouts!)
+      rescue URI::InvalidURIError
+        raise URI::InvalidURIError
+      rescue
+        url#in the case of a web service or HTTP error, we'll just ignore it & return the long url
+      end
     else
-      url #fallback: return url to shorten - or nil if it isn't set
+      url #fallback: return long url if no proper login has been provided. TODO: check if a call w/o login is possible
     end
   end
   #desired articles matching a corresponding tag

data/lib/serious_blog_helper.rb

@@ -1,6 +1,7 @@
 # extension to BlogHelper with special methods for serious
 require 'blog_helper'
 module SeriousBlogHelper
+  #extract tags from article
   def SeriousBlogHelper.tags_from_article(article=nil)
     tags_marker = %&tags"=>&
     if article && article.inspect.index(tags_marker)

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: blog_helper
 version: !ruby/object:Gem::Version 
-  hash: 13
+  hash: 11
   prerelease: false
   segments: 
   - 0
   - 0
-  - 9
-  version: 0.0.9
+  - 10
+  version: 0.0.10
 platform: ruby
 authors: 
 - "Sven Kr\xC3\xA4uter"
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-07-20 00:00:00 +02:00
+date: 2010-07-21 00:00:00 +02:00
 default_executable: 
 dependencies: []