Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/johnfairh/bebop

API docs generation for Swift and Objective-C
https://github.com/johnfairh/bebop

documentation-generator objective-c swift

Last synced: about 1 month ago
JSON representation

API docs generation for Swift and Objective-C

Awesome Lists containing this project

README

        

![Test](https://github.com/johnfairh/Bebop/workflows/Test/badge.svg)

Bebop: [Jazzy](https://github.com/realm/Jazzy) API docs generation with extra
bits. There are bells _and_ whistles.
* Swift/Objc/Both everywhere
* Localize everything, doc comments to images
* Input SPM/Xcodeproj/Podspec/binary .swiftmodule, output html/dash docset/markdown, various flavors of json
* Multi-module/multi-pass
* Commonmark + extensions + custom extensions, KaTeX
* Apple/Jazzy/Hybrid/Custom layout
* Flexible web theme, keybinds, more navigation
* Integrate with other docsets, Docc sites, online/inline Apple docs, github/gitlab/bitbucket/custom
* Mostly compatible with Jazzy CLI / config file / themes -- migration aide+
* Experiment with monolithic project and heavy dependencies

### Install
macOS:
```shell
brew install johnfairh/bebop/bebop/
```
Builds from source, takes a while.

Linux, approximately:
```shell
git clone [email protected]:johnfairh/Bebop.git
apt-get install libsqlite3-dev libsass0 libsass-dev
make install
```

### Examples