https://github.com/dgellow/lit
📖 Literate Go Programming 🤓
https://github.com/dgellow/lit
documentation go golang literate-programming readability
Last synced: 9 months ago
JSON representation
📖 Literate Go Programming 🤓
- Host: GitHub
- URL: https://github.com/dgellow/lit
- Owner: dgellow
- Created: 2018-11-25T19:07:31.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-11-26T23:52:29.000Z (over 7 years ago)
- Last Synced: 2025-08-02T20:04:43.516Z (11 months ago)
- Topics: documentation, go, golang, literate-programming, readability
- Language: Go
- Homepage:
- Size: 978 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Literate Go [](https://travis-ci.org/dgellow/lit) [](https://godoc.org/github.com/dgellow/lit) [](https://goreportcard.com/report/github.com/dgellow/lit)
The tool `lit` generates clean and readable documents from a commented go source code. Instead of embedding source code into your prose, write your prose within your source code. The main goal of this tool is to help writing technical articles discussing or presenting programs implementation. The approach is in some way the opposite of Markdown and other format focused on making it as easy as possible to write text, instead `lit` assumes that the main content of the document is the actual code, and let you use the best tools and context (i.e: your editor) to write your program, and use source code comments as your prose.
Install the command line tool with `go get github.com/dgellow/lit/cmd/lit`.
Usage is minimalistic:
```sh
$ lit -help
Usage of lit:
-embedded
if used, generate embeddable HTML instead of full document
-input string
input file (default "stdin")
# Example
$ lit -input github.com/dgellow/lit/lit.go > doc.html
```
