Serving your site
Serving locally for development
If you’re running Wax directly on your machine, serving *should* be as simple as
bundle exec jekyll serve
If you’re in a Docker container, you’ll need to specify the host:
bundle exec jekyll serve --host 0.0.0.0
Hosting / publishing online
There are many options. Our demo uses GitHub pages. You can also use FTP deployment to a server or sync files to an S3 or Min.io bucket.
Have you used these options and would like to share a “recipe” for our Wiki? Please ping us on the Code4Lib Slack!
With GitHub Pages
If you have a wax site repository that you want to publish to GitHub pages:
- Go to your repository page on Github.
- Go to “Settings” > “Pages”.
- Under “Source”, select the “main” branch and “root” folder and click “Save”.
- The page should now say something like “Your site is published at https://my-username.github.io/my-repo-name”. In this example,
https://my-username.github.io
is the URL and/my-repo-name
is the BASEURL. - Open your
_config.yml
file. - Replace the
url
field with your own url, e.g.,https://my-username.github.io
. This should NOT have a slash at the end. - Replace the baseurl with your own baseurl, which will be the same as your repository name, e.g.,
/my-repo-name
. This MUST start with a slash. - Add, commit, and push your changes.
- After waiting and refreshing as needed, your site should be published at your complete URL, e.g.,
https://my-username.github.io/my-repo-name
.
If you have issues or questions, refer to the GitHub Pages Documentation.