public
Fork of mislav/will_paginate
Description: Most awesome pagination solution for Rails
Homepage: http://github.com/mislav/will_paginate/wikis
Clone URL: git://github.com/technoweenie/will_paginate.git
Search Repo:
clean up README; point people to examples/index.html
mislav (author)
Sun Apr 06 17:00:55 -0700 2008
commit  1cc5730e1f94e54467b7cdfc2bee199d29424223
tree    151a964fe5d36b051026ef6db0d255fd6aa6ced6
parent  4d7de72f8df3b75069973b755231660b07783524
...
9
10
11
12
13
 
14
15
16
 
 
 
 
 
 
17
18
19
20
21
22
23
24
25
26
27
28
 
 
29
 
 
30
31
32
 
33
34
35
36
...
37
38
39
40
41
42
 
 
 
43
44
45
46
47
48
49
50
...
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
...
137
138
139
 
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
 
 
173
174
175
...
9
10
11
 
 
12
13
 
 
14
15
16
17
18
19
20
21
22
 
 
23
24
25
26
 
 
 
27
28
29
30
31
32
33
 
34
35
36
37
38
...
39
40
41
 
 
 
42
43
44
45
 
 
 
46
47
48
49
...
101
102
103
 
104
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
105
106
107
108
...
119
120
121
122
123
124
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
125
126
127
128
129
0
@@ -9,27 +9,29 @@
0
 ... and then render the page links with a single view helper? Well, now you
0
 can.
0
 
0
-Ryan Bates made an awesome screencast[http://railscasts.com/episodes/51],
0
-check it out.
0
+Some resources to get you started:
0
 
0
-Your mind reels with questions? Join our Google
0
-group[http://groups.google.com/group/will_paginate].
0
+* Your mind reels with questions? Join our Google
0
+ group[http://groups.google.com/group/will_paginate].
0
+* The will_paginate project page: http://github.com/mislav/will_paginate
0
+* How to report bugs: http://github.com/mislav/will_paginate/wikis/report-bugs
0
+* Ryan Bates made an awesome screencast[http://railscasts.com/episodes/51],
0
+ check it out.
0
 
0
 == Installation
0
 
0
-Will Paginate officially supports Rails versions 1.2.6 and 2.0.x.
0
-
0
 Previously, the plugin was available on the following SVN location:
0
 
0
   svn://errtheblog.com/svn/plugins/will_paginate
0
 
0
-In February 2008, it moved to GitHub[http://github.com/mislav/will_paginate/tree]
0
-to be tracked with git. The SVN repo continued to have updates, but not
0
-forever. Therefore you should switch to using the gem:
0
+In February 2008, it moved to GitHub to be tracked with git version control.
0
+The SVN repo continued to have updates for some time, but now it doesn't.
0
 
0
+You should switch to using the gem:
0
+
0
   gem install will_paginate
0
 
0
-After that, you can remove the plugin from your applications and add
0
+After that, you can remove the plugin from your application and add
0
 a simple require to the end of config/environment.rb:
0
 
0
   require 'will_paginate'
0
0
@@ -37,13 +39,10 @@
0
 That's it, just remember to install the gem on all machines that
0
 you are deploying to.
0
 
0
-The second option is to download and extract the tarball from GitHub. Here is the
0
-link for downloading the current state of the master branch:
0
-http://github.com/mislav/will_paginate/tarball/master
0
+<i>There are extensive
0
+installation[http://github.com/mislav/will_paginate/wikis/installation]
0
+instructions on the wiki[http://github.com/mislav/will_paginate/wikis].</i>
0
 
0
-Extract it to <tt>vendor/plugins</tt>. The directory will have a default name
0
-like "mislav-will_paginate-master"; you can rename it to "will_paginate" for
0
-simplicity.
0
 
0
 == Example usage
0
 
0
0
@@ -102,24 +101,7 @@
0
 * WillPaginate::Finder::ClassMethods for pagination on your models;
0
 * WillPaginate::ViewHelpers for your views.
0
 
0
-== Oh noes, a bug!
0
 
0
-Tell us what happened so we can fix it, quick! Issues are filed on the Lighthouse project:
0
-http://err.lighthouseapp.com/projects/466-plugins/tickets?q=tagged:will_paginate
0
-
0
-Steps to make an awesome bug report:
0
-
0
-1. Run <tt>rake test</tt> in the <i>will_paginate</i> directory. (You will need SQLite3.)
0
- Copy the output if there are failing tests.
0
-2. Register on Lighthouse to create a new ticket.
0
-3. Write a descriptive, short title. Provide as much info as you can in the body.
0
- Assign the ticket to Mislav and tag it with meaningful tags, <tt>"will_paginate"</tt>
0
- being among them.
0
-4. Yay! You will be notified on updates automatically.
0
-
0
-Here is an example of a great bug report and patch:
0
-http://err.lighthouseapp.com/projects/466/tickets/172-total_entries-ignored-in-paginate_by_sql
0
-
0
 == Authors, credits, contact
0
 
0
 Want to discuss, request features, ask questions? Join the Google group:
0
0
@@ -137,39 +119,11 @@
0
 van Zuijlen, Maria, Brendan Ribera, Todd Willey, Bryan Helmkamp, Jan Berkel,
0
 Lourens Naudé.
0
 
0
+
0
 == Usable pagination in the UI
0
 
0
-Copy the following CSS into your stylesheet for a good start:
0
-
0
- .pagination {
0
- padding: 3px;
0
- margin: 3px;
0
- }
0
- .pagination a {
0
- padding: 2px 5px 2px 5px;
0
- margin: 2px;
0
- border: 1px solid #aaaadd;
0
- text-decoration: none;
0
- color: #000099;
0
- }
0
- .pagination a:hover, .pagination a:active {
0
- border: 1px solid #000099;
0
- color: #000;
0
- }
0
- .pagination span.current {
0
- padding: 2px 5px 2px 5px;
0
- margin: 2px;
0
- border: 1px solid #000099;
0
- font-weight: bold;
0
- background-color: #000099;
0
- color: #FFF;
0
- }
0
- .pagination span.disabled {
0
- padding: 2px 5px 2px 5px;
0
- margin: 2px;
0
- border: 1px solid #eee;
0
- color: #ddd;
0
- }
0
+There are some CSS styles to get you started in the "examples/" directory. They
0
+are showcased in the <b>"examples/index.html"</b> file.
0
 
0
 More reading about pagination as design pattern:
0
 
...
65
66
67
68
 
69
...
65
66
67
 
68
69
0
@@ -65,6 +65,6 @@
0
   rdoc.rdoc_dir = 'doc' # rdoc output folder
0
   rdoc.options << '--inline-source'
0
   rdoc.options << '--charset=UTF-8'
0
- rdoc.options << '--webcvs="http://github.com/mislav/will_paginate/tree/master/%s"'
0
+ rdoc.options << '--webcvs=http://github.com/mislav/will_paginate/tree/master/'
0
 end

Comments

    No one has commented yet.