Skip to content

Commit a4c2af1

Browse files
committed
docs: remove dev containers info and unused links
1 parent bfd84b9 commit a4c2af1

File tree

1 file changed

+4
-67
lines changed

1 file changed

+4
-67
lines changed

README.md

Lines changed: 4 additions & 67 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ Out of the box, this template provides a minimal WordPress theme with basic supp
3737

3838
## Quickstart
3939

40-
This project requires [Docker][docker] and [Node.js][node] for local development. For a better editing experience for PHP and Twig files, it's useful to have [PHP installed][php-install] on your system as well. If you are on Windows and use VS Code, you may find it helpful to [run VS Code in a container][vs-code-container] so that you can more easily work with PHP (see more details in the [Local Development Setup section](#running-vs-code-in-a-container)).
40+
This project requires [Docker][docker] and [Node.js][node] for local development. For a better editing experience for PHP and Twig files, it's useful to have [PHP installed][php-install] on your system as well, but it isn't required.
4141

4242
To run the project for the first time, do the following:
4343

@@ -204,11 +204,11 @@ If you use [VS Code][vs-code], you can create a `settings.json` file inside a `.
204204

205205
We recommend these extensions to make working with PHP and Twig easier.
206206

207-
- [PHP Sniffer & Beautifier][phpsab-vscode]
207+
- [PHP Sniffer & Beautifier][phpsab-vscode] (may not work on Windows)
208208
- [Twig][twig-vscode]
209-
- [twigcs][twigcs-vscode]
209+
- [twigcs][twigcs-vscode] (may not work on Windows)
210210

211-
Note: you will need to have vendor files available on your host machine (not the container they're installed in) for the linters to highlight code while you're working. You can run `npm run map-vendor-files` to make them available at the paths specified in the example `settings.json` below, and as long as you have PHP installed on your system, they _should_ work. Windows has limited support for PHP, though, so you may want to run VS Code in a container so that PHP will be more easily available (or you can choose to live without real-time error highlighting).
211+
Note: you will need to have vendor files available on your host machine (not the container they're installed in) for the linters to highlight code while you're working. You can run `npm run map-vendor-files` to make them available at the paths specified in the example `settings.json` below, and as long as you have PHP installed on your system, they _should_ work. Windows has limited support for PHP, though, so you may not be able to get real-time error highlighting on PHP/Twig files.
212212

213213
```json
214214
{
@@ -225,62 +225,6 @@ Note: you will need to have vendor files available on your host machine (not the
225225
}
226226
```
227227

228-
##### Running VS Code in a Container
229-
230-
The [Dev Containers extension][dev-containers-vscode] allows you to run VS Code inside a container, giving you access to a consistent environment that you can configure to include the dependencies you need. For this project, we recommend an Ubuntu container with the same PHP version as in the [Dockerfile](./Dockerfile), the LTS version of Node.js, and Docker (docker-in-docker).
231-
232-
After installing the Dev Containers extension, you can manually create the container through the extension's UI, or you can add a configuration file at `.devcontainer/devcontainer.json`, like so:
233-
234-
```json
235-
// For format details, see https://aka.ms/devcontainer.json. For config options, see the
236-
// README at: https://github.com/devcontainers/templates/tree/main/src/ubuntu
237-
{
238-
"name": "Ubuntu",
239-
// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
240-
"image": "mcr.microsoft.com/devcontainers/base:jammy",
241-
"features": {
242-
"ghcr.io/devcontainers/features/node:1": {
243-
"nodeGypDependencies": true,
244-
"version": "lts",
245-
"nvmVersion": "latest"
246-
},
247-
"ghcr.io/shyim/devcontainers-features/php:0": {
248-
"installComposer": true,
249-
"version": "8.1"
250-
},
251-
"ghcr.io/devcontainers/features/docker-in-docker:2": {
252-
"moby": true,
253-
"azureDnsAutoDetection": true,
254-
"installDockerBuildx": true,
255-
"version": "latest",
256-
"dockerDashComposeVersion": "v2"
257-
}
258-
},
259-
"customizations": {
260-
"vscode": {
261-
"extensions": ["ValeryanM.vscode-phpsab", "whatwedo.twig", "cerzat43.twigcs"]
262-
}
263-
}
264-
265-
// Features to add to the dev container. More info: https://containers.dev/features.
266-
// "features": {},
267-
268-
// Use 'forwardPorts' to make a list of ports inside the container available locally.
269-
// "forwardPorts": [],
270-
271-
// Use 'postCreateCommand' to run commands after the container is created.
272-
// "postCreateCommand": "uname -a",
273-
274-
// Configure tool-specific properties.
275-
// "customizations": {},
276-
277-
// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
278-
// "remoteUser": "root"
279-
}
280-
```
281-
282-
Note: after restarting in the containerized VS Code, you will need to run `npm ci` and `docker compose build` again. You may also need to delete the `theme` and `plugins` folders so that the build process can recreate them with the right file permissions for the container.
283-
284228
## WordPress
285229

286230
### Upgrading WordPress
@@ -737,12 +681,8 @@ Deployment to Pantheon requires setting the following variables and secrets in G
737681
<!-- Links: -->
738682

739683
[advanced-custom-fields]: https://www.advancedcustomfields.com/
740-
[babel]: https://babeljs.io
741-
[bem]: http://getbem.com
742684
[bemit]: https://csswizardry.com/2015/08/bemit-taking-the-bem-naming-convention-a-step-further/
743-
[composer]: https://getcomposer.org/download/
744685
[contact-form-7]: https://contactform7.com/
745-
[dev-containers-vscode]: https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers
746686
[docker]: https://www.docker.com
747687
[gh-personal-access-token]: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-personal-access-token-classic
748688
[gh-secrets]: https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions#creating-secrets-for-a-repository
@@ -757,14 +697,11 @@ Deployment to Pantheon requires setting the following variables and secrets in G
757697
[phpsab-vscode]: https://marketplace.visualstudio.com/items?itemName=ValeryanM.vscode-phpsab
758698
[rollbar]: https://docs.rollbar.com/docs/wordpress
759699
[sass]: https://sass-lang.com/
760-
[sb-eslint]: https://github.com/sparkbox/eslint-config-sparkbox
761-
[sb-stylelint]: https://github.com/sparkbox/stylelint-config-sparkbox
762700
[string-extension]: https://github.com/twigphp/string-extra
763701
[timber]: https://timber.github.io/docs/
764702
[twig-vscode]: https://marketplace.visualstudio.com/items?itemName=whatwedo.twig
765703
[twig]: https://twig.symfony.com/
766704
[twigcs-vscode]: https://marketplace.visualstudio.com/items?itemName=cerzat43.twigcs
767-
[vs-code-container]: https://code.visualstudio.com/docs/devcontainers/tutorial
768705
[vs-code]: https://code.visualstudio.com/
769706
[widgets]: https://developer.wordpress.org/themes/functionality/sidebars/
770707
[wpcs]: https://github.com/WordPress/WordPress-Coding-Standards

0 commit comments

Comments
 (0)