BBCodeはosu!で使われているマークアップ言語です。インターネット上にあるフォーラムによくBBCodeが使われています。書式設定をするために使用され、フォントサイズの変更や画像埋め込みなどを示すために文字を囲むタグで構成されます。osu!サイト内では、フォーラムだけでなく、ユーザーページやビートマップの説明などにもBBCodeが使用できます。
フォーラムの投稿画面
テキストを選択せずにツールバーのボタンを押すと、投稿エディタのカーソルの左右に開いたタグと閉じたタグが追加されます。テキストを選択してからボタンをクリックすると、そのテキストがタグで囲まれます。
複数の書式設定を同じテキストに適用させる場合は、BBCodeタグを内側から外側に向けて配置することで適用されます。これらのタグの順番は正しくしなければなりません。そうしないと、書式設定が壊れます。
例えば、[centre][b]text[/b][/centre]
は正しくて、[b][centre]text[/b][/centre]
は間違いです。
BBCodeは、他のマークアップ言語と同様に、角括弧([]
)で囲むことでタグと認識させます。タグには、開始タグと終了タグがあり、スラッシュ(/
)を含めることで区別されます。具体的には、終了タグには最初の角括弧の右隣にスラッシュが含まれますが、開始タグには含まれません。
また、開始タグには、URL、フォントサイズ、その他の変更可能な値の要素を示すために、内部に等号(=
)が含まれることがあります。
以下がosu!で使用できるBBCodeの一覧です。
[b]テキスト[/b]
[b]
タグは、太字にしてテキストを強調するために使用されます。太字はフォントサイズには影響しません。
ツールバーボタン:
[i]テキスト[/i]
[i]
タグは、テキストを傾けることによって軽く強調するために使用されます。ただし、フォントの影響で日本語は斜体になりません。
ツールバーボタン:
[u]テキスト[/u]
[u]
タグは、テキストの下に線を引くことによって強調するために使用されます。線は、太字や斜体などの影響を受けます。
[strike]テキスト[/strike]
[strike]
タグは、テキストの半分のところに線を引くことによって削除を示すために使用されます。
ツールバーボタン:
[color=16進数のカラーコード]テキスト[/color]
全ての色の名前のリストはこちらを参照してください。
[color]
タグは、テキストに色を付けるために使用されます。引数には 16進数のカラーコードで色を指定しますが、redやgreenなどの色の名前で指定することもできます。
引数に何も指定されていない場合は、BBCodeとして解釈されません。
[size=大きさ]テキスト[/size]
[size]
タグは、文字の大きさを変えるために使用されます。現在、osu!で使用できるサイズは50、85、100、150の4種類あります。ツールバーには、それぞれ「極小」、「小」、「中」、「大」の選択ができます。
上記の4種類以外の値を引数にすると、大きさは変わらず、既定の大きさになります。
ツールバーボタン:
注: スポイラーボックスと混同しないでください。
[spoiler]テキスト[/spoiler]
[spoiler]
タグは、テキストを通常では見えなくするために使用されます。テキストが選択されると文字が見えるようになります。[spoiler]
内に[color]
タグを配置した場合、通常でも隠されずに表示されます。ただし、スポイラー内のテキストは、読みやすいかどうかにかかわらず、色付けされます。
このタグは、一般的にはネタバレを隠すために使用されます。
注: スポイラーボックスと混同しないでください。
[box=名前]
内容
[/box]
[box]
タグは、大きすぎる画像や通常は表示させる必要のない内容をまとめて隠す場合に使われます。内容の上にはクリック可能なハイパーリンクが設置され、クリックすると展開したり隠したりすることができます。
ハイパーリンクのテキストは引数で指定できます。指定しない場合、BBCodeとして解釈されません。
このタグは、一般的にはフォーラム投稿で、長文や大きな画像を隠すために使われます。
注: ツールバーボタンには「スポイラー」と書いてありますが、生成されるのは[box]
です。
ツールバーボタン:
[spoilerbox]内容[/spoilerbox]
スポイラーボックスは、引数を指定しないボックスです。ハイパーリンクのテキストは常にSPOILER
と表示されます。機能はボックスと同じです。
[quote="名前"]
テキスト
[/quote]
[quote]
タグは、ピンクの縦線を引くことによって引用であることを示すために使われます。引数には引用元のユーザ名を指定します(省略可能)。
注: 名前は引用符("
)で囲む必要があります。
osu!のフォーラムでは、他のユーザーの投稿に返信するために使用されることが一般的です。返信ボタンはその投稿をホバーした際に表示されます。
[code]
テキスト
[/code]
[code]
タグは、コードをフォーマットするために使用されます。osu!サイトの場合、黒色のボックス内にテキストがフォーマットされます。[code]
内ではタグがBBCodeとして解釈されなくなります。
osu!では、ストーリーボードの投稿やBBCode、コマンド、ソースコードなどを説明するために使われます。
[centre]テキスト[/centre]
[centre]
タグは、テキストを画面の中央に揃えるために使用されます。これは、タイトルや見出しなどによく使われます。[quote]
タグを[centre]
タグの中に配置すると、引用内のテキストは中央揃えになりますが、引用を示す縦線などは中央に配置されません。
[url=URL]テキスト[/url]
[url]
タグは、通常のテキストをクリック可能なハイパーリンクにするために使用されます。
注: osu!では適切なURLを自動的にハイパーリンクにします。ハイパーリンクのテキストを指定しない場合は、このタグを使用する必要はありません。
このタグには、ハイパーリンクテキストと、移行先のURLの2つを指定する必要があります。テキストは開始タグと終了タグの間に、URLは引数に指定する必要があります。テキストが指定されていない場合、テキストはURLと同じになります。
ツールバーボタン:
[profile=ユーザーID]ユーザー名[/profile]
[profile]
タグは、ユーザープロフィールにリンクするために使用されます。ユーザー名またはユーザーIDのどちらかを指定します。タグによって作成されたリンクをホバーすると、ユーザーカードが表示されるという点で、[url]
タグとは異なります。
注: ユーザーIDは、プロフィールページのURLの/users/の後に続く数字です。
ユーザーIDのみで指定する場合、開始タグと終了タグの間に何かテキストを入れる必要があります。そのテキストは表示されず、実際にはユーザー名が表示されます。
ユーザー名のみで指定した場合で、リンク先のユーザーがユーザー名を変更した場合、リンクは機能しなくなります。
[list=タイプ]
[*]テキスト1
[*]テキスト2
[*]テキスト3
[/list]
[list]
タグは、箇条書きしたリストをフォーマットするために使用されます。新しい項目を作るには、冒頭にアスタリスク(*
)がついたタグを配置する必要があります(上記参照)。タイプを指定しない場合、点ごとに箇条書きされたデフォルトのリストになります。
タイプの引数に何かを指定すると、リストのタイプが数字になります。
注: このタグは何重にも重ねて配置することができますが、この場合、書式の問題が発生することが知られています。
ツールバーボタン:
[email=アドレス]テキスト[/email]
[email]
タグは、メーラーを開くためのクリック可能なハイパーリンクを作成します。リンクをクリックするとアドレス宛へのメールが作成されます。
アドレスの引数には有効なメールアドレスを指定する必要があり、テキストの引数にはハイパーリンクとして表示するテキストを指定します。テキストの引数を指定していない場合はBBCodeとして解釈されません。
[img]画像のURL[/img]
[img]
タグは、ネット上にある画像を表示するために使用されます。画像を表示するには、画像の直URLを指定する必要があります。また、ローカルファイルのパス(例:C:\Users\Name\Pictures\image.jpg
)は動作しません。
注: ウェブサイトのURLは画像アドレスと同じではありません。
画像のURLを取得するには、その画像があるサイトに移動し、画像を右クリックして画像のURLをコピーする必要があります。
ネット上にあるどの画像でも使用できますが、一部のサイトには、そのサイトのみ表示可能で、別サイトには画像を表示させない仕組み(通称ホットリンク)を使用している可能性がるため、Imgurのような評判の良い画像アップローダーを使用することをお勧めします。
ツールバーボタン:
[youtube]動画ID[/youtube]
[youtube]
タグは、サイトにYouTubeの動画を埋め込むために使用されます。動画を表示させるには、タグの間に動画ID(URL全体ではない)を指定する必要があります。
動画のIDはURLのv=
の後に続く11文字の文字列です。
[audio]音声ファイルのURL[/audio]
[audio]
タグは、ネット上にある音声ファイルを埋め込むために使用されます。どのネット上にある音声ファイルでも使用できます。ローカルファイルパス(例:C:\Users\Name\Music\audio.mp3
)は機能しません。
注: 著作権侵害の懸念から、すべてのファイル共有サービスがリッピングを歓迎しているわけではありませんので、ご注意ください。osu!は、その点についての著作権の問題について責任を負いません。
音声ファイルを埋め込むには、タグの間にURL(例: https://www.example.com/example.mp3
)を指定する必要があります。
[heading]テキスト[/heading]
[heading]
タグは、テキストをピンク色の大きな見出しにフォーマットするために使用されます。このタグは複数行に対応していません。
ツールバーボタン:
[notice]
テキスト
[/notice]
[notice]
タグは、暗い背景に輪郭の付いたボックス内にテキストをフォーマットするために使用されます。このタグは、告知や予告などに使われています。
これらは、かつてosu!のあちこちで使われていたBBCodeです。現在は使用できませんが、これらの使用法は、歴史的な目的のために説明されています。
[google]検索ワード[/google]
[google]
タグは、かつてosu!で使用されていた古いタグです。クリックすると、検索ワードの部分のテキストを使用してGoogle検索結果にリンクします。
このタグは、Googleがユーザーの結果をパーソナライズするため、まったく同じ結果がすべての人に表示されるわけではありません。また、特定の国では、言語や国の制限のために一部の検索結果が非表示となることがあります。
[lucky]検索ワード[/lucky]
[lucky]
タグは、かつてosu!で使用されていた古いタグです。クリックすると、検索ワードの部分のテキストを使用してGoogle検索結果の一番上にあるサイトにリダイレクトされます。このタグを介してリンクされているサイトは、タグの性質上誰にとっても同じではありません。
[テキスト]
見出し(v2)タグは、かつてosu!で使用されていた古いタグです。テキストを水平線付きの紫色の見出しにフォーマットするために使用されます。このタグは、ビートマップのフォーラムでのみ機能し、投稿後(プレビューではない)にのみ表示されました。このタグが使われていたころはツールバーボタンがなく、開閉括弧の中に指定していました。
[color]
タグの引数にtransparent
(透明)と指定するとテキストを透明にできるバグがありました。