turbo-generators 0.0.0 → 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. data/README.rdoc +77 -1
  2. data/VERSION +1 -1
  3. data/turbo-generators.gemspec +1 -1
  4. metadata +1 -1
data/README.rdoc CHANGED
@@ -1 +1,77 @@
1
- At this precise moment the code is not stable for download or use. I'm working as fast as i can though and should have something available ready soon.
1
+ = Welcome to turbo-generators
2
+ This is a work in progress. It's my first attempt at writing a gem. Well I say 'write' when I actually mean 'copy'.
3
+ Much of the code has been shamelessly stolen from ryanb's nifty-generators. Thanks ryan.
4
+ The reason I have created a brand new gem is because it does one or two extra things.
5
+
6
+
7
+ The gem is quite quirky right now in version 0.0.1 and is probably only really of use to myself in it's current state.
8
+
9
+
10
+ = Installation
11
+
12
+ First make sure that you have gemcutter gem installed and tumbled by doing:
13
+ gem install gemcutter
14
+ gem tumble
15
+ (don't forget to use 'sudo' command if you are on mac or linux)
16
+
17
+ Then install the turbo-generators:
18
+
19
+ gem install turbo-generators
20
+
21
+
22
+ = Usage:
23
+ I created the gem to be used along with my rails application template - http://github.com/murdoch/rails-templates
24
+ You can create a rails app using that template by typing:
25
+ rails my_app -m http://github.com/murdoch/rails-templates/raw/master/base_template.rb
26
+
27
+ = What do these generators do then?
28
+
29
+ You will now have access to two new generators that you can run from within your rails apps:
30
+ * sript/generate turbo_layout
31
+ * script/generate turbo_blog
32
+
33
+ = Gotchas
34
+
35
+ Presently the turbo_blog generator requires you to have a user model named user.rb. If you don't then it probably won't work. The easiest way to make sure you hae a model called user.rb is by ryanb' nifty_authentication generator.
36
+ I would like my gem to be more flexible so in future versions you will be able to accomodate different authentication setups.
37
+
38
+ Also, the blog resource that is setup by the turbo_blog generator is by default called Post. This suits me but you might not like that so in future version users will be able to specify a differnent name for the resource. For now though, blog resources will be available from localhost:3000/posts.....
39
+ You must create a user and login before you can create new posts.
40
+
41
+ = About turbo_layout
42
+ Right now it just creates a simple layout - I will work hard on improving this over the next few weeks as it's quite important to me to have a good starting point.
43
+
44
+ The turbo_layout uses blueprint css but it does not use compass or sas yet - this is coming soon once I've figured out how to use them myself.
45
+
46
+ Turbo_layout currently looks very dull and very boring but like I said, I'm going to work really hard on getting this up to the standard that I require for my apps.
47
+
48
+ = About turbo_blog
49
+ As mentioned, turbo_blog requires you to have a user model called user.rb setup. This can be achieved by installing ryanb's nifty-generators and running 'script/generate nifty_authenticaion' from within your rails app.
50
+
51
+ Future versions of the gem will allow you to specify the name of your user model.
52
+
53
+ = Example use
54
+
55
+ * create a new rails app by typing:
56
+ rails test
57
+ * run ryanb's nifty_authentication generator
58
+ script/generate nifty_authentication
59
+ * run turbo_layout generator
60
+ script/generate turbo_layout
61
+ * rub turbo_blog generater
62
+ script/generator turbo_blog
63
+ * run the migrations
64
+ rake db:create
65
+ rake db:migrate
66
+
67
+ = How do I see my blog posts?
68
+ Create a user by going to localhost:3000/signup - Login - Go to localhost:3000/posts
69
+
70
+ = Finally.
71
+ This is my first gem. This is new to me to be honest. I know my generated template presently lacks a lot of features but I need to start somewhere and this gem will get much better. I promise. There's much more to come. If you have any ideas, suggestions or complainst please email me at stephen@stephenmurdoch.eu and I'll see what I can do
72
+
73
+ Thanks - and yeah, I know, my code is quite messy, and my template is a bit plain and boring - but I am goign to fix all that soon.
74
+
75
+ Steve
76
+
77
+
data/VERSION CHANGED
@@ -1 +1 @@
1
- 0.0.0
1
+ 0.0.1
@@ -5,7 +5,7 @@
5
5
 
6
6
  Gem::Specification.new do |s|
7
7
  s.name = %q{turbo-generators}
8
- s.version = "0.0.0"
8
+ s.version = "0.0.1"
9
9
 
10
10
  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
11
11
  s.authors = ["Stephen Murdoch"]
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: turbo-generators
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.0.0
4
+ version: 0.0.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Stephen Murdoch