10
ドキュメントをGithubPagesと同期するにはどうすればよいですか?
私は何人かの人々と一緒にプロジェクトを持っており、README.mdGitHubページにレンダリングされたGitHubフレーバーマークダウンの束を含むファイルがあります。また、GitHubOrganizationのサブドメインでホストされるGitHubPagesブランチを設定し、ページの作成時にファイルにロードするだけの自動ページジェネレーターを使用しましたREADME.md。ただし、README.mdファイルを更新してもプロジェクトページが更新されないことに気付きました。代わりに、[GitHub設定]タブに移動してプロジェクトページを再作成し、README.md実行時にファイルを再読み込みする必要があります。 また、GitHubプロジェクトディレクトリページのドキュメントファイル間で機能する相対リンクについて読んだ後。ドキュメントのためにすべてのHTMLを手作業で書き出す必要がないため、マークダウンが非常に気に入っています。ただしREADME.md、にある他のドキュメントファイルへの相対リンクを含めることができる1つのファイルを作成できるようにしたいと思いますdocs/*.md。他のドキュメントファイルもgh-pagesブランチに含まれ、GitHub Pagesサブドメインでホストされ、レンダリングやテーマが設定されるように、簡単な解決策があることを望んでいました。 言い換えれば、私の質問は次のとおりです。 Github PageサブドメインでREADME.mdファイルを自動的に更新する方法はありますか? [編集]:自動ページジェネレータを使用している場合、答えはないようです。リポジトリを更新するには、リポジトリの設定ページに移動し、変更があるたびにリポジトリを再読み込みする必要があります。 README.mdファイルのドキュメントへの相対リンクをGithubPagesで機能させる/docs/*.md方法はありますか?おそらく、Github Pagesに同期し、レンダリングやテーマ設定を行う方法はありますか? [編集]:この質問を書いてから学んだことから、これはRuby gem Jekyllのような静的サイトジェネレーターの使用と、おそらく言及されているGitHubでサポートされているWebhookのいくつかの使用を通じてGitHubページでのみ可能であるようです以下のコメントで。私は現在、最適な解決策を見つけようとしています。 さらに良いことに、これを行うためのさらに簡単な方法があり、おそらくgh-pagesとメインブランチの両方で使用され、すべてを簡単にするREADME.mdとドキュメントのコピーを1つだけ持っていますか? [編集]:これはほぼ間違いなくノーのようです。これを可能にするためにGitHubに何かが組み込まれている可能性について考えていました。この種のサポートは、将来GitHub Pagesに組み込まれる可能性があるようです。少なくとも、そうなることを願っています。