Repository files navigation

CocoaDocs was deprecated back inearly 2015 and now hasa replacement for the CocoaPods-specific infrastructure. If you've come to get help about a CocoaDocs page, I'm afraid it doesn't exist anymore.

If you're wanting to debug your own library, please consult theISSUE_TEMPLATE.md.

CocoaDocs is essentially 2 tools, one is a script for generating complex appledoc templates and the other is a server aspect for reacting to webhook notifications.

1. git clonegit@github.com:CocoaPods/cocoadocs.org.git
2. cd cocoadocs.org
3. bundle install
4. bundle exec rake install_tools

Theinstall_tools tasks will install the additional tools required for CocoaDocs to work:

* [cloc](https://github.com/AlDanial/cloc)* [appledoc](https://github.com/tomaz/appledoc)* [carthage](https://github.com/Carthage/Carthage)* [AWS' official CLI tool](https://aws.amazon.com/cli/)

CocoaDocs receives webhook notifications from theCocoaPods/Specs repo on GitHub whenever a CocoaPod is updated.

A Swift Pod will create documentationusing Jazzy. If this fails, perhaps due to new Swift version support, than it will fall back to Objective-C. AnObjective-C Pod will use Appledoc to parse your library.

If you have a Swift library and it's only showing Objective-C classes (or no classes) then Jazzy has crashed on your library, we'd recommend testing that out locally.

• For Objective-C projects, you have the ability to edit the styling of CocoaDocs for your own libraries to give some personal branding. This is done by adding a.cocoadocs.yml file to the root of your library, which overwrite these properties:

  highlight-font:'"GT Walsheim", "gt_walsheim_regular", "Avant Garde Gothic ITCW01Dm", "Avant Garde", "Helvetica Neue", "Arial"'body:'"Helvetica Neue", "Arial", san-serif'code:'"Monaco", "Menlo", "Consolas", "Courier New", monospace'highlight-color:'#ED0015'highlight-dark-color:'#A90010'darker-color:'#C6B7B2'darker-dark-color:'#A8A8A8'background-color:'#F2F2F2'alt-link-color:'#B7233F'warning-color:'#B80E3D'

  All defaults are stored in this config file for you to overwite.

• You can find an example of styling atARAnalytics's .cocoadocs.yml

• You can change the location of your readme withreadme: path/to/README.md in your.cocoadocs.yml.

• You can add your own documentation guides, either from remote markdown files or from files locally inside the library. CocoaDocs will automatically convert github wiki pages to the markdown behind it. These only work on Objective-C codebases.

  additional_guides:  -https://github.com/magicalpanda/MagicalRecord/wiki/Installation  -https://github.com/CocoaPods/CocoaPods/wiki/A-pod-specification  -docs/Getting_started.md

• If you host your own documentation, and/or just prefer to not use CocoaDocs you can use thedocumentation_url reference in your Podspec.

First, clone this repo:git clone https://github.com/CocoaPods/cocoadocs.org then runbundle install and then runbundle exec rake install_tools to get all pre-requisite apps set up.

To preview your library run:

bundle exec ./cocoadocs.rb preview ARAnalytics

This will get themaster version of your library and run it through CocoaDocs, then open the resulting folder, you can open theindex.html in a web browser to preview locally.

The CocoaPods' CocoaDocs server is hosted onmacminicolo.net provided byButton. We use RSA public keys to log in. You'll have to get yourid_rsa.pub to an existing admin ( currentlyorta /segiddins ) to get access.

SSH access is automated via theRakefile:

• bundle exec rake deploy - will log in via SSH, stop the API server, update it and then bring the server back up.

• bundle exec rake doc["pod_name"] - will log in via SSH, and run a re-doc for a pod. Similar to the redeploy API, but you can see the logs.

The creation of CocoaDocs v2 has been made possible with help from the following:

• Orta Therox - Design & Code
• Sam Giddins -Admin & Code
• Kyle Fuller - Admin & Code
• Delisa Mason - Docstat gem
• Clay Allsopp - README Complexity gem
• Ash Furrow - Javascript & Ruby assistance
• Boris Bugling - Boring legwork on templates