doc_to_dash 0.0.4 → 0.0.5

Sign up to get free protection for your applications and to get access to all the features.
data/.gitignore CHANGED
@@ -15,4 +15,5 @@ spec/reports
15
15
  test/tmp
16
16
  test/version_tmp
17
17
  tmp
18
- .idea/
18
+ .idea/
19
+ .DS_Store
data/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # DocToDash
2
2
 
3
- DocToDash converts documentation files (at the moment only YARD) into a classes and methods docset that can then be loaded into the docset viewing program: Dash.
3
+ DocToDash converts documentation files (Rdoc Darkfish / YARD) into a classes and methods docset that can then be loaded into the docset viewing program: Dash.
4
4
 
5
5
  ## Installation
6
6
 
@@ -42,9 +42,9 @@ Or install it yourself as:
42
42
 
43
43
  <tr>
44
44
  <td>:icon_path</td>
45
- <td>nil/</td>
45
+ <td>../default_icon.png</td>
46
46
  <td>The icon file that will be put in the docset. Shown in Dash.</td>
47
- <td>No</td>
47
+ <td>No (can be nil, will not transfer default_icon.png)</td>
48
48
  </tr>
49
49
 
50
50
  <tr>
@@ -71,14 +71,14 @@ Or install it yourself as:
71
71
  <tr>
72
72
  <td>:parser</td>
73
73
  <td>DocToDash::YardParser</td>
74
- <td>Parser to use to pull out classes and modules. YARD is only supported at the moment.</td>
74
+ <td>Parser to use to pull out classes and modules. DocToDash::YardParser / DocToDash::RdocDarkfishParser.</td>
75
75
  <td>Yes</td>
76
76
  </tr>
77
77
  </table>
78
78
 
79
79
  ## Usage
80
80
 
81
- Generate YARD documentation (or as time progresses and we support rdoc, generate that). This will output your Rails application's YARD documentation to doc/yard:
81
+ Generate YARD documentation (or darkfish rdoc). This below will output your Rails application's YARD documentation to doc/yard:
82
82
 
83
83
  $ yardoc app/**/*.rb lib/**/*.rb --protected --private --embed-mixins --output-dir doc/yard/
84
84
 
@@ -103,3 +103,7 @@ This will create a docset in the docset_output_path then you just need to load t
103
103
  3. Commit your changes (`git commit -am 'Add some feature'`)
104
104
  4. Push to the branch (`git push origin my-new-feature`)
105
105
  5. Create new Pull Request
106
+
107
+ ## Thanks
108
+
109
+ Default Icon: Crash Test Dummy designed by Luis Prado from The Noun Project
data/default_icon.png ADDED
Binary file
data/lib/doc_to_dash.rb CHANGED
@@ -14,7 +14,7 @@ module DocToDash
14
14
  :docset_name => 'DefaultDocset',
15
15
  :docset_output_path => 'doc/', # This is where the actual package will be created.
16
16
  :docset_output_filename => lambda {@options[:docset_name] + '.docset' },
17
- :icon_path => nil, # This is the docset icon that never changes, if you want a default icon just set this to nil.
17
+ :icon_path => File.expand_path(File.expand_path(File.dirname(__FILE__)) + '/../default_icon.png'), # This is the docset icon that never changes, if you want a default icon just set this to nil.
18
18
  :doc_input_path => nil, # This is the actual docs to copy over to the Docset.
19
19
  :doc_save_folder => 'docs', # This is the directory name it will store under /Contents/Resources/Documents/{this}
20
20
  :verbose => true,
@@ -94,7 +94,11 @@ module DocToDash
94
94
  def copy_default_files
95
95
  log "Copy default Docset files over."
96
96
 
97
- FileUtils.cp @options[:icon_path], @docset_path + '/' unless @options[:icon_path].nil?
97
+ unless @options[:icon_path].nil?
98
+ FileUtils.cp @options[:icon_path], @docset_path + '/'
99
+ FileUtils.mv @docset_path + '/' + File.basename(@options[:icon_path]), @docset_path + '/icon.png'
100
+ end
101
+
98
102
  File.open(@docset_path + '/Contents/Info.plist', 'w+') { |file| file.write(default_plist.gsub('{DOCSET_NAME}', @options[:docset_name])) }
99
103
  end
100
104
 
@@ -1,3 +1,3 @@
1
1
  module DocToDash
2
- VERSION = "0.0.4"
2
+ VERSION = "0.0.5"
3
3
  end
@@ -2,12 +2,13 @@ module DocToDash
2
2
  class YardParser
3
3
  def initialize(doc_directory)
4
4
  @doc_directory = doc_directory
5
+
6
+ fix_css_file
5
7
  end
6
8
 
7
- #TODO: fix the CSS file and remove the top header. JS will not work on Dash.
8
- #def fix_css_file
9
- # File.open(@doc_directory + '/rdoc.css', 'a') { |file| file.write('nav, footer { display: none !important; } #documentation { margin: 0 !important; } .method-source-code { display: block !important; }') }
10
- #end
9
+ def fix_css_file
10
+ File.open(@doc_directory + '/css/style.css', 'a') { |file| file.write('#header, .showSource, .inheritanceTree, .inheritName, h2 small { display: none; } .source_code, .fullTree { display: block !important; }') }
11
+ end
11
12
 
12
13
  def parse_classes
13
14
  classes_file = File.read(@doc_directory + '/class_list.html')
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: doc_to_dash
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.0.4
4
+ version: 0.0.5
5
5
  prerelease:
6
6
  platform: ruby
7
7
  authors:
@@ -9,7 +9,7 @@ authors:
9
9
  autorequire:
10
10
  bindir: bin
11
11
  cert_chain: []
12
- date: 2012-10-17 00:00:00.000000000 Z
12
+ date: 2012-10-18 00:00:00.000000000 Z
13
13
  dependencies:
14
14
  - !ruby/object:Gem::Dependency
15
15
  name: nokogiri
@@ -57,6 +57,7 @@ files:
57
57
  - README.md
58
58
  - Rakefile
59
59
  - bin/doc_to_dash
60
+ - default_icon.png
60
61
  - doc_to_dash.gemspec
61
62
  - lib/doc_to_dash.rb
62
63
  - lib/doc_to_dash/rdoc_darkfish_parser.rb