-
Notifications
You must be signed in to change notification settings - Fork 983
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Website Common Configuration #524
Conversation
Apologies for the force push, had somehow not started this branch from |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
is website action in makefile duplicated?
### Marketing and Docs Website | ||
The Karpenter marketing and docs site uses [Hugo](https://gohugo.io/) and [npm](https://www.npmjs.com/) to generate HTML markup from Markdown content and configuration files in `/website`. Hugo makes use of [`git submodules`](https://git-scm.com/book/en/v2/Git-Tools-Submodules) to bring in theme assets and configruation. The Karpenter website uses the [Docsy theme](https://www.docsy.dev/). To serve this website locally, ensure you have `hugo` and `npm` installed, have initialized and updated your local repository's submodules with `git submodule update --init --recursive`, and then use the follow commands to bring up a local webserver: | ||
```bash | ||
cd website |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
FYI you can do make website
@@ -79,7 +79,7 @@ helm: ## Generate Helm Chart | |||
cd charts;helm lint karpenter;helm package karpenter;helm repo index . | |||
|
|||
website: ## Generate Docs Website | |||
cd website;npm install;hugo -d ../docs | |||
cd website; npm install; git submodule update --init --recursive; hugo |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
that is in the hugo config file now
Issue, if available:
N/A
Description of changes:
This PR adds common configuration from the Docsy Example site that we'll be leveraging to build the Karpenter docs/landing page.
It combines changes and resolves conflicts from akestner/karpenter:website-landing and geoffcline/karpenter:preview-web so that each of these efforts (building the marketing landing page and technical documentation) can be completed independently and result in PRs that are primarily changes in content, not website config or scaffolding.
Once this is merged, @akestner and @geoffcline should rebase the existing branches, mentioned above, off of the new
HEAD
of awslabs/karpenter:main to ensure the changes are incorporated and their branches' history is correct.By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.