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

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

ただいまの
回答率

90.50%

  • Atom (テキストエディタ)

    508questions

  • GitLab

    125questions

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

  • TeX

    41questions

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

  • MathJax

    6questions

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

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

解決済

回答 2

投稿 編集

  • 評価
  • クリップ 1
  • VIEW 853

spectrum

score 31

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

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

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

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

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

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

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

    クリップを取り消します

  • 良い質問の評価を上げる

    以下のような質問は評価を上げましょう

    • 質問内容が明確
    • 自分も答えを知りたい
    • 質問者以外のユーザにも役立つ

    評価が高い質問は、TOPページの「注目」タブのフィードに表示されやすくなります。

    質問の評価を上げたことを取り消します

  • 評価を下げられる数の上限に達しました

    評価を下げることができません

    • 1日5回まで評価を下げられます
    • 1日に1ユーザに対して2回まで評価を下げられます

    質問の評価を下げる

    teratailでは下記のような質問を「具体的に困っていることがない質問」、「サイトポリシーに違反する質問」と定義し、推奨していません。

    • プログラミングに関係のない質問
    • やってほしいことだけを記載した丸投げの質問
    • 問題・課題が含まれていない質問
    • 意図的に内容が抹消された質問
    • 広告と受け取られるような投稿

    評価が下がると、TOPページの「アクティブ」「注目」タブのフィードに表示されにくくなります。

    質問の評価を下げたことを取り消します

    この機能は開放されていません

    評価を下げる条件を満たしてません

    評価を下げる理由を選択してください

    詳細な説明はこちら

    上記に当てはまらず、質問内容が明確になっていない質問には「情報の追加・修正依頼」機能からコメントをしてください。

    質問の評価を下げる機能の利用条件

    この機能を利用するためには、以下の事項を行う必要があります。

質問への追記・修正、ベストアンサー選択の依頼

  • t_shinohara

    2018/05/18 12:51

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

    キャンセル

回答 2

check解決した方法

0

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

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

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

投稿

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

0

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

投稿

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

  • 2018/05/21 11:25

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

    キャンセル

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

  • ただいまの回答率 90.50%
  • 質問をまとめることで、思考を整理して素早く解決
  • テンプレート機能で、簡単に質問をまとめられる

関連した質問

  • 受付中

    GitLabのexternal-urlについて

    こちらのページ http://blog.ybbo.net/2015/03/15/how-to-install-gitlab-to-centos6/ を参考に,CentOS6にGit

  • 受付中

    GitLabを建てたい

    GitLabを建てたいのですが環境が特殊で苦戦しています。 http://hoge.com/AAAという AAA/は私が所属する部署へ割り振られていて外部に公開することが可

  • 解決済

    atom バグ?

    atom を使っているのですが いろいろなパッケージをとってコードを書いていたのですが いつからか パッケージなどもインストールできなくなり Fetching featured

  • 解決済

    Ansibleでgitlabのリポジトリの設定が空になる

    ymlファイルにgitモジュールのgitコマンドを記入し 実行しようとしたところ playbookの実行時に指定した"repo=●●●"  「●●●」部分が空になっているよう

  • 解決済

    Atomの画像表示

    最近、HTMLCSSを編集するために、Atom editorを使い始め、atom-preview-htmlをダウンロードしました。しかし、プレビュー画面からHTMLファイルやCSS

  • 解決済

    ファイルの状態を直前のプルした状態に戻すには

    GitLabを使っていて困ったことについて質問します。 他の人がpushしたリポジトリの状態を自分がpullして、あるファイルが更新されたとします。 その後、自分でそのファ

  • 解決済

    git push -u origin --allコマンドがよくわかりません。

    これは何をしているのでしょうか。 調べたら「ローカルのリポジトリに記録された変更をリモート・リポジトリに反映する」とのことですが、正直git自体、バージョン管理に使えるということ以

  • 解決済

    gitlab > gitlab.com への移行に関して

    お世話になっております。 今回 サーバ機gitlab > クラウドgitlab.com への移行を検討しているのですが、 見積もりがしたいため、移行できない項目があったらお伺いした

同じタグがついた質問を見る

  • Atom (テキストエディタ)

    508questions

  • GitLab

    125questions

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

  • TeX

    41questions

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

  • MathJax

    6questions

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