[Slack] Formatting your messages 日本語訳

<div class="itemsShowBody_adventCalendar_header">この投稿は <a class="title" href="/advent-calendar/2015/sansan">Sansan Advent Calendar 2015</a> の <span class="date">24日目</span>の記事です。</div>

## <i class="fa fa-cube"></i> はじめに
[会社の Advent Calendar](http://qiita.com/advent-calendar/2015/sansan) 向けに、何か記事を書くことになりました。当初は GitHub を使いやすくする Google Chrome 拡張を作る話でも書こうと思ったのですが、時間が確保できなかったので Slack のヘルプ記事を意訳して少しだけお茶を濁します。Slack と英語の勉強にもなるからいいかなと。

## <i class="fa fa-cube"></i> 記事について
[Slack Help Center](https://get.slack.help/hc) にある公式のヘルプ記事 [Formatting your messages](https://get.slack.help/hc/en-us/articles/202288908-Formatting-your-messages) の日本語訳になります。背景としては、エンジニアだけでなくマネージャーやデザイナーさんたちも Slack を使うようになったので、Slack の使い方を覚えてチーム内のコミュニケーションがより円滑になるといいなぁと思ったからです。非エンジニアの人に「英語のページ読めば分かるでしょ」は優しくないですよね。

皆さんのチームにも私みたいに英語が poor な人がいて、そんな人にこのページを紹介してくれたら非常に嬉しいです。もし好評だったら他のページも訳すかもしれないので、是非コメントいただければと思います。次に訳すとしたら [Emoji and emoticons](https://get.slack.help/hc/en-us/articles/202931348-Emoji-and-emoticons) とか [Emoji reactions](https://get.slack.help/hc/en-us/articles/206870317-Emoji-reactions) あたりですかね。[Creating a Snippet](https://get.slack.help/hc/en-us/articles/204145658-Creating-a-Snippet) でもいいかも。

<!-- h1 lang="en" class="article_title">Formatting your messages</h1 -->
## <i class="fa fa-slack"></i> メッセージの書式を設定する

<!-- p lang="en">Adding text formatting to your Slack messages is easy! We provide a handy selection of formatting options, outlined below:<br /><br /></p -->
<p lang="ja">Slack のメッセージに書式設定を追加するのは簡単です！以下で紹介するように、私たちは書式設定のための便利なオプションをいくつか用意しています。<br /><br /></p>

<p><span class="small">※ 訳注：Slack では<strong>テキストの前後に半角スペース</strong>がないと書式設定が有効になりません。例えば <code>ここは*強調*される</code> は、テキストの前後に半角スペースを入れて <code>ここは *強調* される</code> と書く必要があります。日本語のように分かち書きしない言語のことも考慮してほしい…。</span></p>

<!-- p lang="en"><span class="wysiwyg-font-size-x-large"><strong>Emphasis</strong></span></p -->
### <i class="fa fa-bold"></i> 強調（太字・斜体）

<!-- p lang="en"><span class="wysiwyg-font-size-medium">T</span>o emphasize words or phrases in your Slack messages, <strong>surround</strong> your text with *asterisks* to create bold text, or _underscores_ to italicize.</p -->
<p lang="ja"><span class="wysiwyg-font-size-medium"></span>Slack のメッセージ内の単語やフレーズを強調するために、*アスタリスク* でテキストを<strong>囲む</strong>と太字テキストが、_アンダースコア_ でテキストを<strong>囲む</strong>と斜体テキストが作成されます。</p>

<p><strong><strong><img src="https://get.slack.help/hc/en-us/article_attachments/203104027/emphasis.jpg" alt="" /><br /></strong><br /></strong></p>

<p><span class="small">※ 訳注：アスタリスクは星印やスター、アンダースコアは下線やアンダーバー、アンダーラインとも呼ばれます。アンダースコアは、標準的な日本語キーボードなら <kbd>Shift</kbd> + <kbd>\</kbd> で入力できます。</span></p>

<!-- p lang="en"><span class="wysiwyg-font-size-x-large"><strong>Strikethrough</strong></span></p -->
### <i class="fa fa-strikethrough"></i> 打ち消し線（取り消し線）

<!-- p lang="en">Try using strikethrough to show corrections in your messages, or mark completed items on a to-do list. Use ~tilde~ to <strong>surround</strong> the text you'd like to strike out. </p -->
<p lang="ja">メッセージの訂正箇所を示したり、TODO リストの項目が完了したことを表すなら、打ち消し線を使ってみてください。線を引いて削除したいテキストを ~チルダ~ を使って<strong>囲み</strong>ます。</p>

<p><img src="https://get.slack.help/hc/en-us/article_attachments/203506308/Formatting_-_strikethrough.jpg" alt="" /><br /><br /></p>

<p><span class="small">※ 訳注：チルダは「にょろ」と呼ばれることもあります。波線（〜）や全角チルダ（～）とは異なります。標準的な日本語キーボードなら <kbd>Shift</kbd> + <kbd>^</kbd> で入力できます。</span></p>

<!-- p lang="en"><span class="wysiwyg-font-size-x-large"><strong>Lists</strong></span></p -->
### <i class="fa fa-list"></i> リスト（箇条書き）

<!-- p lang="en">To create a list, use <kbd>Shift</kbd> <kbd>Enter</kbd> to create new lines in your message, then add a number or a bullet (•) before each item.</p -->
<p lang="ja">リストを作成するには、<kbd>Shift</kbd> + <kbd>Enter</kbd> を押してメッセージに新しい行を作成し、各項目の前に番号または黒丸（•）を追加します。</p>

<p><img src="https://get.slack.help/hc/en-us/article_attachments/203104077/lists.jpg" alt="" /><br /><br /></p>

<p><span class="small">※ 訳注：強調や打ち消し線のようにリスト形式に変換されて表示される訳ではありません。あくまでも「新しい行の先頭に番号や記号を付けると<strong>リストに見える</strong>」というだけで、入力したテキストはそのまま出力されます。</span></p>

<!-- p lang="en"><strong><span class="wysiwyg-font-size-x-large">Blockquotes</span></strong></p -->
### <i class="fa fa-quote-left"></i> 引用

<!-- p lang="en">Add angle brackets to the <strong>beginning</strong> of your message for an indent or blockquote:</p -->
<p lang="ja">インデント（字下げ）や引用のために、メッセージの<strong>先頭</strong>に山括弧（&gt;）を追加します。</p>

<!-- p lang="en"><strong><em>&nbsp;&nbsp;&nbsp;&nbsp;</em>&gt;</strong> to indent a single line<br /><strong><em>&nbsp;&nbsp;&nbsp;&nbsp;</em>&gt;&gt;&gt;</strong> to indent multiple paragraphs<br /><img src="https://get.slack.help/hc/en-us/article_attachments/203164438/brackets.jpg" alt="" /></p -->
<p lang="ja"><strong><em>&nbsp;&nbsp;&nbsp;&nbsp;</em>&gt;</strong> 単一の行をインデントします<br /><strong><em>&nbsp;&nbsp;&nbsp;&nbsp;</em>&gt;&gt;&gt;</strong> 複数行からなる段落をインデントします<br /><img src="https://get.slack.help/hc/en-us/article_attachments/203164438/brackets.jpg" alt="" /></p>

<p><span class="small">※ 訳注：三重の山括弧（&gt;&gt;&gt;）を使うと、それ以降に続く行も（山括弧がなくても）引用とみなされます。</span></p>

<!-- p lang="en"><strong><span class="wysiwyg-font-size-x-large">Code blocks</span></strong></p -->
### <i class="fa fa-code"></i> コー​​ドブロック

<!-- p lang="en">To display a portion of text as fixed-width code, <strong>surround</strong> your text with backticks:</p -->
<p lang="ja">固定幅のコードとしてテキストの一部を表示するには、バッククォートでテキストを<strong>囲み</strong>ます。</p>

<!-- p lang="en"><strong><em>&nbsp;&nbsp;&nbsp;&nbsp;</em>`single backticks`</strong> display as inline fixed-width text<br /><strong><em>&nbsp;&nbsp;&nbsp;&nbsp;</em>```triple backticks```</strong> create a block of pre-formatted,  fixed-width text</p -->
<p lang="ja"><strong><em>&nbsp;&nbsp;&nbsp;&nbsp;</em>`単一のバッククォート`</strong> は固定幅のテキストをインライン（行内）表示します<br /><strong><em>&nbsp;&nbsp;&nbsp;&nbsp;</em>```三重のバッククォート```</strong> は固定幅のテキストをフォーマット済みのブロックとして作成します</p>

<!-- p lang="en">Additional formatting like bold or italic text will not display in code blocks, and syntax highlighting isn’t currently supported. For enhanced code sharing, we suggest <a href="https://get.slack.help/hc/en-us/articles/204145658-Creating-a-Snippet">creating a Snippet</a>!</p -->
<p lang="ja">コードブロック内での構文の強調表示は現在サポートされていないため、太字や斜体などの追加の書式は表示されません。より強力にコード共有をするなら、私たちは<a href="https://get.slack.help/hc/en-us/articles/204145658-Creating-a-Snippet">スニペットを作成する（英語）</a>ことを提案します！</p>

<p><img src="https://get.slack.help/hc/en-us/article_attachments/203104017/backticks.jpg" alt="" /><br /><br /></p>

<p><span class="small">※ 訳注：バッククォートはグレイヴ・アクセントや backtick とも呼ばれます。引用符（'）とは異なります。標準的な日本語キーボードなら <kbd>Shift</kbd> + <kbd>@</kbd> で入力できます。</span></p>

<p><span class="small">※ 訳注：スニペットは Slack 内でコードを共有するための簡易ノートのような機能です。メッセージ入力欄の左端にある [+] ボタンを押して "Create a Snippet" を選択するか、ショートカットキーの <kbd>Shift</kbd> + <kbd>Ctrl</kbd> + <kbd>V</kbd>（<kbd>Shift</kbd> + <kbd>⌘</kbd> + <kbd>V</kbd>）から作ることができます。</span></p>

<!-- h2 lang="en"><span class="wysiwyg-font-size-x-large"><strong><a name="markdown"></a>FAQ</strong> </span></h2 -->
## <i class="fa fa-slack"></i> <a name="markdown"></a>FAQ（よくある質問）

<!-- p lang="en"><span class="wysiwyg-font-size-large"><strong>Why don’t you use Markdown syntax?</strong></span></p -->
### <i class="fa fa-question-circle"></i> Markdown 構文を採用しないのですか？

<!-- p lang="en">We're aware that some users would like to see enhanced Markdown options, but we don’t currently plan to support Markdown in Slack messages. The current formatting options — also used in other popular services — are more accessible to the many users unfamiliar with the Markdown conventions.<br /> <br /></p -->
<p lang="ja">一部のユーザーが Markdown オプションを望んでいることを私たちは知っていますが、今のところ Slack のメッセージで Markdown をサポートする予定はありません。現在の書式設定オプションは、他の一般的なサービスでも使われているので、Markdown 規約をよく知らない多くのユーザーにとって使いやすいでしょう。<br /><br /></p>

<p><span class="small">※ 訳注：つまり Markdown だけでなく軽量マークアップ言語（reSt や Wiki 記法、はてな記法、BB コードなど）や簡易 HTML に対応するつもりはないってことですね…残念。</span></p>

<!-- p lang="en"><span class="wysiwyg-font-size-large"><strong>Can I add formatting to bot messages?</strong></span></p -->
### <i class="fa fa-question-circle"></i> bot メッセージに書式設定を追加できますか？

<!-- p lang="en">For information about formatting bot messages, see the <a href="https://api.slack.com/docs/formatting">Message Formatting</a> page in our API docs.</p -->
<p lang="ja">bot メッセージの書式設定については、API ドキュメントの<a href="https://api.slack.com/docs/formatting">メッセージの書式設定（英語）</a>を参照してください。</p>

<p><span class="small">※ 訳注：Slack に組み込まれているロボット（自動プログラム）のことを Slackbot と呼びます。Slackbot はユーザーが自由に作ることができ、Slack のメッセージ中の特定のキーワードに反応して結果を返したり、GitHub や Jenkins などの外部サービスと連携して Slack に通知を流したりできます。Slackbot が返す bot メッセージでは、リンク付きテキストなど使用可能な書式設定が少しだけ拡張されています。</span></p>

## <i class="fa fa-cube"></i> おわりに
Qiita 初記事なのでおかしなところがあるかもしれませんし、残念ながら訳者の英語力には期待できません。誤字脱字や誤訳などありましたらコメントなどで遠慮なくご指摘ください。よろしくお願いします。

Slack のヘルプを読んでも書式設定の書き方がイマイチ分からない…という方は "DIRECT MESSAGES" にいる slackbot で練習してみてください。入力したメッセージは他人からは見えないので間違えても恥ずかしくないはず。

それから Slack 日本語版が欲しいという方は [Using Slack in different languages](https://get.slack.help/hc/en-us/articles/215058658-Using-Slack-in-different-languages) というページに次のような記述があります。 

> In the future, we’ll translate Slack into more languages.

（あまり期待しないで）待ちましょう^ ^

## <i class="fa fa-cube"></i> 関連リンク
 * [Formatting your messages – Slack Help Center](https://get.slack.help/hc/en-us/articles/202288908-Formatting-your-messages)（原文）
 * [Slack 設定メモ - Qiita](http://qiita.com/Luecy1/items/4055331d05e976272f36)
 * [【Slack】 絵文字と装飾のショートカットを覚えよう！ ｜ Developers.IO](http://dev.classmethod.jp/etc/slack-message-shortcuts/)
 * [【Slack FAQ 翻訳】支払いFAQ - 清水川Web](http://www.freia.jp/taka/blog/slack-faq-payment/)
 * [【Slack FAQ 翻訳】制限アカウントとシングルチャンネルゲスト FAQ - 清水川Web](http://www.freia.jp/taka/blog/slack-faq-restricted-accounts-and-single-channel-guest/)