Skip to content

Latest commit

 

History

History
50 lines (33 loc) · 1.2 KB

README.md

File metadata and controls

50 lines (33 loc) · 1.2 KB

SketchUp Ruby API YARD Template

Gem Version

This is the customized YARD template the SketchUp team uses to generate the SketchUp Ruby API documentation.

It is made available for easy re-use. Using this gem a local copy of the documentation can be generated from our SketchUp Ruby API stubs.

Example Usage

Make sure YARD and yard-sketchup are installed:

gem install yard
gem install yard-sketchup

Example .yardopts config:

--title "SketchUp Ruby API Documentation"
--no-api
--no-private
--plugin yard-sketchup
SketchUp/**/*.rb
-
pages/*.md

The assets and pages directory can be found in the SketchUp Ruby API stubs repository.

Useful YARD Commands

TL;DR - YARD Usage

Note: The Thor commands mentioned above are wrappers on top of these YARD commands.

Generate API Documentation: yardoc

Exclude a version:

yardoc --query '@version.text != "SketchUp 2018"'

Generate API Stubs: yardoc -t stubs -f text

Generate coverage.manifest: yardoc -t coverage -f text