Skip to content
Projects
Groups
Snippets
Help
This project
Loading...
Sign in / Register
Toggle navigation
A
annotate
Project
Overview
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
open-source
annotate
Commits
12be4907
Commit
12be4907
authored
Nov 01, 2013
by
T.J. Schuck
Committed by
T.J. Schuck
Dec 01, 2013
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Use RDoc inline-code formatting
parent
5a0ef884
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
18 additions
and
19 deletions
+18
-19
README.rdoc
README.rdoc
+18
-19
No files found.
README.rdoc
View file @
12be4907
...
@@ -33,7 +33,7 @@ The schema comment looks like this:
...
@@ -33,7 +33,7 @@ The schema comment looks like this:
. . .
. . .
It also annotates geometrical columns, geom type and srid, when using
It also annotates geometrical columns, geom type and srid, when using
`SpatialAdapter`, `PostgisAdapter` or `PostGISAdapter`
:
+SpatialAdapter+, +PostgisAdapter+ or +PostGISAdapter+
:
# == Schema Info
# == Schema Info
#
#
...
@@ -43,7 +43,7 @@ It also annotates geometrical columns, geom type and srid, when using
...
@@ -43,7 +43,7 @@ It also annotates geometrical columns, geom type and srid, when using
# path :geometry line_string, 4326
# path :geometry line_string, 4326
Also, if you pass the -r option, it'll annotate routes.rb with the output of
Also, if you pass the -r option, it'll annotate routes.rb with the output of
`rake routes`
.
+rake routes+
.
== Install
== Install
...
@@ -70,7 +70,7 @@ Into environment gems from Github checkout:
...
@@ -70,7 +70,7 @@ Into environment gems from Github checkout:
== Usage
== Usage
(If you used the Gemfile install, prefix the below commands with
`bundle exec`
.)
(If you used the Gemfile install, prefix the below commands with
+bundle exec+
.)
=== Usage in Rails
=== Usage in Rails
...
@@ -105,9 +105,9 @@ To remove routes.rb annotations:
...
@@ -105,9 +105,9 @@ To remove routes.rb annotations:
=== Usage Outside of Rails
=== Usage Outside of Rails
Everything above applies, except that
--routes
is not meaningful, and you will
Everything above applies, except that
+--routes+
is not meaningful, and you will
probably need to explicitly set one or more
`--require`
option(s), and/or one
probably need to explicitly set one or more
+--require+
option(s), and/or one
or more
`--model-dir`
options to inform annotate about the structure of your
or more
+--model-dir+
options to inform annotate about the structure of your
project and help it bootstrap and load the relevant code.
project and help it bootstrap and load the relevant code.
...
@@ -121,7 +121,7 @@ anywhere in the file:
...
@@ -121,7 +121,7 @@ anywhere in the file:
=== Configuration in Rails
=== Configuration in Rails
To generate a configuration file (in the form of a
`.rake`
file), to set
To generate a configuration file (in the form of a
+.rake+
file), to set
default options:
default options:
rails g annotate:install
rails g annotate:install
...
@@ -132,8 +132,8 @@ added (top or bottom of file), and in which artifacts.
...
@@ -132,8 +132,8 @@ added (top or bottom of file), and in which artifacts.
== Rails Integration
== Rails Integration
By default, once you've generated a configuration file, annotate will be
By default, once you've generated a configuration file, annotate will be
executed whenever you run
`rake db:migrate`
(but only in development mode).
executed whenever you run
+rake db:migrate+
(but only in development mode).
If you want to disable this behavior permanently, edit the
`.rake`
file and
If you want to disable this behavior permanently, edit the
+.rake+
file and
change:
change:
'skip_on_db_migrate' => "false",
'skip_on_db_migrate' => "false",
...
@@ -142,9 +142,9 @@ To:
...
@@ -142,9 +142,9 @@ To:
'skip_on_db_migrate' => "true",
'skip_on_db_migrate' => "true",
If you want to run
`rake db:migrate`
as a one-off without running annotate,
If you want to run
+rake db:migrate+
as a one-off without running annotate,
you can do so with a simple environment variable, instead of editing the
you can do so with a simple environment variable, instead of editing the
`.rake`
file:
+.rake+
file:
skip_on_db_migrate=1 rake db:migrate
skip_on_db_migrate=1 rake db:migrate
...
@@ -188,21 +188,21 @@ migrations were run).
...
@@ -188,21 +188,21 @@ migrations were run).
If you prefer to sort alphabetically so that the results of
If you prefer to sort alphabetically so that the results of
annotation are consistent regardless of what order migrations are executed in,
annotation are consistent regardless of what order migrations are executed in,
use
--sort
.
use
+--sort+
.
== Markdown
== Markdown
The format produced is actually MultiMarkdown, making use of the syntax
The format produced is actually MultiMarkdown, making use of the syntax
extension for tables. It's recommended you use
`kramdown`
as your parser if
extension for tables. It's recommended you use
+kramdown+
as your parser if
you want to use this format. If you're using
`yard`
to generate documentation,
you want to use this format. If you're using
+yard+
to generate documentation,
specify a format of markdown with
`kramdown`
as the provider by adding this to
specify a format of markdown with
+kramdown+
as the provider by adding this to
your
`.yardopts`
file:
your
+.yardopts+
file:
--markup markdown
--markup markdown
--markup-provider kramdown
--markup-provider kramdown
Be sure to add this to your
`Gemfile`
as well:
Be sure to add this to your
+Gemfile+
as well:
gem 'kramdown', :groups => [:development], :require => false
gem 'kramdown', :groups => [:development], :require => false
...
@@ -214,7 +214,7 @@ will blow away the initial/final comment block in your models if it looks like
...
@@ -214,7 +214,7 @@ will blow away the initial/final comment block in your models if it looks like
it was previously added by this gem.
it was previously added by this gem.
Be sure to check the changes that this tool makes! If you are using Git,
Be sure to check the changes that this tool makes! If you are using Git,
you may simply check your project's status after running
`annotate`
:
you may simply check your project's status after running
+annotate+
:
$ git status
$ git status
...
@@ -244,4 +244,3 @@ Released under the same license as Ruby. No Support. No Warranty.
...
@@ -244,4 +244,3 @@ Released under the same license as Ruby. No Support. No Warranty.
== Authors
== Authors
{See AUTHORS.rdoc}[link:AUTHORS.rdoc].
{See AUTHORS.rdoc}[link:AUTHORS.rdoc].
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment