Created
July 3, 2019 15:58
-
-
Save palaniraja/a12b884f16a1df1bff3212f16692db57 to your computer and use it in GitHub Desktop.
output of "jazzy --help config" from jazzy version: 0.9.6
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
By default, jazzy looks for a file named ".jazzy.yaml" in the source | |
directory and its ancestors. You can override the config file location | |
with --config. | |
(The source directory is the current working directory by default. | |
You can override that with --source-directory.) | |
The config file can be in YAML or JSON format. Available options are: | |
OUTPUT | |
Config file: output | |
Command line: -o, --output FOLDER | |
Folder to output the HTML docs to | |
Default: docs | |
CLEAN | |
Config file: clean | |
Command line: -c, --[no-]clean | |
Delete contents of output directory before running. | |
WARNING: If --output is set to ~/Desktop, this will delete the ~/Desktop directory. | |
OBJC MODE | |
Config file: objc | |
Command line: --[no-]objc | |
Generate docs for Objective-C. | |
UMBRELLA HEADER | |
Config file: umbrella_header | |
Command line: --umbrella-header PATH | |
Umbrella header for your Objective-C framework. | |
FRAMEWORK ROOT | |
Config file: framework_root | |
Command line: --framework-root PATH | |
The root path to your Objective-C framework. | |
SDK | |
Config file: sdk | |
Command line: --sdk [iphone|watch|appletv][os|simulator]|macosx | |
The SDK for which your code should be built. | |
Default: macosx | |
HIDE DECLARATIONS | |
Config file: hide_declarations | |
Command line: --hide-declarations [objc|swift] | |
Hide declarations in the specified language. Given that generating Swift docs only generates Swift declarations, this is only really useful to display just the Swift declarations & names when generating docs for an Objective-C framework. | |
CONFIG FILE | |
Config file: config | |
Command line: --config PATH | |
Configuration file (.yaml or .json) | |
Default: .jazzy.yaml in source directory or ancestor | |
XCODEBUILD ARGUMENTS | |
Config file: xcodebuild_arguments | |
Command line: -x, --xcodebuild-arguments arg1,arg2,…argN | |
Arguments to forward to xcodebuild | |
Default: [] | |
SOURCEKITTEN SOURCEFILE | |
Config file: sourcekitten_sourcefile | |
Command line: -s, --sourcekitten-sourcefile FILEPATH | |
File generated from sourcekitten output to parse | |
SOURCE DIRECTORY | |
Config file: source_directory | |
Command line: --source-directory DIRPATH | |
The directory that contains the source to be documented | |
Default: /Users/palaniraja/Desktop/ADC/source/try/objc-dependency-visualizer | |
EXCLUDED FILES | |
Config file: exclude | |
Command line: -e, --exclude filepath1,filepath2,…filepathN | |
Source file pathnames to be excluded from documentation. Supports wildcards. | |
Default: [] | |
INCLUDED FILES | |
Config file: include | |
Command line: -i, --include filepath1,filepath2,…filepathN | |
Source file pathnames to be included in documentation. Supports wildcards. | |
Default: [] | |
SWIFT VERSION | |
Config file: swift_version | |
Command line: --swift-version VERSION | |
AUTHOR NAME | |
Config file: author | |
Command line: -a, --author AUTHOR_NAME | |
Name of author to attribute in docs (e.g. Realm) | |
AUTHOR URL | |
Config file: author_url | |
Command line: -u, --author_url URL | |
Author URL of this project (e.g. https://realm.io) | |
MODULE NAME | |
Config file: module | |
Command line: -m, --module MODULE_NAME | |
Name of module being documented. (e.g. RealmSwift) | |
VERSION | |
Config file: module_version | |
Command line: --module-version VERSION | |
module version. will be used when generating docset | |
Default: 1.0 | |
COPYRIGHT | |
Config file: copyright | |
Command line: --copyright COPYRIGHT_MARKDOWN | |
copyright markdown rendered at the bottom of the docs pages | |
README PATH | |
Config file: readme | |
Command line: --readme FILEPATH | |
The path to a markdown README file | |
DOCUMENTATION GLOB | |
Config file: documentation | |
Command line: --documentation GLOB | |
Glob that matches available documentation | |
ABSTRACT GLOB | |
Config file: abstract | |
Command line: --abstract GLOB | |
Glob that matches available abstracts for categories | |
PODSPEC | |
Config file: podspec | |
Command line: --podspec FILEPATH | |
A CocoaPods Podspec that describes the Swift library to document | |
DOCSET ICON | |
Config file: docset_icon | |
Command line: --docset-icon FILEPATH | |
DOCSET PATH | |
Config file: docset_path | |
Command line: --docset-path DIRPATH | |
The relative path for the generated docset | |
ROOT URL | |
Config file: root_url | |
Command line: -r, --root-url URL | |
Absolute URL root where these docs will be stored | |
DASH URL | |
Config file: dash_url | |
Command line: -d, --dash_url URL | |
Location of the dash XML feed e.g. https://realm.io/docsets/realm.xml) | |
GITHUB URL | |
Config file: github_url | |
Command line: -g, --github_url URL | |
GitHub URL of this project (e.g. https://github.com/realm/realm-cocoa) | |
GITHUB FILE PREFIX | |
Config file: github_file_prefix | |
Command line: --github-file-prefix PREFIX | |
GitHub URL file prefix of this project (e.g. https://github.com/realm/realm-cocoa/tree/v0.87.1) | |
DISABLE SEARCH | |
Config file: disable_search | |
Command line: --disable-search | |
Avoid generating a search index. Search is available in some themes. | |
SKIP DOCUMENTATION | |
Config file: skip_documentation | |
Command line: --skip-documentation | |
Will skip the documentation generation phase. | |
MIN ACL | |
Config file: min_acl | |
Command line: --min-acl [private | fileprivate | internal | public | open] | |
minimum access control level to document | |
Default: public | |
SKIP UNDOCUMENTED | |
Config file: skip_undocumented | |
Command line: --[no-]skip-undocumented | |
Don't document declarations that have no documentation comments. | |
HIDE DOCUMENTATION COVERAGE | |
Config file: hide_documentation_coverage | |
Command line: --[no-]hide-documentation-coverage | |
Hide "(X% documented)" from the generated documents | |
CUSTOM CATEGORIES | |
Config file: custom_categories | |
Custom navigation categories to replace the standard “Classes, Protocols, etc.” | |
Types not explicitly named in a custom category appear in generic groups at the end. | |
Example: https://git.io/v4Bcp | |
Default: [] | |
CUSTOM HEAD | |
Config file: head | |
Command line: --head HTML | |
Custom HTML to inject into <head></head>. | |
THEME DIRECTORY | |
Config file: theme | |
Command line: --theme [apple | fullwidth | jony | DIRPATH] | |
Which theme to use. Specify either 'apple' (default), one of the other built-in theme names, or the path to your mustache templates and other assets for a custom theme. | |
Default: apple | |
USE SAFE FILENAMES | |
Config file: use_safe_filenames | |
Command line: --use-safe-filenames | |
Replace unsafe characters in filenames with an encoded representation. This will reduce human readability of some URLs, but may be necessary for projects that expose filename-unfriendly functions such as /(_:_:) | |
TEMPLATE DIRECTORY | |
Config file: template_directory | |
Command line: -t, --template-directory DIRPATH | |
DEPRECATED: Use --theme instead. | |
ASSETS DIRECTORY | |
Config file: assets_directory | |
Command line: --assets-directory DIRPATH | |
DEPRECATED: Use --theme instead. | |
UNDOCUMENTED TEXT | |
Config file: undocumented_text | |
Command line: --undocumented-text UNDOCUMENTED_TEXT | |
Default text for undocumented symbols. The default is "Undocumented", put "" if no text is required | |
Default: Undocumented |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment