Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/DoccZz/servedocc

A small Swift tool/server to serve DocC archives to your browser
https://github.com/DoccZz/servedocc

docc swift

Last synced: 3 months ago
JSON representation

A small Swift tool/server to serve DocC archives to your browser

Awesome Lists containing this project

README

        

servedocc

Small Swift script to serve "DocC" archives, a format to document Swift frameworks
and packages:
[Documenting a Swift Framework or Package](https://developer.apple.com/documentation/Xcode/documenting-a-swift-framework-or-package).

*Note*: This is for serving an exported documentation archive (`.doccarchive`),
not for building documentation from a DocC catalog.

## Usage

The server can be either run as a
[swift-sh](https://github.com/mxcl/swift-sh) script
(install using a simple `brew install mxcl/made/swift-sh`),
from within Xcode or via `swift run`.

### Via swift-sh

Example:
```bash
$ cd Sources/servedocc
$ ./main.swift ~/Downloads/SlothCreator.doccarchive
```

### Who

**servedocc** is brought to you by
the
[Always Right Institute](http://www.alwaysrightinstitute.com)
and
[ZeeZide](http://zeezide.de).
We like
[feedback](https://twitter.com/ar_institute),
GitHub stars,
cool [contract work](http://zeezide.com/en/services/services.html),
presumably any form of praise you can think of.