質問をすることでしか得られない、回答やアドバイスがある。

15分調べてもわからないことは、質問しよう!

新規登録して質問してみよう
ただいま回答率
85.50%
MathJax

MathJaxは、MathML/LaTeXなどで記述された数式をWebブラウザ上で整形・表示できるオープンソースのJavaScriptライブラリ。全てのモダンブラウザで動作し、プラグインのインストールやブラウザの設定などを行うことなく利用できます。

GitLab

GitLabは Gitoliteをブラウザから管理できるようにする Rubyアプリケーションで、 GitHubのようなサービスをクローズドな環境に独自で構築できるように 公開されたものです。

TeX

フリーの組版システムで、字や図版などの要素を紙面に配置するという作業をコンピュータで行います

Q&A

解決済

2回答

7021閲覧

gitlab にアップロードする markdown ファイルの扱い方ベストプラクティスの募集

spectrum

総合スコア44

MathJax

MathJaxは、MathML/LaTeXなどで記述された数式をWebブラウザ上で整形・表示できるオープンソースのJavaScriptライブラリ。全てのモダンブラウザで動作し、プラグインのインストールやブラウザの設定などを行うことなく利用できます。

GitLab

GitLabは Gitoliteをブラウザから管理できるようにする Rubyアプリケーションで、 GitHubのようなサービスをクローズドな環境に独自で構築できるように 公開されたものです。

TeX

フリーの組版システムで、字や図版などの要素を紙面に配置するという作業をコンピュータで行います

0グッド

1クリップ

投稿2018/05/18 03:34

編集2018/05/18 03:39

私がいる最近始まったプロジェクトでは、gitlab にファイルやドキュメントをアップロードします。
ドキュメントはマークダウンで書いてあり、atomで編集しています。また、数式が含まれています。

atom で編集している md を gitlab に上げると、プレビューで上手く表示されません。
詳しくはまだ調べてないのですが、レンダリングの違いによります。

そこで、質問ですが良い解決方はありますでしょうか?
私が考えたのは
(1) 今まで通り atom で github markdown で編集し、アップロードするとき変換する正規表現プログラムを書き、それを通してアップロードする。ただプログラムを書くのも、毎回プログラムを通すのも面倒です。
(2) atom で gitlab markdown に対応する数式パッケージを探し、それをいれる。このパッケージが存在するかは分かりません。よろしければ教えて下さい。
(3) gitlab markdown に対応したエディタを探す。プレビューがあると嬉しいです。もしご存知でしたら教えて下さい。

何か良い解決方があれば教えて下さい。よろしくお願いいたします。

気になる質問をクリップする

クリップした質問は、後からいつでもMYページで確認できます。

またクリップした質問に回答があった際、通知やメールを受け取ることができます。

バッドをするには、ログインかつ

こちらの条件を満たす必要があります。

退会済みユーザー

退会済みユーザー

2018/05/18 03:51

編集中のMarkdown、どのコードは本来どのように表示されているのか。また、アップロード後はそのコードの部分がどのように表示されないのか。スクリーンショットなどの実例があると非常にわかりやすいと思います。また、GitLabはOSSを自社サーバーで使用しているのかそれともWebサービスを使用しているのかによっても異なるかと思います。
guest

回答2

0

自己解決

gitlab の数式レンダリングは KaTex で、github の数式レンダリングは MathJax でした。
gitlab で見れるドキュメントの編集のための、atom での KaTex でのレンダリングのプレビューに対応したパッケージを探しました。探した結果 markdown-preview-enhanced が要件に対応しているようでした。
設定で KaTex と MathJax の切り替えができます(!)

今まで markdown-preview-plus を使っていましたが、これに乗り換えました。おすすめだと思います。

あいまいな質問でしたらすみませんでした。
ご回答ありがとうございました。

投稿2018/05/21 02:24

spectrum

総合スコア44

バッドをするには、ログインかつ

こちらの条件を満たす必要があります。

0

GitLabのmarkdownに合わせて書くしかないのでは。
あとはGitLab上で直接編集するとか。それならプレビューできる。

投稿2018/05/18 04:40

kawax

総合スコア10377

バッドをするには、ログインかつ

こちらの条件を満たす必要があります。

spectrum

2018/05/21 02:25

ありがとうございます。 gitlab 上で編集できることは知りませんでした。
guest

あなたの回答

tips

太字

斜体

打ち消し線

見出し

引用テキストの挿入

コードの挿入

リンクの挿入

リストの挿入

番号リストの挿入

表の挿入

水平線の挿入

プレビュー

15分調べてもわからないことは
teratailで質問しよう!

ただいまの回答率
85.50%

質問をまとめることで
思考を整理して素早く解決

テンプレート機能で
簡単に質問をまとめる

質問する

関連した質問