概要

このエクステンションは、GitHub PagesにWebページをアップすると、レイアウトが崩れてしまう問題を解決するためのツールです。

image01

レイアウトが崩れる原因は2つあります。

  • GitHub Pagesはデフォルトで jekyll を使用してホスティングを行うため、jekyllでサポートしていないパスを正確に読み取ってくれない

  • CSSなどのパス指定がサーバとローカルで異なり、GitHub Pagesのサーバー上のURLを指定する必要がある

このエクステンションは、次のように解決します。

  • GithHub Pagesを公開するフォルダ直下に .nojekyll という空ファイルを置くことで、jekyllをホスティングしないようにします

  • HTMLに記述されているCSSファイルなどへの相対パスを、 <base> タグを使用してGitHub PagesのURLに変換します

エクステンションは次の機能を提供します。
詳細は、 使い方 / 各機能の詳細 をご確認ください。

  • タスク (Terminal> Run Task…)

    • github pages: Convert to HTML for GitHub Pages

    • github pages: Create a “.nojekyll” file in [./docs]

    • github pages: Create a “.nojekyll” file in [workspaceFolder(./)]

image02
image03