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
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!
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.iois the URL and
/my-repo-nameis the BASEURL.
- Open your
- Replace the
urlfield 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.,
If you have issues or questions, refer to the GitHub Pages Documentation.