papilip/helptransl8 papilip/helptransl8

Tools
  • Stars
    star
    6
  • Rank 2,539,965 (Top 51 %)
  • Language
    Crystal
  • License
    Other
  • Created about 7 years ago
  • Updated about 7 years ago
Twitter logo Share LinkedIn logo Share Facebook logo Share
papilip/helptransl8
github

papilip

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

HelpTransl8 helps translators check the original documentation repository by comparing each file and listing the files that have been modified

HelpTransl8

HelpTransl8 is a tool for document translators.

Origin of development and its response

The main problem when documentation is translated is maintenance. The original documentation (often in english) evolves. So how do we locate between the version we translated and the latest version?

HelpTransl8 is an answer to this question: each file of the original documentation is kept in a hidden file with the same name. Thus, when updating HelpTransl8 compares the new file with the old one. If the new file is different then it replaces the hidden file and informs the user in a TODO list. If the file does not exist, it is created with its original version!

Installation

macOS

brew brew tap papilip/brew
brew install helptransl8

From source (check dependencies :)

git clone https://github.com/papilip/helptransl8.git && cd helptransl8
crystal build src/helptransl8.cr --release

Quickstart

helptransl8 --init=https://url_original_repository
helptransl8 --check
cat TODO_helptransl8.yml

Usage

  • helptransl8 -c | --check Check each file with the original repository.

  • helptransl8 -h | --help Show help with all commands.

  • helptransl8 -i | --init=url_du_depot_original Generates the helptransl8.yml file with original repository url.

  • helptransl8 -p | --print Print URL from original repository.

  • helptransl8 -v | --version Shows the program version.

Development

  • CRYSTAL_ENV=devel|development|test ./helptransl8 Using the program by initializing the environment.

  • Tests are missing!

Pull Requests welcome !

Contributors

  • Philippe Nénert (@papilip) - Creator, maintainer