pages/*, style-guide: update contents, fix Markdown (#10492)

* pages/*, style-guide: update pages, fix Markdown (commit 1)

* Update pages

* style-guide.de: update page

* Apply suggestions from code review

Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com>

* pip3: remove search command

* rpm: update path placeholder

Co-authored-by: pixel <pixel+github@chrissx.de>

* Update pages/linux/pkgfile.md

Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com>

---------

Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com>
Co-authored-by: pixel <pixel+github@chrissx.de>

pages/common/apm.md

@@ -6,12 +6,12 @@
 
 - Install a package from http://atom.io/packages or a theme from http://atom.io/themes:
 
-`apm install {{package_name}}`
+`apm install {{package}}`
 
 - Remove a package/theme:
 
-`apm remove {{package_name}}`
+`apm remove {{package}}`
 
 - Upgrade a package/theme:
 
-`apm upgrade {{package_name}}`
+`apm upgrade {{package}}`

pages/common/cabal.md

@@ -10,11 +10,11 @@
 
 - Show information about a package:
 
-`cabal info {{package_name}}`
+`cabal info {{package}}`
 
 - Download and install a package:
 
-`cabal install {{package_name}}`
+`cabal install {{package}}`
 
 - Create a new Haskell project in the current directory:
 

pages/common/composer.md

@@ -9,7 +9,7 @@
 
 - Add a package as a dependency for this project, adding it to `composer.json`:
 
-`composer require {{user/package_name}}`
+`composer require {{user/package}}`
 
 - Install all the dependencies in this project's `composer.json` and create `composer.lock`:
 
@@ -17,7 +17,7 @@
 
 - Uninstall a package from this project, removing it as a dependency from `composer.json`:
 
-`composer remove {{user/package_name}}`
+`composer remove {{user/package}}`
 
 - Update all the dependencies in this project's `composer.json` and note versions in `composer.lock` file:
 
@@ -29,7 +29,7 @@
 
 - Learn more about why a dependency can't be installed:
 
-`composer why-not {{user/package_name}}`
+`composer why-not {{user/package}}`
 
 - Update composer to its latest version:
 

pages/common/conda-create.md

@@ -13,4 +13,4 @@
 
 - Create a new environment with a specified name and install a given package:
 
-`conda create --name {{env_name}} {{package_name}}`
+`conda create --name {{env_name}} {{package}}`

pages/common/cordova.md

@@ -5,7 +5,7 @@
 
 - Create a Cordova project:
 
-`cordova create {{path}} {{package_name}} {{project_name}}`
+`cordova create {{path/to/directory}} {{package}} {{project_name}}`
 
 - Display the current workspace status:
 

pages/common/cradle-elastic.md

@@ -9,7 +9,7 @@
 
 - Truncate the Elasticsearch index for a specific package:
 
-`cradle elastic flush {{package_name}}`
+`cradle elastic flush {{package}}`
 
 - Submit the Elasticsearch schema:
 
@@ -17,7 +17,7 @@
 
 - Submit the Elasticsearch schema for a specific package:
 
-`cradle elastic map {{package_name}}`
+`cradle elastic map {{package}}`
 
 - Populate the Elasticsearch indices for all packages:
 
@@ -25,4 +25,4 @@
 
 - Populate the Elasticsearch indices for a specific package:
 
-`cradle elastic populate {{package_name}}`
+`cradle elastic populate {{package}}`

pages/common/cradle-sql.md

@@ -9,7 +9,7 @@
 
 - Rebuild the database schema for a specific package:
 
-`cradle sql build {{package_name}}`
+`cradle sql build {{package}}`
 
 - Empty the entire database:
 
@@ -17,7 +17,7 @@
 
 - Empty the database tables for a specific package:
 
-`cradle sql flush {{package_name}}`
+`cradle sql flush {{package}}`
 
 - Populate the tables for all packages:
 
@@ -25,4 +25,4 @@
 
 - Populate the tables for a specific package:
 
-`cradle sql populate {{package_name}}`
+`cradle sql populate {{package}}`

pages/common/cs-launch.md

@@ -5,11 +5,11 @@
 
 - Launch a specific application with arguments:
 
-`cs launch {{application_name}} -- {{arg1 arg2 ...}}`
+`cs launch {{application_name}} -- {{argument1 argument2 ...}}`
 
 - Launch a specific application version with arguments:
 
-`cs launch {{application_name}}:{{application_version}} -- {{arg1 arg2 ...}}`
+`cs launch {{application_name}}:{{application_version}} -- {{argument1 argument2 ...}}`
 
 - Launch a specific version of an application specifying which is the main file:
 

pages/common/espanso.md

@@ -13,7 +13,7 @@
 
 - Install a package from the hub store (<https://hub.espanso.org/>):
 
-`espanso install {{package_name}}`
+`espanso install {{package}}`
 
 - Restart (required after installing a package, useful in case of failure):
 

pages/common/kubectl-run.md

@@ -5,20 +5,20 @@
 
 - Run an nginx pod and expose port 80:
 
-`kubectl run --generator=run-pod/v1 nginx --image=nginx --port 80`
+`kubectl run {{nginx-dev}} --image=nginx --port 80`
 
 - Run an nginx pod, setting the TEST_VAR environment variable:
 
-`kubectl run --generator=run-pod/v1 nginx --image=nginx --env="TEST_VAR=testing"`
+`kubectl run {{nginx-dev}} --image=nginx --env="{{TEST_VAR}}={{testing}}"`
 
 - Show API calls that would be made to create an nginx container:
 
-`kubectl run --generator=run-pod/v1 nginx --image=nginx --dry-run`
+`kubectl run {{nginx-dev}} --image=nginx --dry-run={{none|server|client}}`
 
 - Run an Ubuntu pod interactively, never restart it, and remove it when it exits:
 
-`kubectl run --generator=run-pod/v1 -it temp-ubuntu --image=ubuntu:20.04 --restart=Never --rm -- /bin/bash`
+`kubectl run {{temp-ubuntu}} --image=ubuntu:22.04 --restart=Never --rm -- /bin/bash`
 
 - Run an Ubuntu pod, overriding the default command with echo, and specifying custom arguments:
 
-`kubectl run --generator=run-pod/v1 temp-ubuntu --image=ubuntu:20.04 --command -- echo arg1 arg2 arg3`
+`kubectl run {{temp-ubuntu}} --image=ubuntu:22.04 --command -- echo {{argument1 argument2 ...}}`

pages/common/mamba-repoquery.md

@@ -5,7 +5,7 @@
 
 - Search for all available versions of a particular package:
 
-`mamba repoquery search {{package_name}}`
+`mamba repoquery search {{package}}`
 
 - Search for all packages satisfying specific constraints:
 

pages/common/meteor.md

@@ -17,11 +17,11 @@
 
 - Add a package to the project:
 
-`meteor add {{package_name}}`
+`meteor add {{package}}`
 
 - Remove a package from the project:
 
-`meteor remove {{package_name}}`
+`meteor remove {{package}}`
 
 - Create a production build of the project as a tarball under the given directory:
 

pages/common/minifab.md

@@ -25,7 +25,7 @@
 
 - Invoke a chaincode method with the specified arguments:
 
-`minifab invoke -n {{chaincode_name}} -p '"{{method_name}}", "{{arg0}}", "{{arg1}}", ...'`
+`minifab invoke -n {{chaincode_name}} -p '"{{method_name}}", "{{argument1}}", "{{argument2}}", ...'`
 
 - Make a query on the ledger:
 

pages/common/mvn.md

@@ -34,4 +34,4 @@
 
 - Run a class with a main method:
 
-`mvn exec:java -Dexec.mainClass="{{com.example.Main}}" -Dexec.args="{{arg1 arg2}}"`
+`mvn exec:java -Dexec.mainClass="{{com.example.Main}}" -Dexec.args="{{argument1 argument2 ...}}"`

pages/common/nimble.md

@@ -10,7 +10,7 @@
 
 - Install a package:
 
-`nimble install {{package_name}}`
+`nimble install {{package}}`
 
 - List installed packages:
 

pages/common/nix-shell.md

@@ -10,7 +10,7 @@
 
 - Run shell command in non-interactive shell and exit:
 
-`nix-shell --run "{{command}} {{arg1 arg2 ...}}"`
+`nix-shell --run "{{command}} {{argument1 argument2 ...}}"`
 
 - Start with expression in `default.nix` in the current directory:
 
@@ -18,12 +18,12 @@
 
 - Start with packages loaded from nixpkgs:
 
-`nix-shell --packages {{package_name_1 package_name_2 ...}}`
+`nix-shell --packages {{package1 package2 ...}}`
 
 - Start with packages loaded from specific nixpkgs revision:
 
-`nix-shell --packages {{package_name_1 package_name_2 ...}} -I nixpkgs={{https://github.com/NixOS/nixpkgs/archive/nixpkgs_revision.tar.gz}}`
+`nix-shell --packages {{package1 package2 ...}} -I nixpkgs={{https://github.com/NixOS/nixpkgs/archive/nixpkgs_revision.tar.gz}}`
 
 - Evaluate rest of file in specific interpreter, for use in `#!-scripts` (see <https://nixos.org/manual/nix/stable/#use-as-a-interpreter>):
 
-`nix-shell -i {{interpreter}} --packages {{package_name_1 package_name_2 ...}}`
+`nix-shell -i {{interpreter}} --packages {{package1 package2 ...}}`

pages/common/npm-query.md

@@ -13,11 +13,11 @@
 
 - Print dependencies with a specific name:
 
-`npm query '#{{package_name}}'`
+`npm query '#{{package}}'`
 
 - Print dependencies with a specific name and within a semantic versioning range:
 
-`npm query #{{package_name}}@{{semantic_version}}`
+`npm query #{{package}}@{{semantic_version}}`
 
 - Print dependencies which have no dependencies:
 

pages/common/npm-why.md

@@ -5,4 +5,4 @@
 
 - Show why an npm package is installed:
 
-`npm-why {{package_name}}`
+`npm-why {{package}}`

pages/common/npx.md

@@ -5,19 +5,19 @@
 
 - Execute the command from a local or remote `npm` package:
 
-`npx {{command}} {{arg1 arg2 ...}}`
+`npx {{command}} {{argument1 argument2 ...}}`
 
-- In case multiple commands with the same name exist, it is possible to specify the package name:
+- In case multiple commands with the same name exist, it is possible to explicitly specify the package:
 
-`npx --package {{package_name}} {{command}}`
+`npx --package {{package}} {{command}}`
 
 - Run a command if it exists in the current path or in `node_modules/.bin`:
 
-`npx --no-install {{command}} {{command_arguments}}`
+`npx --no-install {{command}} {{argument1 argument2 ...}}`
 
 - Execute a specific command suppressing any output from `npx` itself:
 
-`npx --quiet {{command}} {{arg1 arg2 ...}}`
+`npx --quiet {{command}} {{argument1 argument2 ...}}`
 
 - Display help:
 

pages/common/opam.md

@@ -10,15 +10,15 @@
 
 - Search for packages:
 
-`opam search {{package_name}}`
+`opam search {{query}}`
 
 - Install a package and all of its dependencies:
 
-`opam install {{package_name}}`
+`opam install {{package}}`
 
 - Display detailed information about a package:
 
-`opam show {{package_name}}`
+`opam show {{package}}`
 
 - List all installed packages:
 

pages/common/pio-package.md

@@ -26,12 +26,12 @@
 
 - Remove all versions of a published package from the registry:
 
-`pio package unpublish {{package_name}}`
+`pio package unpublish {{package}}`
 
 - Remove a specific version of a published package from the registry:
 
-`pio package unpublish {{package_name}}@{{version}}`
+`pio package unpublish {{package}}@{{version}}`
 
 - Undo the removal, putting all versions or a specific version of the package back into the registry:
 
-`pio package unpublish --undo {{package_name}}@{{version}}`
+`pio package unpublish --undo {{package}}@{{version}}`

pages/common/pip-install.md

@@ -5,11 +5,11 @@
 
 - Install a package:
 
-`pip install {{package_name}}`
+`pip install {{package}}`
 
 - Install a specific version of a package:
 
-`pip install {{package_name}}=={{package_version}}`
+`pip install {{package}}=={{version}}`
 
 - Install packages listed in a file:
 

pages/common/pip-uninstall.md

@@ -5,7 +5,7 @@
 
 - Uninstall a package:
 
-`pip uninstall {{package_name}}`
+`pip uninstall {{package}}`
 
 - Uninstall packages listed in a specific file:
 
@@ -13,4 +13,4 @@
 
 - Uninstall package without asking for confirmation:
 
-`pip uninstall --yes {{package_name}}`
+`pip uninstall --yes {{package}}`

pages/common/pip.md

@@ -6,7 +6,7 @@
 
 - Install a package (see `pip install` for more install examples):
 
-`pip install {{package_name}}`
+`pip install {{package}}`
 
 - Install a package to the user's directory instead of the system-wide default location:
 
@@ -14,11 +14,11 @@
 
 - Upgrade a package:
 
-`pip install --upgrade {{package_name}}`
+`pip install --upgrade {{package}}`
 
 - Uninstall a package:
 
-`pip uninstall {{package_name}}`
+`pip uninstall {{package}}`
 
 - Save installed packages to file:
 
@@ -26,7 +26,7 @@
 
 - Show installed package info:
 
-`pip show {{package_name}}`
+`pip show {{package}}`
 
 - Install packages from a file:
 

pages/common/pip3.md

@@ -3,25 +3,21 @@
 > Python package manager.
 > More information: <https://pip.pypa.io>.
 
-- Find available packages:
-
-`pip3 search {{package_name}}`
-
 - Install a package:
 
-`pip3 install {{package_name}}`
+`pip3 install {{package}}`
 
 - Install a specific version of a package:
 
-`pip3 install {{package_name}}=={{package_version}}`
+`pip3 install {{package}}=={{version}}`
 
 - Upgrade a package:
 
-`pip3 install --upgrade {{package_name}}`
+`pip3 install --upgrade {{package}}`
 
 - Uninstall a package:
 
-`pip3 uninstall {{package_name}}`
+`pip3 uninstall {{package}}`
 
 - Save the list of installed packages to a file:
 
@@ -33,4 +29,4 @@
 
 - Show installed package info:
 
-`pip3 show {{package_name}}`
+`pip3 show {{package}}`

pages/common/pipenv.md

@@ -14,7 +14,7 @@
 
 - Install a package:
 
-`pipenv install {{package_name}}`
+`pipenv install {{package}}`
 
 - Install all the dependencies for a project:
 
@@ -26,7 +26,7 @@
 
 - Uninstall a package:
 
-`pipenv uninstall {{package_name}}`
+`pipenv uninstall {{package}}`
 
 - Start a shell within the created virtual environment:
 

pages/common/pypy.md

@@ -25,7 +25,7 @@
 
 - Install a package using pip:
 
-`pypy -m pip install {{package_name}}`
+`pypy -m pip install {{package}}`
 
 - Interactively debug a Python script:
 

pages/common/python.md

@@ -25,7 +25,7 @@
 
 - Install a package using `pip`:
 
-`python -m {{pip}} install {{package_name}}`
+`python -m pip install {{package}}`
 
 - Interactively debug a Python script:
 

pages/common/stack.md

@@ -5,7 +5,7 @@
 
 - Create a new package:
 
-`stack new {{package_name}} {{template_name}}`
+`stack new {{package}} {{template}}`
 
 - Compile a package:
 
@@ -25,4 +25,4 @@
 
 - Run a program and pass an argument to it:
 
-`stack exec {{program_name}} -- {{argument}}`
+`stack exec {{program}} -- {{argument}}`

pages/common/tlmgr-info.md

@@ -17,11 +17,11 @@
 
 - Show information about a specific package:
 
-`tlmgr info {{package_name}}`
+`tlmgr info {{package}}`
 
 - List all files contained in a specific package:
 
-`tlmgr info {{package_name}} --list`
+`tlmgr info {{package}} --list`
 
 - List all installed packages:
 
@@ -29,7 +29,7 @@
 
 - Show only specific information about a package:
 
-`tlmgr info {{package_name}} --data "{{name}},{{category}},{{installed}},{{size}},{{depends}},..."`
+`tlmgr info {{package}} --data "{{name}},{{category}},{{installed}},{{size}},{{depends}},..."`
 
 - Print all available packages as JSON encoded array:
 

pages/common/wapm.md

@@ -11,17 +11,17 @@
 
 `wapm install`
 
-- Download a specific version of a package and add it to the list of dependencies in wapm.toml:
+- Download a specific version of a package and add it to the list of dependencies in `wapm.toml`:
 
-`wapm install {{package_name}}@{{version}}`
+`wapm install {{package}}@{{version}}`
 
 - Download a package and install it globally:
 
-`wapm install --global {{package_name}}`
+`wapm install --global {{package}}`
 
 - Uninstall a package and remove it from the list of dependencies in `wapm.toml`:
 
-`wapm uninstall {{package_name}}`
+`wapm uninstall {{package}}`
 
 - Print a tree of locally installed dependencies:
 

pages/common/yarn-why.md

@@ -5,4 +5,4 @@
 
 - Show why a Yarn package is installed:
 
-`yarn-why {{package_name}}`
+`yarn-why {{package}}`