Git Product home page Git Product logo

fork-latex-build-test's Introduction

自動LaTeX組版

これはなに

GitHub Actionsを利用して,Docker上でLaTeXで組版し, 生成したPDFを上げ込むところまでを無償で自動化した例。

一般的には中小規模の論文執筆に向いていると思われる。 大規模の論文では,恐らく組版頻度が少なすぎる。

特徴

  • 可能な限り公式の道具を用い,また自分で書く量を少なくしている。 既に高品質のものが用意されているのに車輪の再発明はしたくないし, 自分の管轄下に複雑な環境を導入したくない。

    • LaTeXが乗るDockerは自力では作成せず, Dockershelf が配布し隔日で更新しているものを利用する。

    • 自動組版の開始設定や,生成したPDFをどのように配置するかは, GitHub Actionsが公式に用意している 構築例 を参考にする。(自分で独自命令を考えたりしない)

しくみ

  • 手許でLaTeX原稿を編集する。 例えば,

$ editor main.tex
  • git標識を賦与する。 例えば,

$ git tag v42.0.1
  • GitHubに押し込む。 例えば,

$ git push origin v42.0.1

ここでGitHub Actionsが作動。 「pushかつ “v” から始まるtagが賦与されていれば指定した一連の動作 (具体的にはLaTeX組版とReleaseへの上げ込み)を行う」 という設定にしているので,如述の操作に感応する。

Dockerが構築されて原稿が処理され,しばらく待つと Releaseが一つ増えてそこに組版結果のPDF文書が上がる。

やりたいこと

標識を自動で増分したい

これは多分そう難しくないけど, できればgitやGitHubの機能を用いて効率的・最小限の追加で達成したい。 (ここで思考する: 標識をよしなに増分するgit副命令

fork-latex-build-test's People

Contributors

cmplstofb avatar

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.