htmldog 1.0.0

data/History.txt

@@ -0,0 +1,6 @@
+=== 1.0.0 / 2008-11-08
+
+* 1 major enhancement
+
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,6 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/htmldog
+lib/htmldog.rb

data/README.txt

@@ -0,0 +1,41 @@
+= htmldog
+
+* http://theresistancearmy.com/gems/htmldog
+* http://rubyforge.org/projects/htmldog
+
+== DESCRIPTION:
+
+* A command line tool for html tag / css property documentation using htmldog.com as the data source.
+
+== FEATURES/PROBLEMS:
+
+* Fetches documentation including for html tags and css properties from htmldog.com.
+
+== SYNOPSIS:
+
+  htmldog img
+  
+  Image.
+  Note: When an image is used as a link, many browsers will show a border around the image. To get rid of this you should use CSS (border: 0).
+  Required Attributes
+    * src is used to specify the location of the image file.
+    * alt is used to specify the alternative text of the image, which should be a short description.
+  Optional Attributes
+    * longdesc can be used to specify the location (in the form of a URI) of a description of the image.
+    * height can be used to define the height of the image (in pixels). This can also be done with CSS.
+    * width can be used to define the width of the image (in pixels). This can also be done with CSS.
+  Example
+
+  <img src="http://www.htmldog.com/images/logo.gif" alt="HTML Dog" />
+
+== REQUIREMENTS:
+
+* rubygems, hpricot
+
+== INSTALL:
+
+* sudo gem install htmldog
+
+== LICENSE:
+
+Public Domain. Free as the air you breathe. Do whatever you want. No warranty given.

data/Rakefile

@@ -0,0 +1,20 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/htmldog.rb'
+
+HOE = Hoe.new('htmldog', Htmldog::VERSION) do |p|
+  p.rubyforge_name = 'htmldog'
+  p.developer('shane becker', 'veganstraightedge@gmail.com')
+  p.remote_rdoc_dir = '' # Release to root
+end
+
+namespace :gem do
+  task :spec do
+    File.open("#{HOE.name}.gemspec", 'w') do |f|
+      HOE.spec.version = "#{HOE.version}.#{Time.now.strftime("%Y%m%d%H%M%S")}"
+      f.write(HOE.spec.to_ruby)
+    end
+  end
+end

data/bin/htmldog

@@ -0,0 +1,73 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'hpricot'
+require 'open-uri'
+require 'htmldog'
+
+include Htmldog
+
+# checks for at least one arg
+if ARGV.size.zero?
+  puts <<-END_OF_STRING
+
+Example Usage: h float
+  where "float" is a CSS property,
+  or it can be an HTML tag like "div".
+Only one search item at a time (for now).
+
+  END_OF_STRING
+  exit 1
+end
+
+# deals with namespacing based on the q arg
+q = ARGV.shift
+if HTML_TAGS.include?(q)
+  name_space = "htmltags"
+elsif CSS_PROPERTIES.include?(q)
+  name_space = "cssproperties"
+else
+  puts <<-END_OF_STRING
+#{q}: No results found.
+  Maybe you mispelled it or it doesn't exist.
+  htmldog.com is used as the data source,
+  so if they don't have it, I can't find it.
+
+  END_OF_STRING
+  exit 1
+end
+
+# is the q one of the headings?
+# on htmldog.com all of the h1-h6 tags are on one page
+# h1h2h3h4h5h6
+q = HEADINGS_URL if HEADINGS.include?(q)
+
+# gets htmldog.com page for q tag or property
+doc = Hpricot(open("http://htmldog.com/reference/#{name_space}/#{q}/"))
+
+# chews up the html and prepares slimmed down version
+intro = (doc/"#intro")
+antiintro = (doc/"#ai2").inner_html
+
+# header output
+(intro/:p).each do |p|
+  puts p.inner_text
+end
+
+# possible values/attributes
+title = (doc/"#c1").inner_html
+h2s = (doc/"div[@id=ai2]/h2")
+uls = (doc/"div[@id=ai2]/ul")
+example = (doc/"div[@id=ai2]/pre/code")
+
+h2s.zip(uls).each do |h2, ul|
+  puts h2.inner_text
+  
+  if ul
+    ul.search("/li").each do |li|
+      puts "  * #{li.inner_text}" unless li.inner_text == "Common attributes"
+    end
+  else
+    puts example.first.inner_text
+  end
+end

data/lib/htmldog.rb

@@ -0,0 +1,10 @@
+module Htmldog
+  VERSION = '1.0.0'
+
+  HTML_TAGS = %w[a abbr acronym address area b base bdo big blockquote body br button caption cite code col colgroup dd del dfn div dl DOCTYPE dt em fieldset form h1 h2 h3 h4 h5 h6 head html hr i img input ins kbd label legend li link map meta noscript object ol optgroup option p param pre q samp script select small span strong style sub sup table tbody td textarea tfoot th thead title tr tt ul var]
+
+  HEADINGS = %w[h1 h2 h3 h4 h5 h6]
+  HEADINGS_URL = "h1h2h3h4h5h6"
+
+  CSS_PROPERTIES = %w[background background-attachment background-color background-image background-position background-repeat border border-collapse border-color border-spacing border-style border-width bottom caption-side clear clip color content counter-increment counter-reset cursor direction display empty-cells float font font-family font-size font-style font-variant font-weight height left letter-spacing line-height list-style list-style-image list-style-position list-style-type margin max-height max-width min-height min-width orphans outline outline-color outline-style outline-width overflow padding page-break-after page-break-before page-break-inside position quotes right table-layout text-align text-decoration text-indent text-transform top unicode-bidi vertical-align visibility white-space widows width word-spacing z-index]
+end

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification 
+name: htmldog
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- shane becker
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDRDCCAiygAwIBAgIBADANBgkqhkiG9w0BAQUFADBIMRowGAYDVQQDDBF2ZWdh
+  bnN0cmFpZ2h0ZWRnZTEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPy
+  LGQBGRYDY29tMB4XDTA4MTEwOTA0MjkzNFoXDTA5MTEwOTA0MjkzNFowSDEaMBgG
+  A1UEAwwRdmVnYW5zdHJhaWdodGVkZ2UxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDET
+  MBEGCgmSJomT8ixkARkWA2NvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoC
+  ggEBAMlSloQVoHL+ZmSBnBgLzDKfKEOUS9/Om9Wn/hFv42VoTaWjPDnIXxYBgM8Z
+  Y4nN6++v/W1zqzhHjZ1/BcUddf+eCao44ZPYuZzbAzWfzsw/1A0RpljrOL6/QwgQ
+  Ukqdtep88Un7kjZbCCOvhHDO3s0uWx+zMwDnXZHWSMcisBFr5ROtxPPP2TNZ2OIF
+  k5DBmRG+gJFrxRcLjw7/2HwC85Y6/K/03Xd3opT9Usx4mmAxoWNQdHRziLdRZkqa
+  8I8QZGLEzYBlGU2HtoS589H4yvniGZ5uRFNq8IDky17082U8UIV1/fA/AD1zafXM
+  NpFwyRxenk4uZ47SAFZy4Fap1/ECAwEAAaM5MDcwCQYDVR0TBAIwADALBgNVHQ8E
+  BAMCBLAwHQYDVR0OBBYEFG72MPsN+YkL6Ia+11qadX+AhO+iMA0GCSqGSIb3DQEB
+  BQUAA4IBAQB+YMhV2RjvM3n+DLVUxfBoBA/UutwbjRk606zMpciyf2vj9TvEKWtn
+  /h9YjenqfpK0DHjWjHQ6OvMXUdW+oWwmge7wj5nzORHvUeYPy8nIL6mgYdB0Ok6l
+  sduNeMJE74Ov5iC/nhNjDJi9f1ALoZ+fnvSoKHeng+h+QLQD0u3Aw0ufd/jOCqPU
+  ElKPfjuyJYok8FN9926m92LoK+jVTi8p88Hnl/r/VjTyxAdE+RtEX+1qmRTurPyq
+  pbz+MRoImeKuDUwGKU4yTar4vTrNQSLtBYqvQkx+so2qfE/pkF4Kl5gSXq25MZAm
+  96nXBrI7LGqIy8FTpiLMU5Ol+URRf94f
+  -----END CERTIFICATE-----
+
+date: 2009-03-12 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.8.2
+    version: 
+description: "* A command line tool for html tag / css property documentation using htmldog.com as the data source."
+email: 
+- veganstraightedge@gmail.com
+executables: 
+- htmldog
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- bin/htmldog
+- lib/htmldog.rb
+has_rdoc: true
+homepage: http://theresistancearmy.com/gems/htmldog
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: htmldog
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: "* A command line tool for html tag / css property documentation using htmldog.com as the data source."
+test_files: 
+- test/test_htmldog.rb