Code Monkey home page Code Monkey logo

documentation-templater's Introduction

Documentation Templater V2

Codacy Badge

Templating engine for quickly and easily creating static web-based documentation projects. Write short and readable HTML or Markdown code containing only the important information for each page. All styling and layouts are defined in templates which can be changed to give you the full capabilities of pure HTML should you need it.

Included templates generate a clean, responsive, mobile-compatible documentation which you can view here.

The tool is cross-platform written using .NET Core 3.1.

Features:

  • Write short documentation pages in Html or Markdown
  • Supports all the common markdown features. Add more by installing Markdig extensions
  • Create custom controls like <card property="value">...</card> similar to JS Frameworks like Anuglar and React
  • Comes with a modern and responsive example template
  • Sidebar navigation supported
  • Minifies output HTML, CSS and JavaScript for fast load times
  • Output is ready to copy into a public folder for hosting
  • Output is static so free hosting is availalbe on GitHub Pages, GitLab Pages or Netlify
  • Very fast documentation build times which increase linearly with the number of pages

YouTube Tutorials

See the First Video Tutorial on YouTube

I am working on a series of 3 YouTube tutorials:

Using the Tool

To use the tool, download the latest version through GitHub Releases. There are downloads for Windows, Mac and Linux, both including a bundled .NET Core 3.1 runtime, or without if you already have it installed.

See the Wiki for a full guide.

Building from Source

To build from source you need the latest .NET Core 3 SDK. For Windows users just install the latest verion of Visual Studio 2019 with the .NET Core workload . Use the following publish command to get a single file executable:

dotnet publish -r win10-x64 -c Release -p:PublishSingleFile=true

where you change win10-x64 to your platform.

There is a more detailed guide to building from source in the Wiki.

License

This code is released under MIT license. Modify, distribute, sell, fork, and use this as much as you like. Both for personal and commercial use. I hold no responsibility if anything goes wrong.

If you use this, you don't need to refer to this repo, or give me any kind of credit but it would be appreciated. At least a โญ would be nice.

Contributing

Pull requests of any form are welcome. See the Wiki for contribution suggestions.

Support

You can contact me by submitting a contact form here or by opening an issue.

documentation-templater's People

Contributors

james231 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

documentation-templater's Issues

enhancement request

First things first, this is an awesome tool, and certainly has a lot of potential. Easy to use, and fast to generate doc sets. What I did notice though, is by using static URLs base along the webroot, limits its usage to a 1:1 relationship with webservers/virtual directories. For documentations sets, it's often handy/required to have multiple 'libraries' each with a unique location on a single URL.

Would be extremely useful if we could specify a web-root (either at compile time, or via config file), to allow for multiple projects to coexist side-by-side in the same virtual directory, or even if viewed on the localhost.

I should add, that even just having the ability to output with relative paths would go a long way, to making this useful for a whole slew of applications.

:)
R

Sidebar Links Not Working

Hi - this project looks very promising.

Can you check index,html in Output folder. It seems a number of closing tags are missing eg html, body etc

image

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.