2.5 KiB
+++ title = "Serving" +++
Serving locally
While you're creating content for your library, you'll probably want to see what the finished product looks like. Fortunately, Infusion is easy to serve locally using the serve command:
{{}}npm run serve{{}}
This will serve your working library from localhost:1313 (the exact URL will be determined by what's in your baseURL and will be revealed to you by your terminal). Whenever you make changes to your library's files, the site will automatically rebuild. No need to refresh the web page!
Publishing on Github Pages
There are three steps to hosting your library on Github Pages.
1. Edit the baseURL
Open up config.toml (at the root of your library project folder) and make sure baseURL matches your Github Pages URL.
baseURL = "[your user name].github.io/[your library repo name]"
If you are having trouble working out your Github Pages URL, this tool may help.
2. Commit your latest changes
On the (default) master branch run:
{{}}git commit -am "my commit message"{{}}
3. Run the host command
{{}}npm run host{{}}
You should now be able to find a "live" version of your library at [your user name].github.io/[your library repo name].
+++ title = "Serving" +++
Serving locally
While you're creating content for your library, you'll probably want to see what the finished product looks like. Fortunately, Infusion is easy to serve locally using the serve command:
{{}}npm run serve{{}}
This will serve your working library from localhost:1313 (the exact URL will be determined by what's in your baseURL and will be revealed to you by your terminal). Whenever you make changes to your library's files, the site will automatically rebuild. No need to refresh the web page!
Publishing on Github Pages
Infusion creates a /docs folder containing the latest version of your library whenever you run npm run build or do a git commit. This folder can be made the source for your Github Pages site by selecting it under Settings → Github Pages → Source in the web interface.
Then, whenever you push to master, you will also be updating the site found at your Github Pages URL, in the format [your user name].github.io/[your library repo name]. See {{% pattern "Library setup" %}} for adding this URL to your config.toml file. If you are having trouble working out your Github Pages URL, this tool may help.