Publishing Static Site On github pages
Easiest way to get started with
fastn is using the github pages to host your built assets.⚠️
You Lose Many Dynamic Features In Static Modes
FASTN comes with a lot of dynamic features, which are only available when you are using fastn server for hosting.
The main feature you will miss when using fastn as static site generator is authentication, you can not create private fastn sites, or fastn sites with mixed mode, some pages public and some accessible to only few people.
Using the template repositoryYou can use our template repository fastn-blog to create your own repo.
Using the template repository
You can use our template repository fastn-blog to create your own repo.
Step 1: Creating your own repoOpen the fastn-blog repository in your browser and click on the Use this template button
Open the fastn-blog repository in your browser and click on the
Use this template button
Step I: Use the template repository to initialize your repository
Step 2: Updating the configs in repositoryIn order to use the package properly, you’ll need to make the following changes in your codebase.
In order to use the package properly, you’ll need to make the following changes in your codebase.
FASTN.ftd
-- import: fastn -- fastn.package: <username_or_orgname>.github.io/<repo_name> zip: github.com/<username_or_orgname>/<repo_name>/archive/refs/heads/main.zip -- fastn.dependency: fifthtry.github.io/blog-theme
Step 3: Activate the Github Pages environment on your repoIn your repository, go to Settings > Pages to access the Github Pages admin section. Choose the build branch in the dropdown and in the directory dropdown, choose /(root) and click on Save.
Github Pages environment on your repoIn your repository, go to
Settings > Pages to access the Github Pages admin section. Choose the build branch in the dropdown and in the directory dropdown, choose /(root) and click on Save.
