ZMediumToJekyll
Mediumの投稿をJekyllブログに移行し、今後も同期を維持しましょう。
このツールは、Mediumの投稿をJekyllブログに移行し、今後も同期を保つのに役立ちます。
Mediumから投稿を自動でダウンロードし、Markdownに変換してリポジトリにアップロードします。オンラインデモは私のブログやzhgchg.liをご覧ください。
一度の設定で、一生楽しめる❤️
Powered by ZMediumToMarkdown .
もしMediumの投稿のバックアップや自動同期だけを行いたい場合は、このWikiの手順に従って、GitHub Actionを直接使用できます。
セットアップ
- 以下のビデオチュートリアルを見ながら、各ステップを一緒に進めることができます。
- Click the green button
Use this templatelocated above and selectCreate a new repository. - Repo Owner could be an organization or username
- Enter the Repository Name, which usually uses your GitHub Username/Organization Name and ends with
.github.io, for example, my organization name iszhgchglithan it’ll bezhgchgli.github.io. - Select the
publicrepository option, and then click onCreate repository from template. - Grant access to GitHub Actions by going to the
Settingstab in your GitHub repository, selectingActions->General, and finding theWorkflow permissions section, then, selectRead and write permissions, and click onSaveto save the changes.
*もし異なるリポジトリ名を選択した場合、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
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で正しい設定が選択されていることを確認してください。
知っておくべきこと
-
Medium投稿を同期するための
ZMediumToMarkdownGitHub Action は、デフォルトで毎日自動的に実行されます。また、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から変換されました。
コメント