2023-01-05

記事の書き方

by @ojii3

手順

記事管理用リポジトリ を更新することがメイン工程となります。

MCC からのお知らせ記事(活動報告も含む)は、newsフォルダに、それ以外(技術記事・ポエムなど)はblogフォルダにおきます。

例えば、「ホームページリニューアル」というお知らせ記事を作成する手順は以下のようになります。

  1. 記事管理用リポジトリ にアクセスし、newsフォルダに進みます。
  2. ページ右上のCreat new fileを押すと、ブラウザ上で簡易エディタが開くので、ファイル名をhomepage-renewal/index.mdなどとして下さい。 スラッシュ/以降は必ずindex.mdです
  3. マークダウンで記事を書きます。その際の書き方は後ほど述べます。
  4. mainブランチにcommitして保存します。
  5. 次の正午までにホームページに更新が反映されます。

※ 逆に、ファイル名を、_index.mdなどとして保存することで、下書き状態を作れます。

注意事項

記事の先頭に以下のような記述が必要です。(Frontmatter)

blog/bocchi-the-rock/index.md
---
title: "ぼっち・ざ・ろっくを鑑賞しました"
img: "./bocchi-the-rock.webp"
date: "2023-01-03"
tags: [dev, web, nextjs]
author: "Goto Hitori"
---

title, dateは必須で、dateについてはクォートで括ってください。

また、画像の URL は、同じフォルダに画像をアップロードし、./画像のファイル名とするか、httpsから始まる外部URLでお願いします。

なお、ブラウザ上から編集する際は、ドラッグ&ドロップで簡単に画像を置くことができます。

(前者の相対パスの方法を推進)

![alt text](./bocchi.webp)

alt text

![logo](https://user-images.githubusercontent.com/84656786/224228583-2f400e96-e64a-4322-9c87-9c0066c43f8f.svg)

logo

マークダウンの書き方

マークダウンの書き方を紹介します。基本文法は同じですが、所々他のブログサービスと相違があります。

見出し

見出しの右にはリンクがつきます。目次(未実装)とか、ページ内リンクに対応できます。

# これは h1 の見出しです
 
## これは h2 の見出しです
 
### h3~は文字サイズが徐々に小さくなるだけです。h6 まで

これは h1 の見出しです

これは h2 の見出しです

h3~は文字サイズが徐々に小さくなるだけです。h6 まで

リスト

箇条書きには-, +, *などが使えます。箇条書きの方はネストできます。

- リスト１
- リスト２
  - リスト 2-1
  - リスト 2-2
 
1. 番号付きリスト 1
2. 番号付きリスト 2
  1. 番号付きリスト 1
  2. 番号付きリスト 2

チェックボックス

- [ ] チェックボックス 1
- [x] チェックボックス 2

斜体・強調・打消し

*,**は_,__と置き換えられます

_Italic 斜体です_
 
**強調**
 
~~打消し線（css の装飾）~~

Italic 斜体

強調

打消し線（css の装飾）

リンク

[外部リンク](https://www.google.com)
 
[内部リンク](/gallery)
 
生のリンク: <https://google.com>

外部リンク

内部リンク

生のリンク: https://google.com

画像

外部 URL
![画像](https://www.google.com/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png)
 
内部 URL (相対パス)
![bocchi](./bocchi.webp)

外部 URL 画像

内部 URL (相対パス) bocchi

折りたたみ

<details>
<summary>折りたたみ</summary>
 
折りたたみの中身です
 
</details>
折りたたみ

折りたたみの中身です

脚注

脚注[^1]
 
[^1]: 脚注です

脚注1

表

| title        | date | tags     |
| ------------ | ---- | -------- |
| こんにちは   | 2022 | web, dev |
| これは表です | 2022 | web, dev |
titledatetags
こんにちは2022web, dev
これは表です2022web, dev

引用

> 引用です。
>
> > 引用の中の引用です。
>
> That's all.

引用です。

引用の中の引用です。

That's all.

インラインコード

`これはインラインコードです` `Font は JetBrains Monoを使用` `` コード内で"`"を使うには、"`"を一個追加してはさみます ``

これはインラインコードです Font は JetBrains Monoを使用 コード内で"`"を使うには、"`"を一個追加してはさみます

コードブロック

タイトル(ファイル名)はあってもなくてもいけます。タイトルのみ書くことはできません。

markdown
```python title="blog.py"
print('Hello World')
```
blog.py
print('Hello World')
markdown
```diff
- これは削除です
+ これは追加です
```
- これは削除です
+ これは追加です

特定の単語や行のハイライトなど、その他の機能はこちらを参照してください。

数式

$\KaTeX$ を使用しています。 $$ L = \frac{1}{2} \rho v^2 S C_L $$

KaTeX\KaTeX を使用しています。

L=12ρv2SCLL = \frac{1}{2} \rho v^2 S C_L

Emoji

:smile: :+1: :tada: :rocket: :metal:

😄 👍 🎉 🚀 🤘

埋め込み

<a class="twitter-timeline" href="https://twitter.com/TUATMCC?ref_src=twsrc%5Etfw">Tweets by TUATMCC</a> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

脚注

  1. 脚注です ↩

← 記事一覧に戻る