diff --git a/Gemfile.lock b/Gemfile.lock index a335cc9f..d5e35b00 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -4,6 +4,7 @@ GEM asciidoctor (2.0.17) PLATFORMS + universal-darwin-23 x86_64-linux DEPENDENCIES diff --git a/Makefile b/Makefile index a8b68c47..6fe95192 100644 --- a/Makefile +++ b/Makefile @@ -3,11 +3,11 @@ all: build .PHONY: build build: clean ## build the site - hugo -t docsy --minify + hugo -F --minify .PHONY: build-preview build-preview: clean ## build a preview, with future-dated content allowed. - hugo -t docsy -F --minify + hugo -F --minify .PHONY: clean clean: ## clean the build assets @@ -17,15 +17,17 @@ clean: ## clean the build assets install: ## install dependencies bundle npm install + hugo mod get + hugo mod graph + hugo mod get github.com/google/docsy .PHONY: netlify -netlify: submodule-init ## build the site for Netlify - git submodule update --init --recursive --depth 1 +netlify: $(MAKE) install $(MAKE) build .PHONY: netlify-preview -netlify-preview: submodule-init ## build a preview of the site for Netlify +netlify-preview: ## build a preview of the site for Netlify $(MAKE) install $(MAKE) build-preview @@ -35,8 +37,4 @@ serve: ## serve the content locally for testing .PHONY: serve-preview serve-preview: ## serve the preview content locally for testing - hugo -t docsy server -F - -.PHONY: submodule-init -submodule-init: - git submodule update --init --recursive --depth 1 + hugo -t docsy server -F \ No newline at end of file diff --git a/config.toml b/config.toml deleted file mode 100644 index 7dc41eba..00000000 --- a/config.toml +++ /dev/null @@ -1,189 +0,0 @@ -baseURL = "/" -title = "Shipwright" - -enableRobotsTXT = true - -# Hugo allows theme composition (and inheritance). The precedence is from left to right. -theme = ["docsy"] - -# Will give values to .Lastmod etc. -enableGitInfo = true - -# Language settings -contentDir = "content/en" -defaultContentLanguage = "en" -defaultContentLanguageInSubdir = false -# Useful when translating. -enableMissingTranslationPlaceholders = true - -disableKinds = ["term", "taxonomy"] - -# Highlighting config -pygmentsCodeFences = true -pygmentsUseClasses = false -# Use the new Chroma Go highlighter in Hugo. -pygmentsUseClassic = false -#pygmentsOptions = "linenos=table" -# See https://help.farbox.com/pygments.html -pygmentsStyle = "tango" - -# Configure how URLs look like per section. -[permalinks] -blog = "/:section/:year/:month/:day/:slug/" - -## Configuration for BlackFriday markdown parser: https://github.com/russross/blackfriday -[blackfriday] -plainIDAnchors = true -hrefTargetBlank = true -angledQuotes = false -latexDashes = true - -# Image processing configuration. -[imaging] -resampleFilter = "CatmullRom" -quality = 75 -anchor = "smart" - -[services] -[services.googleAnalytics] -# Comment out the next line to disable GA tracking. Also disables the feature described in [params.ui.feedback]. -# id = "UA-00000000-0" - -# Language configuration - -[languages] - [languages.en] - title = "Shipwright" - languageName ="English" - # Weight used for sorting. - weight = 1 - [languages.en.params] - description = "A framework for building container images on Kubernetes" - -[markup] - [markup.goldmark] - [markup.goldmark.renderer] - unsafe = true - [markup.highlight] - # See a complete list of available styles at https://xyproto.github.io/splash/docs/all.html - style = "tango" - # Uncomment if you want your chosen highlight style used for code blocks without a specified language - # guessSyntax = "true" - -# Everything below this are Site Params - -[params] -copyright = "The Shipwright Contributors" -# privacy_policy = "" - -# First one is picked as the Twitter card image if not set on page. -# images = ["images/project-illustration.png"] - -# Menu title if your navbar has a versions selector to access old versions of your site. -# This menu appears only if you have at least one [params.versions] set. -version_menu = "Releases" - -# Flag used in the "version-banner" partial to decide whether to display a -# banner on every page indicating that this is an archived version of the docs. -# Set this flag to "true" if you want to display the banner. -archived_version = false - -# The version number for the version of the docs represented in this doc set. -# Used in the "version-banner" partial to display a version number for the -# current doc set. -version = "0.0" - -# A link to latest version of the docs. Used in the "version-banner" partial to -# point people to the main doc site. -url_latest_version = "https://example.com" - -# Repository configuration (URLs for in-page links to opening issues and suggesting changes) -github_repo = "https://github.com/shipwright-io/website" -# An optional link to a related project repo. For example, the sibling repository where your product code lives. -github_project_repo = "https://github.com/shipwright-io/build" - -# Specify a value here if your content directory is not in your repo's root directory -# github_subdir = "" - -# Google Custom Search Engine ID. Remove or comment out to disable search. -# gcs_engine_id = "011737558837375720776:fsdu1nryfng" - -# Enable Algolia DocSearch -# algolia_docsearch = false - -# Enable Lunr.js offline search -# offlineSearch = false - -# User interface configuration -[params.ui] -# Enable to show the side bar menu in its compact state. -sidebar_menu_compact = false -# Set to true to disable breadcrumb navigation. -breadcrumb_disable = false -# Set to true to hide the sidebar search box (the top nav search box will still be displayed if search is enabled) -sidebar_search_disable = false -# Set to false if you don't want to display a logo (/assets/icons/logo.svg) in the top nav bar -navbar_logo = true -# Set to true to disable the About link in the site footer -footer_about_disable = false - -# Adds a H2 section titled "Feedback" to the bottom of each doc. The responses are sent to Google Analytics as events. -# This feature depends on [services.googleAnalytics] and will be disabled if "services.googleAnalytics.id" is not set. -# If you want this feature, but occasionally need to remove the "Feedback" section from a single page, -# add "hide_feedback: true" to the page's front matter. -[params.ui.feedback] -enable = true -# The responses that the user sees after clicking "yes" (the page was helpful) or "no" (the page was not helpful). -yes = 'Glad to hear it! Please tell us how we can improve.' -no = 'Sorry to hear that. Please tell us how we can improve.' - -# Adds a reading time to the top of each doc. -# If you want this feature, but occasionally need to remove the Reading time from a single page, -# add "hide_readingtime: true" to the page's front matter -[params.ui.readingtime] -enable = false - -[params.links] -# End user relevant links. These will show up on left side of footer and in the community page if you have one. -[[params.links.user]] - name = "User mailing list" - url = "https://lists.shipwright.io/admin/lists/shipwright-users.lists.shipwright.io/" - icon = "fa fa-envelope" - desc = "Discussion and help from your fellow users" -# [[params.links.user]] -# name ="Twitter" -# url = "https://example.org/twitter" -# icon = "fab fa-twitter" -# desc = "Follow us on Twitter to get the latest news!" -# [[params.links.user]] -# name = "Stack Overflow" -# url = "https://example.org/stack" -# icon = "fab fa-stack-overflow" -# desc = "Practical questions and curated answers" -# Developer relevant links. These will show up on right side of footer and in the community page if you have one. -[[params.links.developer]] - name = "GitHub" - url = "https://github.com/shipwright-io/build" - icon = "fab fa-github" - desc = "Contribute to Shipwright!" -[[params.links.developer]] - name = "Slack" - url = "https://kubernetes.slack.com/archives/C019ZRGUEJC" - icon = "fab fa-slack" - desc = "Chat with the Shipwright contributors" -[[params.links.developer]] - name = "Developer mailing list" - url = "https://lists.shipwright.io/admin/lists/shipwright-dev.lists.shipwright.io/" - icon = "fa fa-envelope" - desc = "Discuss development issues around the project" - -[security] - enableInlineShortcodes = false - [security.exec] - allow = ['^dart-sass-embedded$', '^go$', '^npx$', '^postcss$', '^asciidoctor$'] - osEnv = ['(?i)^(PATH|PATHEXT|APPDATA|TMP|TEMP|TERM)$'] - [security.funcs] - getenv = ['^HUGO_'] - [security.http] - methods = ['(?i)GET|POST'] - urls = ['.*'] diff --git a/go.mod b/go.mod new file mode 100644 index 00000000..d0464158 --- /dev/null +++ b/go.mod @@ -0,0 +1,5 @@ +module github.com/shipwright-io/website + +go 1.22.6 + +require github.com/google/docsy v0.10.0 // indirect diff --git a/go.sum b/go.sum new file mode 100644 index 00000000..78bc9349 --- /dev/null +++ b/go.sum @@ -0,0 +1,4 @@ +github.com/FortAwesome/Font-Awesome v0.0.0-20240402185447-c0f460dca7f7/go.mod h1:IUgezN/MFpCDIlFezw3L8j83oeiIuYoj28Miwr/KUYo= +github.com/google/docsy v0.10.0 h1:6tMDacPwAyRWNCfvsn/9qGOZDQ8b0aRzjRZvnZPY5dg= +github.com/google/docsy v0.10.0/go.mod h1:c0nIAqmRTOuJ01F85U/wJPQtc3Zj9N58Kea9bOT2AJc= +github.com/twbs/bootstrap v5.3.3+incompatible/go.mod h1:fZTSrkpSf0/HkL0IIJzvVspTt1r9zuf7XlZau8kpcY0= diff --git a/hugo.yaml b/hugo.yaml new file mode 100644 index 00000000..8541449c --- /dev/null +++ b/hugo.yaml @@ -0,0 +1,205 @@ +baseURL: "https://shipwright.io" +title: "Shipwright" + +# Language settings +contentDir: content/en +defaultContentLanguage: en +defaultContentLanguageInSubdir: false +# Useful when translating. +enableMissingTranslationPlaceholders: true + +enableRobotsTXT: true + +# Will give values to .Lastmod etc. +enableGitInfo: true + +# Comment out to enable taxonomies in Docsy +# disableKinds: [taxonomy, taxonomyTerm] + +# You can add your own taxonomies +taxonomies: + tag: tags + category: categories + +# Highlighting config +pygmentsCodeFences: true +pygmentsUseClasses: false +# Use the new Chroma Go highlighter in Hugo. +pygmentsUseClassic: false +# pygmentsOptions: "linenos=table" +# See https://help.farbox.com/pygments.html +pygmentsStyle: tango + +# Configure how URLs look like per section. +permalinks: + blog: /:section/:year/:month/:day/:slug/ + +# Image processing configuration. +imaging: + resampleFilter: CatmullRom + quality: 75 + anchor: smart + +# Language configuration +languages: + en: + languageName: English + title: Shipwright + params: + description: A framework for building container images on Kubernetes + +markup: + goldmark: + parser: + attribute: + block: true + renderer: + unsafe: true + highlight: + # See a complete list of available styles at https://xyproto.github.io/splash/docs/all.html + style: tango + # Uncomment if you want your chosen highlight style used for code blocks without a specified language + # guessSyntax: true + +# Comment out if you don't want the "print entire section" link enabled. +outputs: + section: [HTML, print, RSS] + +params: + contributingUrl: https://github.com/shipwright-io/.github/blob/main/CONTRIBUTING.md + footer_cncf_note: "We are a Cloud Native Computing Foundation sandbox project." + footer_note: "Kubernetes and the Kubernetes logo are registered trademarks of The Linux Foundation® (TLF)." + footer_cncf_show: true + taxonomy: + # set taxonomyCloud = [] to hide taxonomy clouds + taxonomyCloud: [tags, categories] + + # If used, must have same length as taxonomyCloud + taxonomyCloudTitle: [Tag Cloud, Categories] + + # set taxonomyPageHeader = [] to hide taxonomies on the page headers + taxonomyPageHeader: [tags, categories] + + # First one is picked as the Twitter card image if not set on page. + # images: [images/project-illustration.png] + + # Menu title if your navbar has a versions selector to access old versions of your site. + # This menu appears only if you have at least one [params.versions] set. + version_menu: Releases + + + copyright: 2024 The Shipwright Contributors + + # Flag used in the "version-banner" partial to decide whether to display a + # banner on every page indicating that this is an archived version of the docs. + # Set this flag to "true" if you want to display the banner. + archived_version: false + + # The version number for the version of the docs represented in this doc set. + # Used in the "version-banner" partial to display a version number for the + # current doc set. + version: v0.13.0 + + # A link to latest version of the docs. Used in the "version-banner" partial to + # point people to the main doc site. + url_latest_version: https://example.com + + # Repository configuration (URLs for in-page links to opening issues and suggesting changes) + github_repo: https://github.com/shipwright-io/website + + # An optional link to a related project repo. For example, the sibling repository where your product code lives. + github_project_repo: https://github.com/shipwright-io/build + + # Uncomment this if your GitHub repo does not have "main" as the default branch, + # or specify a new value if you want to reference another branch in your GitHub links + github_branch: main + + # User interface configuration + ui: + # Set to true to disable breadcrumb navigation. + breadcrumb_disable: false + # Set to false if you don't want to display a logo (/assets/icons/logo.svg) in the top navbar + navbar_logo: true + # Set to true if you don't want the top navbar to be translucent when over a `block/cover`, like on the homepage. + navbar_translucent_over_cover_disable: true + # Enable to show the side bar menu in its compact state. + sidebar_menu_compact: false + # Set to true to hide the sidebar search box (the top nav search box will still be displayed if search is enabled) + sidebar_search_disable: false + # Adds a H2 section titled "Feedback" to the bottom of each doc. The responses are sent to Google Analytics as events. + # This feature depends on [services.googleAnalytics] and will be disabled if "services.googleAnalytics.id" is not set. + # If you want this feature, but occasionally need to remove the "Feedback" section from a single page, + # add "hide_feedback: true" to the page's front matter. + feedback: + enable: true + # The responses that the user sees after clicking "yes" (the page was helpful) or "no" (the page was not helpful). + 'yes': >- + Glad to hear it! Please tell us how we can improve. + 'no': >- + Sorry to hear that. Please tell us how we can improve. + # Adds a reading time to the top of each doc. + # If you want this feature, but occasionally need to remove the Reading time from a single page, + # add "hide_readingtime: true" to the page's front matter + readingtime: + enable: false + showLightDarkModeMenu: false + + links: + user: + - name: User mailing list + url: https://lists.shipwright.io/admin/lists/shipwright-users.lists.shipwright.io/ + icon: fa fa-envelope + desc: Discussion and help from your fellow users + developer: + - name: GitHub + url: https://github.com/shipwright-io/build + icon: fab fa-github + desc: Contribute to Shipwright! + - name: Slack + url: https://kubernetes.slack.com/archives/C019ZRGUEJC + icon: fab fa-slack + desc: Chat with the Shipwright contributors + - name: Developer mailing list + url: https://lists.shipwright.io/admin/lists/shipwright-dev.lists.shipwright.io/ + icon: fa fa-envelope + desc: Discuss development issues around the project + + + # End user relevant links. These will show up on left side of footer and in the community page if you have one. + footer: + community: + links: + - name: Kubernetes Slack + url: https://kubernetes.slack.com/archives/C019ZRGUEJC + - name: User Mailing List + url: https://lists.shipwright.io/admin/lists/shipwright-users.lists.shipwright.io/ + developer: + links: + - name: How to Contribute + url: https://github.com/shipwright-io/.github/blob/main/CONTRIBUTING.md + - name: Developer Mailing List + url: https://lists.shipwright.io/admin/lists/shipwright-dev.lists.shipwright.io/ + - name: Website Source + url: https://github.com/shipwright-io/website/ + help: + links: + - name: Documentation + url: https://shipwright.io/docs/ + - name: Report a Vulnerability + url: https://github.com/shipwright-io/.github/blob/main/SECURITY.md + policies: + links: + - name: Code of Conduct + url: https://github.com/shipwright-io/.github/blob/main/CODE_OF_CONDUCT.md + - name: Trademark Usage + url: https://www.linuxfoundation.org/legal/trademark-usage + +module: + # uncomment line below for temporary local development of module + # replacements = "github.com/google/docsy -> ../../docsy" + hugoVersion: + extended: true + min: 0.110.0 + imports: + - path: github.com/google/docsy + disable: false \ No newline at end of file diff --git a/netlify.toml b/netlify.toml index 3ce90597..1bf26d5d 100644 --- a/netlify.toml +++ b/netlify.toml @@ -3,7 +3,7 @@ publish="public/" command="make netlify" [build.environment] -HUGO_VERSION="0.99.1" +HUGO_VERSION="0.113.0" [context.deploy-preview] command="make netlify-preview" diff --git a/themes/docsy b/themes/docsy deleted file mode 160000 index ef3398f5..00000000 --- a/themes/docsy +++ /dev/null @@ -1 +0,0 @@ -Subproject commit ef3398f5e55789ec09b0cbc0285ed476a8f3d6e0