middleman
esa.io

esa.io でゆるふわ情報共有 - Middleman Blog への Export サンプル付き #esa_io

More than 3 years have passed since last update.

esa.io でゆるふわ情報共有 - Middleman Blog への Export サンプル付き #esaio

概要

esa.io でゆるふわ情報共有
esa.pngesa2.png

esa.io って何?

esa は「情報を育てる」という視点で作られた、 小さな開発チームのためのドキュメント共有サービスです。

2014/12/17 現在は、β版。無料期間中。
2015年前半に有料化予定とのこと。

注意

esa だけだとググラビリティが低いので、 esa に関する情報を発信する側も検索する側も
esa.io にしたほうが良さそう。 golang みたいに。
ハッシュタグは「#esa_io」だろうか?

類似サービス

QiitaTeam

  • esa.io について Qiita で詳しく書くのっていいのかな・・・ ((((;゜Д゜)))))))ガクガクブルブル
  • 必ずしも競合ともいえないかも。 QiitaTeam と esa.io の両方を使うケースも考えられる
    • 例えば
      • 技術情報・手順は QiitaTeam
      • ポエム・スライドショーは esa.io
    • esa.io に関する情報を QiitaTeam に書くこともあるだろうし、その逆も

Docbase

  • 試したことはないが、トップページの記述からするとターゲット層は esa.io に近そう
  • ゆるふわな esa.io に比べて、 かっちりとしたビジネスライクな印象のサイトデザイン

特徴

情報を書くことへの敷居を下げる工夫

  • カテゴライズが容易
    • 記事タイトルをスラッシュ区切りにするだけでカテゴライズ
    • かなり使い勝手が良く、他サービスとの大きな差別化になっている。投稿が増えてきたときに力を発揮するだろう
  • WIP 投稿
    • 生煮え上等。公開を迷うくらいならとりあえず WIP で記事化
    • 問題なくなったら Ship IT
  • ゆるい雰囲気
    • 楽しさ
  • Star
  • emoji
    • 楽しさ
    • 分かりやすさ

ドックフーディングによる使い手感覚の機能

スライドショー

  • 記事をスライドショー化
    • reveal.js 的なことを Markdown の記事を作成するだけで実現可能

よくある機能もちゃんと持っている

  • Web hooks
    • Slack
    • Hipchat
    • Idobata
  • Mail hooks
  • GitHub Flavored Markdown をベースに拡張
    • TODO 記法
    • emoji 記法
  • Realtime Preview
  • タグ
    • 記事タイトルに #tag_name 形式で指定しやすい
  • 記事の履歴管理
  • インポート・エクスポート機能(インポートは開発中)
  • API(開発中)

esa.io のデザイナさんのスライド

エクスポートした記事を Middleman blog に公開してみる

  • esa.io で記事を書きます

※タイトル

手順書/テンプレ利用テスト

※本文

## 前提
* 前提1
* 前提2
* 前提3

## 手順
    class Hoge
      def hoge
        puts "hoge"
      end
    end

## 注意点
* なし
  • Team Page の Request archive for exporting の Request Archive ボタンを押下
  • メールが届くので、メールのリンクからファイルをダウンロード
  • zip を解凍します
  • 解凍したマークダウンの内容が Middleman 向けのフォーマットになっていることを確認します
---
title: "テンプレ利用テスト"
date: 2014-12-17 10:42:06 +0900
tags: 
category: /手順書/
published: false
---

## 前提
* 前提1
* 前提2
* 前提3

## 手順
    class Hoge
      def hoge
        puts "hoge"
      end
    end

## 注意点
* なし
  • Middleman blog 環境構築
# 作業用ディレクトリの作成
$ mkdir middleman
$ cd middleman

# Gemfile の生成
$ cat << EOS >> Gemfille
source "https://rubygems.org"
gem "middleman"
gem "middleman-blog"
EOS
$ bundle install

# middleman プロジェクト作成
$ middleman init esa --template=blog
$ cd esa
  • 先ほど解凍した esa のファイルの1つを middleman で作成した esa/source にコピー
  • ファイル名を 2014-12-17-procedures-template.md にします
# middleman の起動
$ bundle exec middleman

middleman_blog.png

※ Middleman は Itamae の検証用に疎通確認しかしたことがなくて、利用作法をあまり理解していない

雑感

  • 提供されている機能を見る限り今後の機能拡張も非常に期待が持てる(開発者のセンスを感じる)
  • デザインも良い
    • ゆるふわ感を出すためのためのデザインのおかげで結果的にレイアウトにメリハリがついて情報を理解しやすいように感じる
      • 逆にのっぺりとした平坦なデザインは理解しにくい
    • マウスフォーカス時に動作や、アイコンの絵柄などわかりやすさへの配慮を感じる
  • スライド機能がすごく良い
  • 小さなチーム向け、ということで正式版の価格帯に注目が集まる

参照