diff --git a/.vscode/cspell.json b/.vscode/cspell.json index 7c606e5e3d..1077454c11 100644 --- a/.vscode/cspell.json +++ b/.vscode/cspell.json @@ -11,6 +11,7 @@ "words": [ "afdocs", "anchorize", + "autoloader", "basenames", "baseof", "chalin", @@ -39,11 +40,13 @@ "htmltest", "hugo", "isset", + "katex", "lastmod", "llms", "lockfiles", "magick", "markdownify", + "markmap", "mentees", "navbars", "nguyen", diff --git a/Dockerfile b/Dockerfile deleted file mode 100644 index f5100785b3..0000000000 --- a/Dockerfile +++ /dev/null @@ -1,10 +0,0 @@ -FROM klakegg/hugo:0.111.3-ext-alpine as docsy-user-guide - -RUN apk update -RUN apk add git -COPY package.json /app/docsy/docsy.dev/ -WORKDIR /app/docsy/docsy.dev/ -RUN npm install --production=false -RUN git config --global --add safe.directory /app/docsy - -CMD ["serve", "--cleanDestinationDir", "--themesDir", "../..", "--baseURL", "http://localhost:1313/", "--buildDrafts", "--buildFuture", "--disableFastRender", "--ignoreCache", "--watch"] diff --git a/docker-compose.yaml b/docker-compose.yaml deleted file mode 100644 index 53f977d22a..0000000000 --- a/docker-compose.yaml +++ /dev/null @@ -1,14 +0,0 @@ -version: "3.3" - -services: - - site: - image: docsy/docsy.dev - build: - context: . - ports: - - "1313:1313" - user: "${DOCSY_USER}" - volumes: - - /app/docsy/docsy.dev/node_modules - - .:/app/docsy diff --git a/docsy.dev/.lycheecache b/docsy.dev/.lycheecache index bb50503f00..2ed9b625cb 100644 --- a/docsy.dev/.lycheecache +++ b/docsy.dev/.lycheecache @@ -539,6 +539,7 @@ https://github.com/google/docsy/pull/2722,200,1787153684 https://github.com/google/docsy/pull/2724,200,1787076569 https://github.com/google/docsy/pull/2726,200,1787137876 https://github.com/google/docsy/pull/2731,200,1787331617 +https://github.com/google/docsy/pull/2748,200,1787848215 https://github.com/google/docsy/pull/941,200,1782498225 https://github.com/google/docsy/pulls,200,1782563369 https://github.com/google/docsy/releases,200,1782563368 diff --git a/docsy.dev/content/en/docs/contributing.md b/docsy.dev/content/en/docs/contributing.md index ddc3c28087..a7e38e33c6 100644 --- a/docsy.dev/content/en/docs/contributing.md +++ b/docsy.dev/content/en/docs/contributing.md @@ -131,49 +131,6 @@ work: 1. Continue with the usual GitHub workflow to edit files, commit them, push the changes up to your fork, and create a pull request. -#### Preview your changes using a Docker container - -Docsy comes with `Dockerfile` and `docker-compose` files to run the server -locally with Docker, without installing any additional dependencies. - -- Using [Docker]: - 1. Build the Docker container: - - ```bash - docker build -t docsy/user-guide . - ``` - - 1. Run the container, mounting the repository as a shared volume: - - ```bash - docker run -it --user=$(id -u):$(id -g) -p 1313:1313 \ - -v $(pwd):/app/docsy -v /app/docsy/docsy.dev/node_modules \ - docsy/user-guide - ``` - -- Using [Docker Compose][docker-compose]: - 1. Build the container: - - ```bash - docker-compose build - ``` - - 1. Run the container: - - ```bash - DOCSY_USER=$(id -u):$(id -g) docker-compose up - ``` - -Open in your web browser to load the docsy user guide. -In most cases, docsy will automatically reload the site to reflect any changes -to the documentation or the code. Changes to some parts of the docsy code may -require manually reloading the page or re-starting the container. - -Press **Ctrl + C** to stop the container. - -[docker]: https://docs.docker.com/get-docker/ -[docker-compose]: https://docs.docker.com/compose/install/ - ### User guide formatting We use [Prettier](https://prettier.io) to format the markdown source of the User diff --git a/docsy.dev/content/en/docs/get-started/_index.md b/docsy.dev/content/en/docs/get-started/_index.md index 85536d25b0..495144a6b5 100644 --- a/docsy.dev/content/en/docs/get-started/_index.md +++ b/docsy.dev/content/en/docs/get-started/_index.md @@ -4,7 +4,7 @@ description: >- Learn how to get started with Docsy, including the available options for installing and using the Docsy theme. date: 2018-07-30 -aliases: [getting-started] +aliases: [getting-started, get-started/quickstart-docker] weight: 2 --- @@ -16,8 +16,7 @@ our example site, though we also provide instructions for adding the Docsy theme manually to new or existing sites. If you want to build and test your site locally you also need to be able to run -Hugo itself, either by installing it and any other required dependencies, or by -using our provided Docker container. +Hugo itself, by installing it and any other required dependencies. This page describes Docsy's installation options and helps you choose the appropriate setup guide to get started. diff --git a/docsy.dev/content/en/docs/get-started/quickstart-docker.md b/docsy.dev/content/en/docs/get-started/quickstart-docker.md deleted file mode 100644 index 992848a0c7..0000000000 --- a/docsy.dev/content/en/docs/get-started/quickstart-docker.md +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: Deploy Docsy inside a Docker container -weight: 3 -date: 2018-07-30 -description: > - Instructions on how to set up and run a local Docsy site with Docker. ---- - -We provide a Docker image that you can use to run and test your Docsy site -locally, without having to install all Docsy's dependencies. - -## Install the prerequisites - -1. On Mac and Windows, download and install - [Docker Desktop](https://www.docker.com/get-started). On Linux, install - [Docker engine](https://docs.docker.com/engine/install/) and - [Docker compose](https://docs.docker.com/compose/install/). - - The installation may require you to reboot your computer for the changes to - take effect. - -1. [Install git](https://github.com/git-guides/install-git). - -## Create your repository from the docsy-example template - -The docsy-example repository provides a basic site structure that you can use as -a starting point to create your own documentation. - -1. Use the [docsy-example template](https://github.com/google/docsy-example) to - [create your own repository](https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template). - -1. Download the code to your local machine by - [cloning your newly created repository](https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/cloning-a-repository). - -1. Change your working directory to the newly created folder: - - ```bash - cd docsy-example - ``` - -## Build and run the container - -The docsy-example repository includes a -[Dockerfile](https://docs.docker.com/engine/reference/builder/) that you can use -to run your site. - -1. Build the docker image: - - ```bash - docker-compose build - ``` - -1. Run the built image: - - ```bash - docker-compose up - ``` - -1. Open the address `http://localhost:1313` in your web browser to load the - docsy-example homepage. You can now make changes to the source files, those - changes will be live-reloaded in your browser. - -## Cleanup - -To clean up your system and delete the container image, follow the next steps. - -1. Stop Docker Compose with **Ctrl + C**. - -1. Remove the produced images - - ```bash - docker-compose rm - ``` - -## What's next? - -- Learn about - [basic setup and configurations for Docsy](/docs/get-started/basic-configuration/). -- [Add content and customize your site](/docs/content/) -- [Publish your site](/docs/deployment/). diff --git a/docsy.dev/content/en/project/about/changelog.md b/docsy.dev/content/en/project/about/changelog.md index df59c4e2fe..34dad9b0e8 100644 --- a/docsy.dev/content/en/project/about/changelog.md +++ b/docsy.dev/content/en/project/about/changelog.md @@ -3,7 +3,7 @@ title: Changelog description: Docsy repository changelog aliases: [../changelog] # prettier-ignore -cSpell:ignore: deining FOUC gitmodules gtag katex lookandfeel mhchem navs notoc tabpane onedark shurup +cSpell:ignore: deining FOUC gitmodules gtag lookandfeel mhchem navs notoc tabpane onedark shurup --- We document **breaking changes** and release **highlights** in this page, with @@ -179,6 +179,8 @@ full list of changes, see the [0.17.0][] release page or the [git history since ([#2614][]). - Silenced Sass deprecation warnings in site builds, project style files included; see the [release report][0.17.0-blog-dart-sass] ([#2731][]). +- Dropped broken `Dockerfile` and `docker-compose.yaml` files and retired Docker + quickstart page ([#2748][]). **For maintainers**: @@ -214,6 +216,7 @@ full list of changes, see the [0.17.0][] release page or the [git history since [#2724]: https://github.com/google/docsy/pull/2724 [#2726]: https://github.com/google/docsy/pull/2726 [#2731]: https://github.com/google/docsy/pull/2731 +[#2748]: https://github.com/google/docsy/pull/2748 [0.17.0 release report]: /blog/2026/0.17.0/ [0.17.0-blog-dart-sass]: /blog/2026/0.17.0/#dart-sass [0.17.0-blog-install]: /blog/2026/0.17.0/#install-command diff --git a/docsy.dev/tests/md-output/goldens/docs/get-started/index.md b/docsy.dev/tests/md-output/goldens/docs/get-started/index.md index f833911bb1..5c3eda99c5 100644 --- a/docsy.dev/tests/md-output/goldens/docs/get-started/index.md +++ b/docsy.dev/tests/md-output/goldens/docs/get-started/index.md @@ -16,8 +16,7 @@ our example site, though we also provide instructions for adding the Docsy theme manually to new or existing sites. If you want to build and test your site locally you also need to be able to run -Hugo itself, either by installing it and any other required dependencies, or by -using our provided Docker container. +Hugo itself, by installing it and any other required dependencies. This page describes Docsy's installation options and helps you choose the appropriate setup guide to get started. @@ -71,6 +70,5 @@ Section pages: - [Use Docsy as a Hugo Module](/docs/get-started/docsy-as-module/): Learn how to get started with Docsy by using the theme as a Hugo Module. - [Other setup options](/docs/get-started/other-options/): Install Docsy as a Git submodule, a clone, or the @docsy/theme npm package, for sites not using Hugo modules. -- [Deploy Docsy inside a Docker container](/docs/get-started/quickstart-docker/): Instructions on how to set up and run a local Docsy site with Docker. - [Basic site configuration](/docs/get-started/basic-configuration/): Basic configuration for new Docsy sites. - [Troubleshooting and known issues](/docs/get-started/troubleshooting/): Troubleshooting and known issues when installing and using Docsy.