Skip to content

sidd212/yaydoc

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Yaydoc

Development Build Status Master Build Status Join the chat at https://gitter.im/fossasia/yaydoc

Yaydoc is an automated documentation generation and deployment project that generates documentation for its registered repositories on each commit and deploys it to Github Pages.

Communication

Getting started

Prerequisites

To start using Yaydoc, make sure you have all of the following:

Note: For advanced configurations, include an index.rst file which contains toctrees to link the various documents.

To get started with Yaydoc

  1. Using your Github account, sign in to yaydoc.org and accept the Github access permissions confirmation
  2. Once you’re signed in to Yaydoc, go to your dashboard and register the repository you want to build your documentation from.
  3. Add a .yaydoc.yml file to the root of your repository to define rules and variables for Yaydoc's build process
  4. Add the .yaydoc.yml file to git, commit and push, to trigger the Yaydoc build process.
  5. Check the logs for your repository to see if the documentation generation and deployment process passes or fails.

Note: Yaydoc only runs builds on the commits you push after you’ve registered your repository in Yaydoc. Ensure that the repository is enabled from the its settings at Yaydoc.

Known limitations

  • If you use embedded html in markdown or reStructuredText, any static content such as images, javascript referred from it should be present in a _static directory placed under source.

Deployment

Deploy

Contributions, Bug Reports, Feature Requests

This is an Open Source project and we would be happy to see contributors who report bugs and file feature requests submitting pull requests as well. Please report issues here https://github.com/fossasia/yaydoc/issues

License

This project is currently licensed under the GNU General Public License v3. A copy of LICENSE.md should be present along with the source code. To obtain the software under a different license, please contact FOSSASIA.

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 47.2%
  • Python 21.1%
  • HTML 20.9%
  • Shell 8.4%
  • CSS 2.4%