Emacs JP
このサイトについて
Emacs JPはGNU Emacsと日本語に関わるあらゆるリソースを集約することを目的としたコミュニティサイトです。
https://emacs-jp.slack.com
Slack -参加したい方はこちらの 招待リンク からサインアップできます。
ページ作成者向け情報
Docker
docker及びdocker-composeを利用してローカルの環境に影響を与えずに、簡単にローカルサーバーを立てることができます。
# ローカルサーバーを立てる (以下のいずれかを選んで実行する)
make up # localhost:4000 でローカルサーバーを立てる
make serve # make upのエイリアス
PORT=3000 make up # localhost:3000 でローカルサーバーを立てる
# ビルドログを見る
make log
# 後片付け
make down
システムのRuby
RubyおよびBundlerが必要です。詳細はUsing Jekyll as a static site generator with GitHub Pages - GitHub Helpをお読みください。
git clone git@github.com:emacs-jp/emacs-jp.github.com.git
cd emacs-jp.github.com
bundle install
cd docs
bundle exec jekyll serve # localhost:4000 でローカルサーバーを立てる
ポート番号を変える場合 --port
オプションのあとにポート番号を指定してください。
コンテンツ作成のルールとtips
記事はブログポストとページの2種類があります。
- ブログポストは
/docs/_posts
以下に%Y-%m-%d-<name>.md
というファイル名で作成します。 - ページは以下のルールで作成します
docs/env/<lang>.md
: コンピューター言語 lang 向けの環境構築についてdocs/packages/<pkg>.md
: パッケージ pkg の紹介及び設定についてdocs/tips/<name>.md
: 雑多な話題について
なにか疑問や提案があればissueで相談して頂ければと思います。
org-mode
org-modeを用いてブログを生成できます。
-
docs/org/config.el
をload
-
docs/org/
以下に作りたい階層と同じ構造でorgファイルを作成、編集新規ファイル作成後、
M-x my/insert-emacs-jp-template
でテンプレートを挿入できます。 -
M-x my/publish-emacs-jp
でdocs/org/
以下のorgをmdに一括変換