Overleaf とは (https://ja.overleaf.com/) Overleaf Community 版 (https://github.com/overleaf/overleaf)
- 事前にリモートリポジトリを用意する.既に存在するリポジトリでも可.なければ, 作成する
- GitHub の個人アクセストークンを事前に所得する https://docs.github.com/ja/free-pro-team@latest/github/authenticating-to-github/creating-a-personal-access-token 権限は 'repo' のみ選択すること トークンは厳重に扱うこと
$ git clone https://github.com/cysec-lab/OverleafWithGit.git $ cd OverleafWithGit $ sudo docker-compose up -d # サイズは10GB程度.削減する場合は, Latexの不要なパッケージを削除する $ sudo docker exec watch-overleaf /bin/bash -c "cd /var/www/sharelatex; grunt user:create-admin --email=admin@example.com" # Adminユーザの作成, 実行後に表示されるURLにアクセスしパスワードを設定する $ # http://localhost に設定した認証情報でアクセスし, 適当なOverLeafプロジェクトを作成する $ sudo docker ps ## 出力は例 CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES ffd1bee143c1 takukitamura/watch-overleaf "/sbin/my_init" 29 seconds ago Up 2 seconds 0.0.0.0:80->80/tcp watch-overleaf 99475ae05634 redis:5 "docker-entrypoint.s..." 43 hours ago Up 13 seconds 6379/tcp redis 3ab5222f1753 mongo "docker-entrypoint.s..." 4 days ago Up 13 seconds (healthy) 27017/tcp mongo $ docker exec -it ffd1bee143c1 bash ## 以下, watch-overleafコンテナ内 root@ffd1bee143c1:/# cd ~/watchOverleaf/ root@ffd1bee143c1:~/watchOverleaf# git pull origin master root@ffd1bee143c1:~/watchOverleaf# cp main.py demo.py # ソースコードをコピーする root@ffd1bee143c1:~/watchOverleaf# vim demo.py ## プログラム内に, 書き換え必須 ✅もしくは, 書き換えが必要かもしれない と書いてある変数を適宜書き換え保存する ~~~ # ユーザ変数 # OverleafのプロジェクトID, ユーザID # 1. latex編集画面で, Webデベロッパーツールを開く # 2. コンソールで以下の入力をして出力されるものが, プロジェクトID, ユーザID # > project_id # "5f8d2f5e40a9cd007604f46b" # > user_id # "5f8f784af6e341007b878a51" # # 書き換え必須 ✅ PROJECT_ID = '5f8d2f5e40a9cd007604f46b' # プロジェクトを一意に決める # 書き換え必須 ✅ USER_ID = '5f8f784af6e341007b878a51' # ユーザを一意に決める # 書き換え必須 ✅ GITHUB_USER_NAME = 'TakuKitamura' # GitHubのID # 書き換え必須 ✅ GITHUB_REPO_NAME = 'verified-mqtt-parser-paper' # Overleafプロジェクトをホスティングしたいリポジトリ名 # NginxのAccessログのパス, 書き換えの必要が出るかもしれない NGINX_LOG_PATH = '/var/log/nginx/access.log' # 書き換えが必要かもしれない GIT_BRANCH_NAME = 'master' # GitHubリポジトリ上でホスティングするブランチ名 # 書き換えが必要かもしれない PAPER_DIR_NAME = 'overleaf' # リポジトリルートに作成されるディレクトリ名 # 書き換えが必要かもしれない EXCLUDE_LIST = './exclude_list' # OverLeafプロジェクトから余計なファイルがPUSHされた場合は, ここに追加する ~~~ root@ffd1bee143c1:~/watchOverleaf# vim ~/.netrc ## gitコマンドの認証を自動で行う .netrcを作成する. 下記は例 machine github.com login TakuKitamura password xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx root@ffd1bee143c1:~/watchOverleaf# python3 demo.py root@ffd1bee143c1:~/watchOverleaf# exit
プログラム起動後, 再度 http://localhost にアクセスする.
OverLeaf プロジェクト内の文書を変更し, PDF が更新されるのを確認する.そして, その変更がリポジトリ直下の overleaf ディレクトリに反映されていれば動作している.
永続化は $ nohup python3 demo.py & などする
プログラムは動作しているが, リポジトリに変更が反映されない
コンテナ内でNGINX_LOG_PATHが指す先のログが正しく反映されているか確認する. 例えば, $ tail /var/log/nginx/access.log などでログが更新されているか, NGINX_LOG_PATHが間違っていないか確認する
OverLeaf で文書を編集する際のカーソルの位置が変だ
どうやら, フォントが等幅でないとそうなるんだそう. なので, ブラウザのフォント設定から等幅フォントを選択すればなおる.
日本語文書の作り方がわからない
参考にさせていただきました. https://doratex.hatenablog.jp/entry/20180503/1525338512
プログラムが動かない
すいませんが, Pull Requestやissueください. まだまだ, バグはあると思います.
- ユーザが与える変数をコマンドオプションから与えられるようにする
- git の認証情報をプログラムごとに分けられるようにする
- あるであろうバグの修正
- リファクタリング