Medium投稿をJekyllブログに移行|投稿同期で更新も簡単管理
Mediumの投稿をJekyllブログへ移行し、将来的な記事同期も自動化。投稿管理の手間を減らし、ブログ更新を効率化したい方に最適な解決策です。
本記事は AI による翻訳をもとに作成されています。表現が不自然な箇所がありましたら、ぜひコメントでお知らせください。
記事一覧
ZMediumToJekyll
Mediumの投稿をJekyllブログに移行し、今後も同期を保ちましょう。
このツールは、Mediumの投稿をJekyllブログに移行し、今後も同期を保つのに役立ちます。
Mediumから投稿を自動的にダウンロードし、Markdownに変換してリポジトリにアップロードします。オンラインデモは私のブログおよびzhgchg.liをご覧ください。
一度の設定で、一生楽しめる❤️
Powered by ZMediumToMarkdown .
もしMediumの投稿のバックアップや自動同期だけを行いたい場合は、このWikiの手順に従って、直接GitHub Actionを使用できます。
セットアップ
- 以下のビデオチュートリアルを見ながら、各ステップを一緒に進めることができます。
上にある緑色のボタン
Use this templateをクリックし、Create a new repositoryを選択してください。Repo Ownerは組織名またはユーザー名です。
リポジトリ名を入力してください。通常はGitHubのユーザー名または組織名を使用し、末尾に
.github.ioを付けます。例えば、私の組織名がzhgchgliの場合、リポジトリ名はzhgchgli.github.ioとなります。publicリポジトリオプションを選択し、次にCreate repository from templateをクリックします。GitHubリポジトリの
Settingsタブに移動し、Actions->Generalを選択して、Workflow permissionsセクションを見つけます。次に、Read and write permissionsを選択し、Saveをクリックして変更を保存します。
*リポジトリ名を変更した場合、GitHubページのURLは https://username.github.io/Repository Name となり、https://username.github.io/ ではなくなります。そのため、_config.yml の baseurl フィールドにリポジトリ名を入力する必要があります。
*もし組織で使用していてリポジトリ設定でRead and Write permissionsを有効にできない場合は、組織の設定ページを参照してそこで有効にしてください。
初回実行
以下の設定情報を参照し、必ず
_zmediumtomarkdown.ymlファイルにあなたのMediumユーザー名を指定してください。⌛️ これ以上の変更を行う前に、
Automatic Buildとpages-build-deploymentのGitHub Actionsが完了するまでお待ちください。次に、GitHubリポジトリの
Actionsタブに移動し、ZMediumToMarkdownアクションを選択して、Run workflowボタンをクリックし、mainブランチを選択することで、手動でZMediumToMarkdownのGitHubアクションを実行できます。⌛️ 指定したユーザー名のすべてのMedium投稿をダウンロードして変換し、リポジトリにコミットするまでお待ちください。
⌛️
Automatic Buildとpages-build-deploymentのアクションが完了するまでお待ちください。これらは ZMediumToMarkdown アクションが完了すると自動的に開始されます。GitHubリポジトリの
Settingsセクションに移動し、Pagesを選択します。Branchフィールドでgh-pagesを選び、デフォルトのまま/(root)を選択したままにします。Saveをクリックしてください。ページの上部にGitHubページのURLも表示されます。⌛️ 「Pages build and deployment」アクションが完了するまでお待ちください。
🎉 すべてのアクションが完了したら、xxx.github.io ページにアクセスして結果を確認できます。おめでとうございます! 🎉
*予期されるGitの競合や予期しないエラーを避けるために、手順を注意深く順番に実行し、各操作が完了するまでしばらくお待ちください。
*初回の実行は時間がかかる場合があります。
*もしURLを開いてスタイルが崩れているなど問題がある場合は、_config.ymlファイルの設定が正しいか確認してください。
*詳細については、以下の「注意事項」と「トラブルシューティング」セクションを参照してください。
設定
サイト設定
_zmediumtomarkdown.yml
1
medium_username: # Medium.comのユーザー名を入力してください
自動ダウンロードと投稿の同期のために、あなたのMediumユーザー名を指定してください。
_config.yml & jekyll 設定
詳細については、jekyll-theme-chirpy または jekyllrb をご参照ください。
Github Action
ZMediumToMarkdown
同期の時間間隔は ./.github/workflows/ZMediumToMarkdown.yml で設定できます。
デフォルトの同期間隔は1日1回です。
GitHubリポジトリのActionsタブに移動し、ZMediumToMarkdownアクションを選択して、Run workflowボタンをクリックし、mainブランチを選択することで、ZMediumToMarkdownアクションを手動で実行することもできます。
免責事項
ZMediumToMarkdownを使用してダウンロードされたすべてのコンテンツ(記事、画像、動画を含むがこれらに限定されない)は著作権法の対象であり、それぞれの所有者に帰属します。ZMediumToMarkdownは、このツールを使用してダウンロードされたコンテンツの所有権を主張しません。
著作権者の許可なく著作権で保護されたコンテンツをダウンロードおよび使用することは違法であり、法的措置を受ける可能性があります。ZMediumToMarkdownは著作権侵害を容認または支持せず、本ツールの誤用に対して一切の責任を負いません。
ZMediumToMarkdownのユーザーは、本ツールを使用して取得したコンテンツをダウンロードおよび使用するために必要な権限と権利を自ら確認し、責任を負うものとします。ZMediumToMarkdownは、本ツールの誤用によって生じるいかなる法的問題についても責任を負いません。
ZMediumToMarkdownを使用することで、ユーザーはすべての適用される著作権法および規則を遵守することに同意したものとみなされます。
トラブルシューティング
私のGitHubページが404エラーを表示し続ける、または最新の投稿に更新されません。
上記の設定手順を順番に確実に実行してください。
すべてのGitHub Actionsが完了するまで待ちます。
Pages build and deploymentやAutomatic Buildのアクションも含まれます。進行状況はActionsタブで確認できます。Settings -> Pagesで正しい設定が選択されていることを確認してください。
知っておくべきこと
ZMediumToMarkdownGitHub Actionは、Mediumの投稿を同期するためにデフォルトで毎日自動実行されます。また、GitHub Actionsのページから手動で実行したり、必要に応じて同期頻度を調整することも可能です。すべてのコミットおよび投稿の変更は、
Automatic BuildとPages build and deploymentアクションをトリガーします。最終結果を確認する前に、このアクションが完了するまでお待ちください。_postsディレクトリ内に、ファイル名をYYYY-MM-DD-POSTNAMEの形式で付けて、独自のMarkdown投稿を作成できます。ファイル名は小文字を推奨します。画像やその他のリソースは
/assetsディレクトリに含めることができます。また、投稿の下部にあるZMediumToMarkdownのウォーターマークを削除したい場合は、自由に行ってください。私は気にしません。
tools/optimize_markdown.rbのRubyファイルを編集し、行10–12のコメントを解除できます。これにより、Jekyllのビルド時にすべての投稿の末尾からZMediumToMarkdownのウォーターマークが自動的に削除されます。ZMediumToMarkdownは公式ツールではなく、Mediumも公開APIを提供していないため、将来的にパーサーの対象が変更される可能性があることは保証できません。しかし、できる限り多くのケースでテストを行っています。もしレンダリングエラーやJekyllのビルドエラーが発生した場合は、お気軽にIssueを作成してください。できるだけ早く修正いたします。
ご質問やご意見がありましたら、お問い合わせ ください。
Post は ZMediumToMarkdown によってMediumから変換されました。
本記事は Medium にて初公開されました(こちらからオリジナル版を確認)。ZMediumToMarkdown による自動変換・同期技術を使用しています。
