yard-api 0.1.6 → 0.1.7
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.
- checksums.yaml +4 -4
- data/config/yard_api.yml +86 -0
- data/lib/yard-api/version.rb +1 -1
- data/yard-api.gemspec +1 -1
- metadata +2 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA1:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: dac4ffe3bb1f27996a4b7a8254976e53914e8f56
|
|
4
|
+
data.tar.gz: cc9172e66ddc41ee29c4e524241c011e94e47e74
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 6e253215dfd08a10c0a80b92f44b0d2f3f9ea7b1d60782a2ee3b569dac08e4cb4e331eefee265235dcbb6d140e40a06b9184b81e66258964b3238c324a397870
|
|
7
|
+
data.tar.gz: b2cee8fb44be95d68d2a172a8df616426155313ba5024940c7f8bdab25efde6ff17792260e334f618b918733328e054aee572f9e5f915dbca6ef07ec280a597d
|
data/config/yard_api.yml
ADDED
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
---
|
|
2
|
+
# config/yard_api.yml
|
|
3
|
+
output: public/doc/api
|
|
4
|
+
source: doc/api
|
|
5
|
+
readme: doc/api/README.md
|
|
6
|
+
|
|
7
|
+
# Title of the project. This will be displayed in the browser title bar as well
|
|
8
|
+
# as in the layout as the primary heading.
|
|
9
|
+
title: Rails API Project
|
|
10
|
+
|
|
11
|
+
# The resource index is a mega-index page that contains all the API resources.
|
|
12
|
+
resource_index: true
|
|
13
|
+
|
|
14
|
+
# Generate a single page that contains all the static pages and API resources.
|
|
15
|
+
# The output will be a single file.
|
|
16
|
+
#
|
|
17
|
+
# Implies "resource_index" is true.
|
|
18
|
+
one_file: false
|
|
19
|
+
|
|
20
|
+
# YARD options passed as-is.
|
|
21
|
+
#
|
|
22
|
+
# If you want to use github-flavored markdown, use "redcparet" as a markup
|
|
23
|
+
# provider, and "markdown" as a markup and add the following gems to your
|
|
24
|
+
# Gemfile *before* yard-api:
|
|
25
|
+
#
|
|
26
|
+
# - "github-markup"
|
|
27
|
+
# - "redcarpet"
|
|
28
|
+
markup:
|
|
29
|
+
markup_provider:
|
|
30
|
+
|
|
31
|
+
# The API files to extract the docs from.
|
|
32
|
+
files:
|
|
33
|
+
- app/controllers/**/*.rb
|
|
34
|
+
|
|
35
|
+
# YARD assets that you want to reference from your docs. The key is the
|
|
36
|
+
# reference key you use in the docs, while the value is the path to where
|
|
37
|
+
# the assets are located relative to the doc source.
|
|
38
|
+
#
|
|
39
|
+
# These folders will be copied to the output directory.
|
|
40
|
+
#
|
|
41
|
+
# See "source" and "output".
|
|
42
|
+
assets:
|
|
43
|
+
images: images
|
|
44
|
+
examples: examples
|
|
45
|
+
|
|
46
|
+
# Debug option. YARD and YARD-API verbosity option.
|
|
47
|
+
verbose: true
|
|
48
|
+
|
|
49
|
+
# Debug option, will write *a lot* of stuff to STDOUT while generating.
|
|
50
|
+
debug: false
|
|
51
|
+
|
|
52
|
+
# Don't tolerate any errors such as bad asset paths, invalid tag properties, etc.
|
|
53
|
+
strict: false
|
|
54
|
+
|
|
55
|
+
# Each API endpoint details can provide a link to the source code of the
|
|
56
|
+
# controller method if it's available on GitHub.
|
|
57
|
+
#
|
|
58
|
+
# Just specify the url to your repository and the branch the documentation has
|
|
59
|
+
# been generated for and things "should work".
|
|
60
|
+
github_url: https://github.com/amireh/yard-api
|
|
61
|
+
github_branch: master
|
|
62
|
+
|
|
63
|
+
# Set to true if you want @argument tags to show up in a table instead of a list.
|
|
64
|
+
tabular_arguments: false
|
|
65
|
+
|
|
66
|
+
# When this option is set, all @argument tags that do not explicitly specify
|
|
67
|
+
# whether they are required or optional will be marked as required. Examples:
|
|
68
|
+
#
|
|
69
|
+
# - @argument [String] name # assumed to be required
|
|
70
|
+
# - @argument [Optional, String] name # is now optional
|
|
71
|
+
# - @argument [Required, String] name # same effect if `strict_arguments` is true
|
|
72
|
+
#
|
|
73
|
+
# Conversely, leaving this to false marks all arguments with no specifier as
|
|
74
|
+
# optional.
|
|
75
|
+
strict_arguments: true
|
|
76
|
+
|
|
77
|
+
# Width of the sidebar, in pixels.
|
|
78
|
+
sidebar_width: 240
|
|
79
|
+
|
|
80
|
+
# Width of the content box in pixels, or "fluid" for maximum screen space.
|
|
81
|
+
#
|
|
82
|
+
# Content will never overlap with the sidebar.
|
|
83
|
+
content_width: "fluid"
|
|
84
|
+
|
|
85
|
+
# Whitespace between the Sidebar and the content, in pixels.
|
|
86
|
+
spacer: 20
|
data/lib/yard-api/version.rb
CHANGED
data/yard-api.gemspec
CHANGED
|
@@ -11,7 +11,7 @@ Gem::Specification.new do |s|
|
|
|
11
11
|
s.authors = ["Ahmad Amireh"]
|
|
12
12
|
s.email = 'ahmad@instructure.com'
|
|
13
13
|
s.homepage = 'https://github.com/amireh/yard-api'
|
|
14
|
-
s.files = Dir.glob("{lib,spec,templates,tasks}/**/*.{rb,erb,rake}") +
|
|
14
|
+
s.files = Dir.glob("{config,lib,spec,templates,tasks}/**/*.{yml,rb,erb,rake}") +
|
|
15
15
|
['LICENSE', 'README.md', '.rspec', __FILE__]
|
|
16
16
|
s.has_rdoc = 'yard'
|
|
17
17
|
s.license = 'AGPL3'
|
metadata
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: yard-api
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.1.
|
|
4
|
+
version: 0.1.7
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Ahmad Amireh
|
|
@@ -76,6 +76,7 @@ files:
|
|
|
76
76
|
- ".rspec"
|
|
77
77
|
- LICENSE
|
|
78
78
|
- README.md
|
|
79
|
+
- config/yard_api.yml
|
|
79
80
|
- lib/yard-api.rb
|
|
80
81
|
- lib/yard-api/markup/redcarpet.rb
|
|
81
82
|
- lib/yard-api/options.rb
|