https://github.com/swagdevops/aldine
LaTeX utilities (standalone document preparation system)
https://github.com/swagdevops/aldine
docker latex template tex
Last synced: 17 days ago
JSON representation
LaTeX utilities (standalone document preparation system)
- Host: GitHub
- URL: https://github.com/swagdevops/aldine
- Owner: SwagDevOps
- License: lgpl-3.0
- Created: 2022-01-09T17:00:37.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-04-27T11:24:11.000Z (about 3 years ago)
- Last Synced: 2025-06-03T19:41:26.653Z (11 months ago)
- Topics: docker, latex, template, tex
- Language: Ruby
- Homepage:
- Size: 271 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Install
```shell
bundle config set --local clean 'true'
bundle config set --local path 'vendor/bundle'
bundle install --standalone
```
## Rakefile
### ``./Rakefile``
```ruby
# frozen_string_literal: true
require 'bundler/setup'
require 'aldine/local/tasks'
```
## Environment
The following files are loaded as [``dotenv``][bkeepers/dotenv] files:
* ``.env.local``
* ``.env``
The file ``.env.sample`` is used to perform [environment validation][fastruby/dotenv_validator].
See also:
* [Dotenv][bkeepers/dotenv]
* [Dotenv Validator][fastruby/dotenv_validator]
## Aliasing
LaTeX commands provided by the package can be aliased (to be more semantic), as the following __example__:
```latex
% aldine --------------------------------------------------------------
\DeclareCommandCopy\emptypage\aldineEmptyPage
\DeclareCommandCopy\markdown\aldineMarkdown
\DeclareCommandCopy\svgconv\aldineSvgConv
\DeclareCommandCopy\blason\aldineBlason
\DeclareCommandCopy\chapters\aldineChapters
\DeclareCommandCopy\hyperrefSetup\aldineHyperrefSetup
\DeclareCommandCopy\imageFull\aldineImageFull
```
## Developper
### Environment
```dotenv
# file: .env.local
ALDINE__DIRECTORIES__LIB=tex
ALDINE__DIRECTORIES__RUBY=lib
```
Dotenv above changes ``lib`` to ``tex`` for tex packages,
and add ruby ``lib`` directory to mounted directories.
It assumes working from the current sources directory.
### Replacement ``Rakefile`` in ``src`` and ``tmp`` directory
```ruby
# frozen_string_literal: true
require 'bundler/setup'
require '/workdir/lib/aldine'
require 'aldine/remote/tasks'
```
[bkeepers/dotenv]: https://github.com/bkeepers/dotenv
[fastruby/dotenv_validator]: https://github.com/fastruby/dotenv_validator