Code Monkey home page Code Monkey logo

0doc's Introduction

0Doc

0Doc is a simple documentation writing tool.

Live version: 0Doc.

This is an example of use for C.H.I.P.'s documentation, forked from http://docs.getchip.com/chip.html.

Installation

Just open index.html and that's it!

To edit your own documentation, write it in Markdown syntax inside the <div id="content"> ... </div>. The table of contents will be automatically generated on the fly. No other tool needed.

You can also:

  • Modify <title>...</title> with your own title

  • Use your own logo.png file

Why another static documentation generator ?

I discovered the great Slate project, but it requires to install Ruby, bundler, and it's just another layer on top of middleman static website generator, which does most of the work. As I'm not a user of all these tools, I didn't find it confortable for me.

Moreover I don't like having to run a command to re-render HTML files each time you modify the documentation (that's often the case with static websites generators).

That's why I decided to write this simple solution that doesn't require any tool like Ruby, Python, Perl, etc. The output is rendered on the fly when you open index.html.

In short, this means that you just have to edit your index.html, and not worry about anything else.

External files

It's possible to include external files with:

<div id="content">
    <file src="chapter1.md"></file>
</div>

More about this feature here.

About

Author: Joseph Ernest (@JosephErnest)

Other projects: BigPicture, bigpicture.js, AReallyBigPage, SamplerBox, Void, TalkTalkTalk, YellowNoiseAudio, etc.

License

MIT license

Dependencies

0Doc uses jQuery, marked for Markdown rendering and mark.js for on-page search.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.