ASCIIバナー生成(ソースコード・README)

短い名前を、ファイルや README で目立つ見出しにする。コメントで包み、桁に収めてコピーする。

設定

書体
文字間隔
文字サイズ
塗り方
セル比率(横 × 縦)

等幅フォントの文字は横より縦に長いため、1×2 セルを選ぶと元の書体に近いプロポーションが保てます。

ファイルへ貼る
コメント化/上下フェンス

バナーを描いたあと、この端末でコメント記号を付けます。コピーは画面どおりです。

桁の予算
整形
字下げ
Ctrl + Enter(Mac は ⌘ + Enter)か、右の生成を押します。 0 / 500

0 文字

ヒント

長い説明ではなく、短い名前を入れる

バナーは、小さな文字のマスを並べて大きな字形を作ります。関数名やファイル名くらい短いもの(init、main)なら、その字形が読めます。説明の一文を入れるとマスが足りず、何と書いてあるかわかりません。二語使うなら、改行して二段にし、それぞれが大きく残るようにします。

コメント記号も、1行の幅に含まれる

コメント化すると、各行の先頭に // や字下げの空白が付きます。エディタの桁数えは、それも含めます。ファイルを1行80字に揃えているなら、予算も80にします。ここでは収まって見えても、貼ったあと右に飛び出すことがあります。フィットは、コピーする塊がその幅に入るまで小さくします。

/* */ で包むと、絵の中の */ でコメントが終わる

C や Java では、/* から最初の */ までがコメントです。塗りが * と / を隣り合わせに描くと、そこから先はコードとして読まれます。このページは間に空白を入れて防ぎます。塗りを # や . にすれば、その並び自体が出ません。各行を // で始める包み方には、この終わり記号はありません。

README とソースでは、使える文字が違う

README は普通、どんな文字でも置けます。カーネル向けや古い検査のソースは、英語の文字と記号だけしか受け付けないことがあります。█ のような塗りは README では見やすいですが、そういうソースでは弾かれます。そちらへ貼る前に ASCII のみをオンにし、名前も英語の綴りにします。

コメントにしても、1行は80桁が目安

文字同士の空白を使うと印象は変わりますが、コメント化用の文字と組み合わせると、80桁は簡単に超えます。その点に注意が必要です。

ソースファイル上で、短い名前の見出しを80桁の定規で見た図です。生成画面ではなく、貼り付け先のファイル先頭を説明しています。init.c に # で包んだ init の描画と int init(void); があり、赤い80の線より左で終わっています。
init.c に # コメントとして
同じ描画をソース上で80桁の基準で並べた図です。コメント記号とインデントが桁の予算を食うことを示しています。上の index は定規の左に収まり、下はインデント付き // で赤い溢れ域に入っています。
コメントなしと、字下げした //

よくある使い方

📄

ソースの先頭に置く

.c や .py のいちばん上に、短いモジュール名をコメントとして置きます。普通の文字なので、差分にも同じ字が出ます。1行80字のファイルなら、予算も80にします。

📂

README の見出しにする

リポジトリの README を、プロジェクト名のバナーで開けます。上下フェンスで囲めば、画像の置き場も、ファイルが動いたあとの切れリンクも要りません。

💻

端末を開いたときに出す

ログイン時のメッセージ、シェルの起動ファイル、tmux に貼ります。遠くの SSH では画像は出ませんが、この文字は出ます。

🔧

スクリプトの区切りにする

Makefile のターゲットや、デプロイ用の断片の上に小さなバナーを置きます。画面用の飾り文字は使わず、ファイルの中の文字だけで区切ります。

📝

プルリクエストの説明に置く

名前の付いたコマンドやバイナリの変更なら、説明文にフェンス付きバナーを置けます。レビューする人の画面が違っても、同じ文字が見えます。

よくある質問

入力はサーバーへ送られますか?
はい。入力はサーバーへ送り、メモリ上でバナーにして、応答を返した瞬間に捨てます。ディスクには残さず、記録にも出しません。コメント化・字下げ・ASCII のみはこの端末のままです。
何文字まで入れられますか?
改行込みで1回500字までです。バナーは短い名前1つが普通なので、普段はこの上限には当たりません。
なぜ80桁を超えるのですか?
各行の先頭のコメント記号と字下げも、幅に入ります。ファイルが使っている幅を予算にして、「桁に合わせる」を押します。いちばん小さくしても超えるなら、名前を短くします。
ソースのブロックコメントが壊れますか?
絵の中に */ があり /* */ で包むと、そこでコメントが終わり、続きがコードとして読まれます。このページはその並びの間に空白を入れます。塗りを # か . にすれば、その並び自体が出ません。
英語以外の文字もバナーにできますか?
できます。和文・中韓の書体を選ぶか、モノスペースのままでも、入力した漢字・かな・ハングルは描きます。英語の文字と記号だけしか受け付けないファイルへ貼るなら、ASCII のみをオンにして、名前も英語の綴りにします。
画像からの変換と何が違いますか?
こちらは、入力した文字を書体で描きます。画像ツールは写真をマスに落とします。写真はそちら、ファイルに貼る名前はこちらです。