Preface (はじめに)

Qiitaの記事を作成から投稿までターミナルで行おうとするツールそれがqiita_orgです.
本記事では, 作成者さんのQiita記事をもとにインストールから各種設定まで行い, 最後に簡単な例を作ります.

qiita_org

インストール

> gem install qiita_org

ちゃんと入ったか確認

> qiita

Commands:
  qiita all [teams/public/private] [options]    # post all org files in the directory
  qiita config [global/local] [option] [input]  # set config
  qiita get [qiita/teams] [ITEM_ID]             # get qiita report
  qiita help [COMMAND]                          # Describe available commands or one specific c...
  qiita list [qiita/teams]                      # view qiita report list
  qiita post [FILE] [private/public/teams]      # post to qiita from org
  qiita say_hello                               # say_hello
  qiita template                                # make template.org
  qiita upload [FILE] [teams/public/private]    # upload about image to qiita
  qiita version                                 # show version

無事完了.

設定

前提

qiita_orgはgetコマンドでpandocを使うためインストールします.

> brew install pandoc

ubuntu

> sudo apt update
> sudo apt install pandoc

設定ファイル作成

設定ファイルを作成するために以下のコマンドを実行

> qiita config global

するとホームディレクトリに.qiita.confという設定ファイルが作られます.

現時点では,

/Users/[User Name]/.qiita.conf

  "name": ""
  "email": ""
  "access_token": ""
  "teams_url": ""
  "ox_qmd_load_path": ""

となっています.

設定ファイルの変更とQiitaのアクセストークン発行

上から一つずつ設定していきます.

名前

> qiita config global name "Your Name"

メールアドレス

> qiita config global email "Your Email address"

アクセストークン

Qiitaの設定のアプリケーションで個人用アクセストークンを新しく発行する. アクセストークンの説明を書き込み, スコープではすべてにチェックを入れる.

ページが推移した後に表示されるアクセストークンをコピーし,以下を実行
※アクセストークンはページを移動すると再表示されなくなるため注意!!

> qiita config global access_token "Your Access token"

TeamsのURL

teamsオプションのために必要. 所属しているQiitaTeamのURLを書き込むただし, なければ何もしなくてもいいです.

> qiita config global teams_url "Your Qiita Teams URL"

※URLは最後に/をつけ忘れないように注意

ox-qmd

ox-qmd.elを ~/.emacs.d/site_lisp 下に作成する.

次に ~/.emacs.d/init.elに以下を加える.

;; elファイルの置き場所を設定 
(setq load-path (cons "~/.emacs.d/site_lisp" load-path))

(require 'ox-qmd)
(add-to-list 'ox-qmd-language-keyword-alist '("ruby" . "ruby"))

これで初期設定は完了です.

簡単な例

例えば, templateコマンドで適当なorgファイルを作り, 以下のような内容に編集してpostコマンドで投稿すると

　* equation <2020-10-28 水>
  　$$
    　\int_{x=1}^{x=3}\ln \left(\frac{1}{4x}\right) {\rm d}x
  　$$

下のような記事が作成できる.

equation <2020-10-28 水>

$$ \int_{x=1}^{x=3}\ln \left(\frac{1}{4x}\right) {\rm d}x$$

qiita_orgのインストール