double_doc 1.0.5 → 1.0.6

Sign up to get free protection for your applications and to get access to all the features.
data/README.md CHANGED
@@ -90,16 +90,16 @@ The available options are:
90
90
  | __html_css__ | You can use your own custom CSS document by specifying it's path here.
91
91
  | __title__ | The title you want in the generated HTML. Defaults to "Documentation".
92
92
 
93
- If you just want to use double doc to generate your readme.md for github, you should write your documentation in doc/readme.md and put his in your Rakefile:
93
+ If you just want to use double doc to generate your README.md for github, you should write your documentation in doc/README.md and put his in your Rakefile:
94
94
 
95
95
  ```ruby
96
96
  require 'double_doc'
97
97
 
98
- DoubleDoc::Task.new(:doc, :sources => 'doc/readme.md', :md_destination => '.')
98
+ DoubleDoc::Task.new(:doc, :sources => 'doc/README.md', :md_destination => '.')
99
99
  ```
100
100
  Then all you have to do is to run `rake doc`, and you will have a `readme.md` in the root of your project.
101
101
 
102
- You can even run `rake doc:publish` to generate html documentation and push it to your Github Pages.
102
+ If you have a gh-pages branch set up in your repository, you can event run `rake doc:publish` to generate html documentation and push it to your github pages.
103
103
 
104
104
  ### Notes
105
105
  DoubleDoc is tested as working on both ruby 1.8.7 and 1.9.3, but does not work on jruby because if it's dependency on redcarpet.
@@ -64,7 +64,7 @@ module DoubleDoc
64
64
  end
65
65
 
66
66
  def copy_assets
67
- if @html_renderer == HtmlRenderer
67
+ if @stylesheet == 'screen.css'
68
68
  FileUtils.cp(File.expand_path("../../templates/screen.css", File.dirname(__FILE__)), @output_directory)
69
69
  end
70
70
  end
@@ -100,4 +100,4 @@ module DoubleDoc
100
100
  end
101
101
  end
102
102
 
103
- end
103
+ end
@@ -31,16 +31,16 @@ module DoubleDoc
31
31
  ## | __html_css__ | You can use your own custom CSS document by specifying it's path here.
32
32
  ## | __title__ | The title you want in the generated HTML. Defaults to "Documentation".
33
33
  ##
34
- ## If you just want to use double doc to generate your readme.md for github, you should write your documentation in doc/readme.md and put his in your Rakefile:
34
+ ## If you just want to use double doc to generate your README.md for github, you should write your documentation in doc/README.md and put his in your Rakefile:
35
35
  ##
36
36
  ## ```ruby
37
37
  ## require 'double_doc'
38
38
  ##
39
- ## DoubleDoc::Task.new(:doc, :sources => 'doc/readme.md', :md_destination => '.')
39
+ ## DoubleDoc::Task.new(:doc, :sources => 'doc/README.md', :md_destination => '.')
40
40
  ## ```
41
41
  ## Then all you have to do is to run `rake doc`, and you will have a `readme.md` in the root of your project.
42
42
  ##
43
- ## You can even run `rake doc:publish` to generate html documentation and push it to your Github Pages.
43
+ ## If you have a gh-pages branch set up in your repository, you can event run `rake doc:publish` to generate html documentation and push it to your github pages.
44
44
  class Task
45
45
  include Rake::DSL if defined?(Rake::DSL)
46
46
 
@@ -73,52 +73,38 @@ module DoubleDoc
73
73
 
74
74
  end
75
75
 
76
- namespace(task_name) do
76
+ has_github_pages = !`git branch | grep 'gh-pages'`.empty? rescue false
77
77
 
78
- desc "Publish DoubleDoc documentation to Github Pages"
79
- task :publish do
80
- git_clean = `git status -s`.empty? rescue false
81
- raise "Your local git repository needs to be clean for this task to run" unless git_clean
78
+ if has_github_pages
79
+ namespace(task_name) do
80
+ desc "Publish DoubleDoc documentation to Github Pages"
81
+ task :publish do
82
+ git_clean = `git status -s`.empty? rescue false
83
+ raise "Your local git repository needs to be clean for this task to run" unless git_clean
82
84
 
83
- git_branch = `git branch | grep "*"`.match(/\* (.*)/)[1] rescue 'master'
85
+ git_branch = `git branch | grep "*"`.match(/\* (.*)/)[1] rescue 'master'
84
86
 
85
- Dir.mktmpdir do |dir|
86
- generate_task.execute(:html_destination => dir)
87
- html_files = Dir.glob(Pathname.new(dir) + '*.html')
87
+ Dir.mktmpdir do |dir|
88
+ generate_task.execute(:html_destination => dir)
89
+ html_files = Dir.glob(Pathname.new(dir) + '*.html')
88
90
 
89
- `git add .`
90
- `git commit -m 'Updated documentation'`
91
-
92
- has_github_pages = !`git branch | grep 'gh-pages'`.empty? rescue false
93
-
94
- unless has_github_pages
95
- puts "Setting up gh-pages branch"
96
-
97
- `git symbolic-ref HEAD refs/heads/gh-pages`
98
- `rm .git/index`
99
- `git clean -fdx`
100
- else
91
+ `git add .`
92
+ `git commit -m 'Updated documentation'`
101
93
  `git checkout gh-pages`
102
94
  `git pull origin gh-pages`
95
+ `cp #{dir}/* .`
96
+ if html_files.size == 1
97
+ `cp #{html_files[0]} index.html`
98
+ else
99
+ warn("You should probably generate an index.html")
100
+ end
101
+ `git add .`
102
+ `git commit -m 'Updated Github Pages'`
103
+ `git push origin gh-pages`
104
+ `git co #{git_branch}`
103
105
  end
104
-
105
- puts "Publishing your Github Pages"
106
- `cp #{dir}/* .`
107
- if html_files.size == 1
108
- `cp #{html_files[0]} index.html`
109
- else
110
- warn("You should probably generate an index.html")
111
- end
112
-
113
- `git add .`
114
- `git commit -m 'Updated Github Pages'`
115
- `git push origin gh-pages`
116
- `git co #{git_branch}`
117
-
118
- puts "Your Github Pages has been published. You will receive an email from Github when they are online."
119
106
  end
120
107
  end
121
-
122
108
  end
123
109
  end
124
110
 
@@ -1,4 +1,4 @@
1
1
  ## ## DoubleDoc 1.0
2
2
  module DoubleDoc
3
- VERSION = "1.0.5"
3
+ VERSION = "1.0.6"
4
4
  end
metadata CHANGED
@@ -1,90 +1,118 @@
1
- --- !ruby/object:Gem::Specification
1
+ --- !ruby/object:Gem::Specification
2
2
  name: double_doc
3
- version: !ruby/object:Gem::Version
4
- version: 1.0.5
3
+ version: !ruby/object:Gem::Version
4
+ hash: 27
5
5
  prerelease:
6
+ segments:
7
+ - 1
8
+ - 0
9
+ - 6
10
+ version: 1.0.6
6
11
  platform: ruby
7
- authors:
12
+ authors:
8
13
  - Mick Staugaard
9
14
  autorequire:
10
15
  bindir: bin
11
16
  cert_chain: []
12
- date: 2012-02-20 00:00:00.000000000 Z
13
- dependencies:
14
- - !ruby/object:Gem::Dependency
15
- name: guard
16
- requirement: &70134689089720 !ruby/object:Gem::Requirement
17
+
18
+ date: 2012-02-27 00:00:00 Z
19
+ dependencies:
20
+ - !ruby/object:Gem::Dependency
21
+ version_requirements: &id001 !ruby/object:Gem::Requirement
17
22
  none: false
18
- requirements:
19
- - - ! '>='
20
- - !ruby/object:Gem::Version
21
- version: '0'
23
+ requirements:
24
+ - - ">="
25
+ - !ruby/object:Gem::Version
26
+ hash: 3
27
+ segments:
28
+ - 0
29
+ version: "0"
30
+ prerelease: false
31
+ requirement: *id001
22
32
  type: :development
33
+ name: guard
34
+ - !ruby/object:Gem::Dependency
35
+ version_requirements: &id002 !ruby/object:Gem::Requirement
36
+ none: false
37
+ requirements:
38
+ - - ">="
39
+ - !ruby/object:Gem::Version
40
+ hash: 3
41
+ segments:
42
+ - 0
43
+ version: "0"
23
44
  prerelease: false
24
- version_requirements: *70134689089720
25
- - !ruby/object:Gem::Dependency
45
+ requirement: *id002
46
+ type: :development
26
47
  name: minitest
27
- requirement: &70134689089300 !ruby/object:Gem::Requirement
48
+ - !ruby/object:Gem::Dependency
49
+ version_requirements: &id003 !ruby/object:Gem::Requirement
28
50
  none: false
29
- requirements:
30
- - - ! '>='
31
- - !ruby/object:Gem::Version
32
- version: '0'
33
- type: :development
51
+ requirements:
52
+ - - ">="
53
+ - !ruby/object:Gem::Version
54
+ hash: 3
55
+ segments:
56
+ - 0
57
+ version: "0"
34
58
  prerelease: false
35
- version_requirements: *70134689089300
36
- - !ruby/object:Gem::Dependency
59
+ requirement: *id003
60
+ type: :runtime
37
61
  name: rake
38
- requirement: &70134689088880 !ruby/object:Gem::Requirement
62
+ - !ruby/object:Gem::Dependency
63
+ version_requirements: &id004 !ruby/object:Gem::Requirement
39
64
  none: false
40
- requirements:
41
- - - ! '>='
42
- - !ruby/object:Gem::Version
43
- version: '0'
44
- type: :runtime
65
+ requirements:
66
+ - - ">="
67
+ - !ruby/object:Gem::Version
68
+ hash: 3
69
+ segments:
70
+ - 0
71
+ version: "0"
45
72
  prerelease: false
46
- version_requirements: *70134689088880
47
- - !ruby/object:Gem::Dependency
73
+ requirement: *id004
74
+ type: :runtime
48
75
  name: erubis
49
- requirement: &70134689088460 !ruby/object:Gem::Requirement
76
+ - !ruby/object:Gem::Dependency
77
+ version_requirements: &id005 !ruby/object:Gem::Requirement
50
78
  none: false
51
- requirements:
52
- - - ! '>='
53
- - !ruby/object:Gem::Version
54
- version: '0'
55
- type: :runtime
79
+ requirements:
80
+ - - ~>
81
+ - !ruby/object:Gem::Version
82
+ hash: 1
83
+ segments:
84
+ - 2
85
+ - 1
86
+ version: "2.1"
56
87
  prerelease: false
57
- version_requirements: *70134689088460
58
- - !ruby/object:Gem::Dependency
88
+ requirement: *id005
89
+ type: :runtime
59
90
  name: redcarpet
60
- requirement: &70134689087960 !ruby/object:Gem::Requirement
91
+ - !ruby/object:Gem::Dependency
92
+ version_requirements: &id006 !ruby/object:Gem::Requirement
61
93
  none: false
62
- requirements:
94
+ requirements:
63
95
  - - ~>
64
- - !ruby/object:Gem::Version
65
- version: '2.1'
66
- type: :runtime
96
+ - !ruby/object:Gem::Version
97
+ hash: 15
98
+ segments:
99
+ - 0
100
+ - 2
101
+ version: "0.2"
67
102
  prerelease: false
68
- version_requirements: *70134689087960
69
- - !ruby/object:Gem::Dependency
70
- name: pygments.rb
71
- requirement: &70134689087460 !ruby/object:Gem::Requirement
72
- none: false
73
- requirements:
74
- - - ~>
75
- - !ruby/object:Gem::Version
76
- version: '0.2'
103
+ requirement: *id006
77
104
  type: :runtime
78
- prerelease: false
79
- version_requirements: *70134689087460
80
- description: A simple framework for writing and generating beautiful documentation
81
- for your code
82
- email:
105
+ name: pygments.rb
106
+ description: A simple framework for writing and generating beautiful documentation for your code
107
+ email:
83
108
  - mick@staugaard.com
84
109
  executables: []
110
+
85
111
  extensions: []
112
+
86
113
  extra_rdoc_files: []
87
- files:
114
+
115
+ files:
88
116
  - lib/double_doc/doc_extractor.rb
89
117
  - lib/double_doc/html_generator.rb
90
118
  - lib/double_doc/html_renderer.rb
@@ -101,28 +129,37 @@ files:
101
129
  - test/test_helper.rb
102
130
  homepage: http://staugaard.github.com/double_doc
103
131
  licenses: []
132
+
104
133
  post_install_message:
105
134
  rdoc_options: []
106
- require_paths:
135
+
136
+ require_paths:
107
137
  - lib
108
- required_ruby_version: !ruby/object:Gem::Requirement
138
+ required_ruby_version: !ruby/object:Gem::Requirement
109
139
  none: false
110
- requirements:
111
- - - ! '>='
112
- - !ruby/object:Gem::Version
113
- version: '0'
114
- required_rubygems_version: !ruby/object:Gem::Requirement
140
+ requirements:
141
+ - - ">="
142
+ - !ruby/object:Gem::Version
143
+ hash: 3
144
+ segments:
145
+ - 0
146
+ version: "0"
147
+ required_rubygems_version: !ruby/object:Gem::Requirement
115
148
  none: false
116
- requirements:
117
- - - ! '>='
118
- - !ruby/object:Gem::Version
119
- version: '0'
149
+ requirements:
150
+ - - ">="
151
+ - !ruby/object:Gem::Version
152
+ hash: 3
153
+ segments:
154
+ - 0
155
+ version: "0"
120
156
  requirements: []
157
+
121
158
  rubyforge_project:
122
- rubygems_version: 1.8.16
159
+ rubygems_version: 1.8.15
123
160
  signing_key:
124
161
  specification_version: 3
125
162
  summary: Documentation right where you want it
126
- test_files:
163
+ test_files:
127
164
  - test/doc_extractor_test.rb
128
165
  - test/test_helper.rb