📝 A list of tools and articles helpful for keeping everything under plaintext.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Kirill Zinov 16eb4e9df7 Update README.md 1 month ago
.editorconfig Adds editorconfig 7 years ago
CONTRIBUTING.md Minor guideline change 7 years ago
README.md Update README.md 1 month ago

README.md

plaintext-everything

version-control-everything

A curated list of awesome plain-text tools.

I like to keep everything under version control as plain-text. This is a list of utilities that allow you to do that. Unmaintained tools are striked out.

Note: * denotes that the linked item is not a library or tool, but an article or blog post.

DNS

Configuration

  • etckeeper. The Arch Wiki has a nice guide on usage.
  • NixOS is a completely declarative OS that uses nix, the purely functional package manager
  • RANCID - RANCID monitors a device's configuration, including software and hardware (cards, serial numbers, etc) and uses a version-control-system to maintain history of changes.
  • Oxidised - Oxidized is a network device configuration backup tool. It's a RANCID replacement!
  • *Blog post about Oxidised
  • In general, most configuration management software will keep everything in plain-text.

Terraform

Terraform lets you manage a lot of things in plain-text, including Cloud Assets, Databases, Networking, configuration for various Web services, your CI/CD configuration, and even your Google Calendar. A full list of providers is on the Terraform Registry.

Passwords

  • *Question on StackOverflow
  • *John Resig's blog post
  • pass - Standard unix password manager (encrypt, then commit).
  • ansible-vault - Encrypted storage for ansible.
  • sops - Encrypts files for git.

Dotfiles

Editors

Media

  • Git Large File Storage - Replaces large fileswith text pointers inside Git, while storing the file contents on a remote server. Maintained by github

Encrypted Storage

  • *HN Thread for blackbox, with various alternatives suggested
  • git-crypt - git-crypt enables transparent encryption and decryption of files in a git repository
  • *Blog post on git-crypt
  • transcrypt - transparently encrypt files within a git repository
  • blackbox - use decryption keys per user, meaning that there is no single shared password

Designers

  • pixelapse - Visual version control and collaboration workflow
  • *Adobe Version Cue - Blog post explaining version control to designers
  • kactus.io - Version control for designers (Sketch+Git for now)
  • SnowFS - a fast, scalable version control file storage for graphic files. There is a commercial offering as well.

Music

  • lilypond - version control for sheet music. Think Latex for sheet music
  • tunemachine - Version control for spotify playlists.

Database

  • *Jeff Atwood's blog post
  • GNU Recutils - set of tools and libraries to access human-editable, plain text databases called recfiles. The data is stored as a sequence of records, each record containing an arbitrary number of named fields.

Database Schema

  • flyway - Version control for your database.
  • MyBatis
  • Liquibase - Source Control for your database
  • Rumba RDBM - Database schema migration tool, plain-SQL, and declarative schema definition supported.

Backups

  • bup - Very efficient backup system based on the git packfile format, providing fast incremental saves and global deduplication (among and within files, including virtual machine images)

Writing

  • Draft - Easy version control and collaboration for writers.
  • Penflip - GitHub for collaborative writers.
  • GitBook - Book publishing platform based on git and markdown.
  • CriticMarkup - a way for authors and editors to track changes to documents in plain text.

Journaling

  • Journal.TXT - Single-Text File Journals.
  • journal-cli - Index Your Markdown-Based Journal With Yaml Front Matter!

Todo

Food

Diagrams & Flowcharts

  • Web Sequence Diagrams - Generates imagess from your plain text descriptions. Has an API for plugin support, so you can embed easily.
  • Kanga Modelling - UML diagram generator in plain text. Written in .NET
  • yuml.me - Class UML diagrams, described in plain text, and easily embeddable.
  • Mermaid - Mermaid lets you create diagrams and visualizations using text and code.
  • Kroki - Kroki provides a unified API for all the diagram libraries including BlockDiag (BlockDiag, SeqDiag, ActDiag, NwDiag, PacketDiag, RackDiag), BPMN, Bytefield, C4 (with PlantUML), Ditaa, Erd, Excalidraw, GraphViz, Mermaid, Nomnoml, Pikchr, PlantUML, SvgBob, UMLet, Vega, Vega-Lite, WaveDrom... and more.
  • ditaa - converts diagrams drawn using ascii art, into proper bitmap graphics.
  • erd - takes a plain text description of entities, their attributes and the relationships between entities and produces a visual diagram modeling the description using GraphViz and Dot.
  • Svgbob Editor - Convert your ascii diagram scribbles into happy little SVG

Visualization

  • Sparklines are possible in plain-text (specifically these 8 characters: '▁▂▃▄▅▆▇█').
  • Tables-Generator lets you generate plain-text tables.

Presentations

Finance

Tools that let you manage finances, but keep your books in plain-text.

  • *plain text accounting - umbrella site for the plain text accounting community.
  • ledger - Ledger is a powerful, double-entry accounting system that is accessed from the UNIX command-line
  • hledger - cross-platform accounting software for both power users and folks new to accounting.
  • beancount - A double-entry bookkeeping computer language that lets you define financial transaction records in a text file, read them in memory, generate a variety of reports from them, and provides a web interface.
  • transity - A transaction-first plain-text account tool that uses YAML to store your transactions.
  • plainbudget - Minimalist plaintext budgeting tool.

Typesetting

Tools that let you create professional looking documents, but keep your books in plain-text.

  • LaTeX
  • SILE - a typesetting system written in Lua and using the HarfBuzz font shaper. It’s input syntax is somewhat inspired by LaTeX.
  • groff - is a typesetting system that creates formatted output when given plain text mixed with formatting commands. Primarily used for man pages, it has been used for books as well.
  • rinohtype - a Python library that transforms a structured document into a professionally typeset PDF guided by a document template and style sheet.
  • pandoc - If you need to convert files from one markup format into another, pandoc is your swiss-army knife.
  • *Sustainable Authorship in Plain Text using Pandoc and Markdown
  • *Unicode Nearly Plain-Text Encoding of Mathematics - With a few conventions, Unicode1can encode manymathematical expressions in readable nearly plain text. Technically thisformat is a “lightly marked up format”; hence the use of “nearly”.
  • MathML - MathML is a low-level specification for mathematical and scientific content on the Web and beyond.
  • *A list of MathML Tools
  • AsciiDoctor - AsciiDoctor is a fast text processor & publishing toolchain for converting AsciiDoc to HTML5, DocBook & more.

Miscellaneous

Specification

  • OpenAPI Specification - a standard, language-agnostic interface to RESTful APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection.
  • *OpenAPI.Tools - List of various tools that use the OpenAPI Specification including Convertors, Validators, Documentation, Mock Servers, SDK Generators, Text Editors and more.
  • MSON - A description format for describing data structures in common markup formats such as JSON, XML or YAML.

License

CC0