HSP-Knowledgeへようこそ! このサイトでは、HSPに関する知識やTipsをみんなで共有できます。
📝 投稿の流れ
記事の投稿は以下の3ステップで完了します:
- リポジトリをFork
- 記事ファイルを作成・編集
- Pull Requestを送信
1. リポジトリをFork
まず、GitHub リポジトリにアクセスして、右上の「Fork」ボタンをクリックします。
これであなたのGitHubアカウントにリポジトリのコピーが作成されます。
2. 記事ファイルを作成
ファイル名のルール
_posts/フォルダ内に、以下の形式でファイルを作成します:
YYYY-MM-DD-記事のタイトル.md
例: 2025-12-07-my-first-hsp-article.md
テンプレートを使う
_posts/template.mdをコピーして使うと便利です:
cd _posts
cp template.md 2025-12-07-my-article.md
記事の構造
記事ファイルは以下の構造になっています:
---
layout: post
title: 記事のタイトル
date: 2025-12-07 12:00:00 +0900
author: あなたの名前
tags: [小技, HSP3]
summary: 記事の概要を120文字以内で
---
ここに本文を書きます。
## 見出し
Markdown形式で自由に記述できます。
### コード例
```hsp
mes "Hello, HSP!"
### ⚠️ 重要: `date`フィールドについて
`date`フィールドは記事のURL生成に使用されます。**一度公開した記事の`date`を変更すると、URLが変わり、既存のリンクが無効になります。**
記事を更新した日時を記録したい場合は、`date`を変更せず、代わりに`lastupdate`フィールドを追加してください：
```markdown
---
layout: post
title: 記事のタイトル
date: 2025-12-07 12:00:00 +0900
lastupdate: 2025-12-10 15:30:00 +0900 # 更新日時
author: あなたの名前
tags: [小技, HSP3]
summary: 記事の概要を120文字以内で
---
3. タグの選び方
記事には適切なタグを付けると、他のユーザーが見つけやすくなります。
推奨タグ
以下のタグを積極的に使ってください:
- 小技 - ちょっとしたテクニックやTips
- チュートリアル - 初心者向けの解説記事
- 応用 - 高度な技術や実践的な内容
その他、自由にタグを追加できます。
4. Pull Requestを送信
記事を書き終えたら、以下の手順でPull Requestを送信します:
- 変更をコミット
- Forkしたリポジトリにプッシュ
- GitHubでPull Requestを作成
- レビュー後、マージされます
GitHubのWeb UIで編集する場合
- Forkしたリポジトリの
_posts/フォルダを開く - 「Add file」→「Create new file」をクリック
- ファイル名と内容を入力
- 「Commit new file」をクリック
- Pull Requestタブから「New pull request」を作成
💡 記事を書くコツ
見出しを活用する
## 大見出し
### 中見出し
#### 小見出し
コードブロックを使う
HSPコードにはhsp言語指定をすると、シンタックスハイライトが適用されます:
```hsp
#include "hsp3utf.as"
mes "日本語も使えます"
```
↓
#include "hsp3utf.as"
mes "日本語も使えます"
画像を追加する
画像はassets/images/フォルダに配置し、以下のように参照します:
リンクを追加する
[HSP公式サイト](https://hsp.tv/)
🎨 プレビューする
ローカル環境でJekyllをインストールしている場合、以下のコマンドでプレビューできます:
bundle exec jekyll serve
ブラウザでhttp://localhost:4000/HSP-Knowledge/にアクセスすると、記事のプレビューが表示されます。
❓ 困ったときは
- GitHub Discussions で質問する
- Issuesで問題を報告する
- HSPTV! 掲示板で相談する
⚖️ ライセンスについて
本サイトに投稿された記事は、以下のライセンス方針で公開されます。投稿をもってこれに同意したものとみなされます。
- コードブロック・スニペット: CC0 1.0 Universal (パブリックドメイン)
- ユーザーは商用・非商用を問わず、クレジット表記なしで自由にコードを利用・改変できます。
- 記事本文: CC BY 4.0 (クリエイティブ・コモンズ 表示 4.0)
- 記事を転載・引用する場合は、元の記事へのリンクや著者の表示が必要です。
まとめ
記事の投稿は思ったより簡単です! あなたの知識をぜひ共有してください。
みんなで作るHSPナレッジベース、よろしくお願いします 🎉
コメント