Skip to content

An rsync wrapper for conveniently publishing shard documentation to the crystal-docs website.

License

Notifications You must be signed in to change notification settings

barisbalic/crystal-docs-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

crystal-docs-cli

A simple CLI tool for publishing Crystal Shard documentation to crystal-docs.org. It is a requirement that users have first identified themselves on the website before they are able to publish.

The tool is just a convenient wrapper for rsync, so you must also have that installed.

Installation

Requires crystal-lang 0.18.7+

git clone git@github.com:barisbalic/crystal-docs-cli.git
cd crystal-docs-cli
shards install
crystal build --release src/crystal-docs.cr

Usage

The first step is to publish the current documentation for your Shard.

crystal-docs publish

Once you have done this, you may publish docs for a specific version...

crystal-docs publish 0.1.0

Or... for a branch/tag.

crystal-docs publish rc1

Optionally you may generate documentation before pushing...

crystal-docs publish -g

Should you need to publish docs as another user, you may specify a user with the -u flag.

crystal-docs publish -u lemondrizzle

Contributing

  1. Fork it ( https://github.com/barisbalic/crystal-docs/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors

About

An rsync wrapper for conveniently publishing shard documentation to the crystal-docs website.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published