diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json new file mode 100644 index 000000000..57a2cdc5b --- /dev/null +++ b/.devcontainer/devcontainer.json @@ -0,0 +1,35 @@ +{ + "name": "tldr-pages", + "image": "mcr.microsoft.com/devcontainers/base:ubuntu", // Use Microsoft's Ubuntu Base image for the dev container + "features": { // Use Node and Python features in the dev container + "ghcr.io/devcontainers/features/node:1": {}, + "ghcr.io/devcontainers/features/python:1": {} + }, + + "privileged": false, // Run the container unprivileged + + "onCreateCommand": { + "install-python-packages": "pip install -r requirements.txt", // Install Python dependencies in the dev container + "install-node-packages": "npm install" // Install NPM dependencies in the dev container + }, + + "customizations": { + "vscode": { + "settings": { + // Define suggested settings for the dev container + "resmon.show.battery": false, + "resmon.show.cpufreq": false + }, + "extensions": [ + // Define suggested extensions to preinstall in the dev container + "EditorConfig.EditorConfig", + "ms-python.python", + "ms-python.vscode-pylance", + "ms-python.flake8", + "GitHub.vscode-pull-request-github", + "github.vscode-github-actions", + "DavidAnson.vscode-markdownlint" + ] + } + } +} diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index cc9130c3f..a75c6a290 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -7,7 +7,7 @@ /pages.it/ @mebeim @yutyo @Magrid0 /pages.ko/ @IMHOJEONG /pages.nl/ @sebastiaanspeck @leonvsc @Waples -/pages.pl/ @acuteenvy +/pages.pl/ @acuteenvy @spageektti /pages.pt_BR/ @isaacvicente @vitorhcl /pages.pt_PT/ @waldyrious /pages.ta/ @kbdharun @@ -15,11 +15,14 @@ /pages.zh/ @blueskyson @einverne /pages.zh_TW/ @blueskyson -/pages/linux/ @cyqsimon +/pages/common/ @spageektti +/pages/linux/ @cyqsimon @spageektti +/pages/windows/ @spageektti -/*.md @sbrl @kbdharun +/*.md @sbrl @kbdharun @sebastiaanspeck +/.devcontainer/* @kbdharun @sebastiaanspeck /.github/workflows/* @sbrl @kbdharun @sebastiaanspeck -/scripts/* @sebastiaanspeck +/scripts/* @sebastiaanspeck @kbdharun /contributing-guides/maintainers-guide.md @sbrl @kbdharun /contributing-guides/style-guide.md @sbrl @kbdharun @@ -32,7 +35,7 @@ /contributing-guides/*.it.md @mebeim @yutyo @Magrid0 /contributing-guides/*.ko.md @IMHOJEONG /contributing-guides/*.nl.md @sebastiaanspeck @leonvsc @Waples -/contributing-guides/*.pl.md @acuteenvy +/contributing-guides/*.pl.md @acuteenvy @spageektti /contributing-guides/*.pt_BR.md @isaacvicente @vitorhcl /contributing-guides/*.pt_PT.md @waldyrious /contributing-guides/*.ta.md @kbdharun diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index ee6215366..c549ed456 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -2,14 +2,14 @@ name: CI on: ['push', 'pull_request'] -permissions: - contents: write # to upload assets to releases - jobs: ci: - runs-on: ubuntu-latest - name: CI + runs-on: ubuntu-latest + permissions: + contents: write # to upload assets to releases + attestations: write # to upload assets attestation for build provenance + id-token: write # grant additional permission to attestation action to mint the OIDC token permission steps: - uses: actions/checkout@v4 @@ -34,7 +34,7 @@ jobs: run: npm ci - name: Install pip dependencies - run: pip install -r requirements.txt -r scripts/pdf/requirements.txt + run: pip install -r requirements.txt -r scripts/pdf/requirements.txt -r scripts/test-requirements.txt - name: Test run: npm test @@ -53,3 +53,53 @@ jobs: env: DEPLOY_KEY: ${{ secrets.DEPLOY_KEY }} GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + + - name: Check for generated files + if: github.repository == 'tldr-pages/tldr' && github.ref == 'refs/heads/main' + id: check-files + run: | + if [[ -n $(find language_archives -name "*.zip" -print -quit) ]]; then + echo "zip_exists=true" >> $GITHUB_ENV + else + echo "zip_exists=false" >> $GITHUB_ENV + fi + + if [[ -n $(find scripts/pdf -name "*.pdf" -print -quit) ]]; then + echo "pdf_exists=true" >> $GITHUB_ENV + else + echo "pdf_exists=false" >> $GITHUB_ENV + fi + + if [[ -f tldr.sha256sums ]]; then + echo "checksums_exist=true" >> $GITHUB_ENV + else + echo "checksums_exist=false" >> $GITHUB_ENV + fi + + - name: Construct subject-path for attest + if: github.repository == 'tldr-pages/tldr' && github.ref == 'refs/heads/main' + id: construct-subject-path + run: | + subject_path="" + if [[ ${{ env.zip_exists }} == 'true' ]]; then + zip_files=$(find language_archives -name '*.zip' -printf '%p,') + subject_path+="${zip_files::-1}" + fi + if [[ ${{ env.pdf_exists }} == 'true' ]]; then + if [[ -n $subject_path ]]; then subject_path+=","; fi + pdf_files=$(find scripts/pdf -name '*.pdf' -printf '%p,') + subject_path+="${pdf_files::-1}" + fi + if [[ ${{ env.checksums_exist }} == 'true' ]]; then + if [[ -n $subject_path ]]; then subject_path+=","; fi + subject_path+='tldr.sha256sums' + fi + echo "subject_path=$subject_path" >> $GITHUB_ENV + + - name: Attest generated files + if: github.repository == 'tldr-pages/tldr' && github.ref == 'refs/heads/main' + id: attest + uses: actions/attest-build-provenance@v1 + continue-on-error: true # prevent failing when no pages are modified + with: + subject-path: ${{ env.subject_path }} diff --git a/.github/workflows/codespell.yml b/.github/workflows/codespell.yml index 06399b5bc..6b99122b8 100644 --- a/.github/workflows/codespell.yml +++ b/.github/workflows/codespell.yml @@ -17,7 +17,7 @@ jobs: - name: Get changed files id: changed-files - uses: tj-actions/changed-files@v42.0.5 + uses: tj-actions/changed-files@v44.5.2 with: # Ignore all other languages except English files_ignore: | diff --git a/.github/workflows/copy-release-assets.yml b/.github/workflows/copy-release-assets.yml index 81780f665..b7ceca60b 100644 --- a/.github/workflows/copy-release-assets.yml +++ b/.github/workflows/copy-release-assets.yml @@ -4,28 +4,50 @@ on: release: types: published -permissions: - contents: write - env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} jobs: release: - name: Copy assets to the new release + name: Copy release assets runs-on: ubuntu-latest + permissions: + contents: write # to upload assets to releases + attestations: write # to upload assets attestation for build provenance + id-token: write # grant additional permission to attestation action to mint the OIDC token permission steps: - uses: actions/checkout@v4 with: fetch-depth: 0 - - name: Download and upload + - name: Set tag names run: | - LATEST="$(git describe --tags --abbrev=0)" - PREVIOUS="$(git describe --tags --abbrev=0 "$LATEST"^)" + echo "LATEST=$(git describe --tags --abbrev=0)" >> $GITHUB_ENV + echo "PREVIOUS=$(git describe --tags --abbrev=0 $(git describe --tags --abbrev=0)^)" >> $GITHUB_ENV + - name: Download assets + run: | mkdir release-assets && cd release-assets - gh release download "$PREVIOUS" - gh release upload "$LATEST" -- * + + - name: Construct subject-path for attest + if: github.repository == 'tldr-pages/tldr' + id: construct-subject-path + run: | + zip_files=$(find release-assets -name '*.zip' -printf '%p,') + pdf_files=$(find release-assets -name '*.pdf' -printf '%p,') + subject_path="${zip_files::-1},${pdf_files::-1},release-assets/tldr.sha256sums" + echo "subject_path=$subject_path" >> $GITHUB_ENV + + - name: Attest copied assets + if: github.repository == 'tldr-pages/tldr' + id: attest + uses: actions/attest-build-provenance@v1 + with: + subject-path: ${{ env.subject_path }} + + - name: Upload assets + if: github.repository == 'tldr-pages/tldr' + working-directory: release-assets + run: gh release upload "$LATEST" -- * diff --git a/.github/workflows/labeler.yml b/.github/workflows/labeler.yml index 3ec4e2dac..d413bdedd 100644 --- a/.github/workflows/labeler.yml +++ b/.github/workflows/labeler.yml @@ -6,6 +6,6 @@ jobs: labeler: runs-on: ubuntu-latest steps: - - uses: tldr-pages/tldr-labeler-action@v0 + - uses: tldr-pages/tldr-labeler-action@v0.4.0 with: token: "${{ secrets.GITHUB_TOKEN }}" diff --git a/.gitignore b/.gitignore index 3c58aaac6..c5b177035 100644 --- a/.gitignore +++ b/.gitignore @@ -28,3 +28,6 @@ scripts/pdf/tldr-pages.pdf # Python venv for testing the PDF script # Create it with: python3 -m venv scripts/pdf/venv/ venv + +# Generated pycache +__pycache__ diff --git a/.markdownlintrc b/.markdownlint.json similarity index 91% rename from .markdownlintrc rename to .markdownlint.json index 9cd9f1618..3dd7a5e59 100644 --- a/.markdownlintrc +++ b/.markdownlint.json @@ -3,6 +3,7 @@ "MD003": { "style": "atx" }, "MD007": { "indent": 4 }, "MD013": { "line_length": 250 }, + "MD029": false, "MD033": false, "MD034": false, "no-hard-tabs": false, diff --git a/CLIENT-SPECIFICATION.md b/CLIENT-SPECIFICATION.md index 91abad22a..9ad0c541b 100644 --- a/CLIENT-SPECIFICATION.md +++ b/CLIENT-SPECIFICATION.md @@ -1,6 +1,7 @@ + # tldr-pages client specification -**Current Specification Version:** 2.1 +**Current Specification Version:** 2.2 This document contains the official specification for tldr-pages clients. It is _not_ a specification of the format of the pages themselves - only a specification of how a user should be able to interface with an official client. For a list of previous versions of the specification, see the [changelog section](#changelog) below. @@ -112,7 +113,7 @@ The structure inside these translation folders is identical to that of the main ## Page structure -Although this specification is about the interface that clients must provide, it is also worth noting that pages are written in standard [CommonMark](https://commonmark.org/), with the exception of the non-standard `{{` and `}}` placeholder syntax, which surrounds values in an example that users may edit. Clients MAY highlight the placeholders and MUST remove the surrounding curly braces. Clients MUST NOT treat them as the placeholder syntax if they are escaped using `\` (i.e. `\{\{` and `\}\}`) and MUST instead display literal braces, without backslashes. Placeholder escaping applies only when both braces are escaped (e.g. in `\{` or `\{{`, backslashes MUST be displayed). In cases when a command uses `{}` in its arguments (e.g. `stash@{0}`) ***the outer braces*** mark the placeholder - the braces inside MUST be displayed. Clients MUST NOT break if the page format is changed within the _CommonMark_ specification. +Although this specification is about the interface that clients must provide, it is also worth noting that pages are written in standard [CommonMark](https://commonmark.org/), with the exception of the non-standard `{{` and `}}` placeholder syntax, which surrounds values in an example that users may edit. Clients MAY highlight the placeholders and MUST remove the surrounding curly braces. Clients MUST NOT treat them as the placeholder syntax if they are escaped using `\` (i.e. `\{\{` and `\}\}`) and MUST instead display literal braces, without backslashes. Placeholder escaping applies only when both braces are escaped (e.g. in `\{` or `\{{`, backslashes MUST be displayed). In cases when a command uses `{}` in its arguments (e.g. `stash@{0}`) **_the outer braces_** mark the placeholder - the braces inside MUST be displayed. Clients MUST NOT break if the page format is changed within the _CommonMark_ specification. ### Examples @@ -162,7 +163,7 @@ If a page cannot be found in _any_ platform, then it is RECOMMENDED that clients https://github.com/tldr-pages/tldr/issues/new?title=page%20request:%20{command_name} ``` -where `{command_name}` is the name of the command that was not found. Clients that have control over their exit code on the command line (i.e. clients that provide a CLI) MUST exit with a non-zero exit code in addition to showing the above message. +where `{command_name}` is the name of the command that was not found. Clients that have control over their exit code on the command-line (i.e. clients that provide a CLI) MUST exit with a non-zero exit code in addition to showing the above message. #### If multiple versions of a page were found @@ -216,6 +217,9 @@ Step | Path checked | Outcome If appropriate, it is RECOMMENDED that clients implement a cache of pages. If implemented, clients MUST download the entire archive either as a whole from **** or download language-specific archives in the format `https://github.com/tldr-pages/tldr/releases/latest/download/tldr-pages.{{language-code}}.zip` (e.g. ****). The English archive is also available from ****. +> [!CAUTION] +> Prior to version 2.2, the client specification stated that clients MUST download archives from . This method is now deprecated, and **_will be removed_** in the future. + Caching SHOULD be done according to the user's language configuration (if any), to not waste unneeded space for unused languages. Additionally, clients MAY automatically update the cache regularly. ## Changelog @@ -232,10 +236,11 @@ the form `vX.Y`) should be done immediately AFTER merging the version bump, as the commit hash changes when merging with squash or rebase. --> -- Unreleased +- [v2.2, March 20th 2024](https://github.com/tldr-pages/tldr/blob/v2.2/CLIENT-SPECIFICATION.md) ([#12452](https://github.com/tldr-pages/tldr/pull/12452)) - Removed redirect text from the [caching section](#caching) ([#12133](https://github.com/tldr-pages/tldr/pull/12133)) - Updated asset URLs to use GitHub releases ([#12158](https://github.com/tldr-pages/tldr/pull/12158)) - Add requirement to disambiguate triple-brace placeholders ([#12158](https://github.com/tldr-pages/tldr/pull/12158)) + - Add notice to deprecate the old asset URL ([#12452](https://github.com/tldr-pages/tldr/pull/12452)) - [v2.1, November 30th 2023](https://github.com/tldr-pages/tldr/blob/v2.1/CLIENT-SPECIFICATION.md) ([#11523](https://github.com/tldr-pages/tldr/pull/11523)) - Add requirement to support escaping the placeholder syntax in certain pages ([#10730](https://github.com/tldr-pages/tldr/pull/10730)) diff --git a/COMMUNITY-ROLES.md b/COMMUNITY-ROLES.md index fc6d093bc..00da41212 100644 --- a/COMMUNITY-ROLES.md +++ b/COMMUNITY-ROLES.md @@ -20,6 +20,9 @@ straightforward, transparent, predictable, and impartial, the metrics used are objective, easy to check, and explicitly described below. (That's not to say they're hard-set rules: exceptions can always be considered through open community discussion.) +> [!IMPORTANT] +> It is required to have [two-factor authentication](https://github.com/settings/security) (2FA) enabled for your GitHub account to be added as an outside collaborator or a member of the tldr-pages organization. + ## When to change roles - **Regular contributors should be added as collaborators in the repository.** @@ -74,7 +77,6 @@ exceptions can always be considered through open community discussion.) Indeed, if they return to active participation in the project, they should be added back to the organization, to reflect that fact. - ## How to change roles > [!NOTE] @@ -91,7 +93,7 @@ using one of the template messages below as a base. 1. Open an issue with the following message template (edit it as appropriate): - ``` + ```md Hi, @username! You seem to be enjoying contributing to the tldr-pages project. You now have had five distinct pull requests [merged]()! That qualifies you to become a collaborator in this repository, as explained in our [community roles documentation](https://github.com/tldr-pages/tldr/blob/main/COMMUNITY-ROLES.md). @@ -105,6 +107,9 @@ using one of the template messages below as a base. So, what do you say? Can we add you as a collaborator? Either way, thanks for all your work so far! + + > [!NOTE] + > It is required to have [two-factor authentication](https://github.com/settings/security) (2FA) enabled for your GitHub account to be added as a collaborator to the tldr-pages/tldr repository. ``` 2. Once they acknowledge the message and if they accept the invitation, @@ -120,7 +125,7 @@ using one of the template messages below as a base. 1. Open an issue with the following message template (edit it as appropriate): - ``` + ```md Hi, @username! After joining as a collaborator in the repository, you have been regularly performing [maintenance tasks](). Thank you for that! @@ -152,7 +157,7 @@ using one of the template messages below as a base. 1. Open an issue with the following message template (edit it as appropriate): - ``` + ```md Hi, @username! You've been an active tldr-pages organization member for over 6 months. Thanks for sticking around this far and helping out! @@ -180,7 +185,7 @@ using one of the template messages below as a base. 1. Open an issue with the following message template (edit it as appropriate): - ``` + ```md Hi, @username! As you know, our [community roles documentation](https://github.com/tldr-pages/tldr/blob/main/COMMUNITY-ROLES.md) defines processes for keeping the list of organization members in sync with the actual maintenance team. Since you haven't been active in the project for a while now, we'll be relieving you from the maintainer responsibilities. @@ -215,7 +220,9 @@ can then perform the actual role changes. ## CODEOWNERS -The [`.github/CODEOWNERS` file](https://github.com/tldr-pages/tldr/blob/main/.github/CODEOWNERS) allows contributors with write access to the [tldr-pages/tldr repository](https://github.com/tldr-pages/tldr) to get automatic review request notifications for given files and directories. +The [`.github/CODEOWNERS` file](https://github.com/tldr-pages/tldr/blob/main/.github/CODEOWNERS) allows contributors with write access to the [tldr-pages/tldr repository](https://github.com/tldr-pages/tldr) +to get automatic review request notifications for given files and directories. + If they wish to, contributors can open a pull request to add themselves to this file as desired. Example uses include (but are not limited to): diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index de2460784..ef4de4373 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -21,6 +21,10 @@ Contributions to the tldr-pages project are [most welcome](GOVERNANCE.md)! All `tldr` pages are stored in Markdown right here on GitHub. Just open an issue or send a pull request, and we'll incorporate it as soon as possible. +> [!IMPORTANT] +> While this file contains general instructions to get started, it is suggested to read the [style guide](contributing-guides/style-guide.md) and [translation templates](contributing-guides/translation-templates) +> for more detailed information about the syntax and commonly used translation terms. + To get started, please [sign](https://cla-assistant.io/tldr-pages/tldr) the [Contributor License Agreement](https://gist.github.com/waldyrious/e50feec13683e565769fbd58ce503d4e). @@ -50,12 +54,14 @@ When in doubt, have a look at a few existing pages :). ## Directory structure -The English pages directory is called `pages`, under which the platform directories are present. Language-specific directories must follow the pattern `pages.`, where `` is a [POSIX Locale Name](https://www.gnu.org/software/gettext/manual/html_node/Locale-Names.html#Locale-Names) in the form of `[_]`, where: +The English pages directory is called `pages`, under which the platform directories are present. Language-specific directories must follow the pattern `pages.`, where `` is a +[POSIX Locale Name](https://www.gnu.org/software/gettext/manual/html_node/Locale-Names.html#Locale-Names) in the form of `[_]`, where: - `` is the shortest [ISO 639](https://en.wikipedia.org/wiki/ISO_639) language code for the chosen language (see [here](https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes) for a complete list). - `` is the two-letter [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1) country code for the chosen region (see [here](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) for a complete list). -The `` code is optional and should only be added when there is a substantial difference between a language (`ll`) and its regional dialects (`ll_CC1`, `ll_CC2`, etc.). For example, both `fr_FR` and `fr_BE` should fall under the same `pages.fr` directory since there virtually is no difference in writing between standard French and Belgian French. +The `` code is optional and should only be added when there is a substantial difference between a language (`ll`) and its regional dialects (`ll_CC1`, `ll_CC2`, etc.). +For example, both `fr_FR` and `fr_BE` should fall under the same `pages.fr` directory since there virtually is no difference in writing between standard French and Belgian French. ### Platform directories @@ -63,14 +69,15 @@ The `pages` directory and `pages.*` language-specific directories contain the pl 1. If the command is available for **two or more** platforms, put it **under the `common` directory**. 2. If the command is **only** available for **one** platform, these are the available directories followed by their right platform: - - `android`: Android - - `freebsd`: FreeBSD - - `openbsd`: OpenBSD - - `osx`: OSX/Mac OS/macOS (will be replaced by `macos`) - - `linux`: any Linux distro - - `netbsd`: NetBSD - - `sunos`: SunOS - - `windows`: Windows + +- `android`: Android +- `freebsd`: FreeBSD +- `openbsd`: OpenBSD +- `osx`: OSX/Mac OS/macOS (will be replaced by `macos`) +- `linux`: any Linux distro +- `netbsd`: NetBSD +- `sunos`: SunOS +- `windows`: Windows ## Markdown format @@ -167,7 +174,7 @@ See these examples for reference: > [!IMPORTANT] > Translations of pages should be done based on the English (US) page in the `pages` directory. If the English pages don't exist for the command, it should be added first in a PR before creating a translation. -Translation of pages can be done by simply creating the corresponding page within the appropriate [language-specific directory](#pages-directory), creating that as well if it does not already exist. +Translation of pages can be done by simply creating the corresponding page within the appropriate [language-specific directory](#directory-structure), creating that as well if it does not already exist. > [!IMPORTANT] > When adding a new language to `tldr`, it is suggested to add it to the [translation templates](contributing-guides/translation-templates) along with any page additions. @@ -216,7 +223,8 @@ tldr-lint {{path/to/page.md}} Now, you are ready to submit a pull request! > [!TIP] -> Additionally, inside the `tldr` directory you can install the dependencies using the `npm install` command and now when you commit your changes, the tests will run automatically via the pre-commit hook. (To skip the pre-commit hook and immediately commit your changes use the `git commit --no-verify` command). +> Additionally, inside the `tldr` directory you can install the dependencies using the `npm install` command and now when you commit your changes, the tests will run automatically via the pre-commit hook. +> (To skip the pre-commit hook and immediately commit your changes use the `git commit --no-verify` command). ### Submitting changes @@ -229,11 +237,13 @@ Alternatively, you can do most of the process [using Git on the command-line](contributing-guides/git-terminal.md). > [!TIP] -> After creating a pull request, it is suggested to enable the "Allow edits by maintainers" option (This only needs to be done once the first time you create a PR). It allows maintainers to make changes to your pull request and assist you in getting it merged. +> After creating a pull request, it is suggested to enable the "Allow edits by maintainers" option (This only needs to be done once the first time you create a PR). +> It allows maintainers to make changes to your pull request and assist you in getting it merged, in addition to facilitate the contribution to go on if you can no longer work on it soon for any reason. ### Accepting suggestions within a pull request -The easiest way to apply suggested changes is to accept the suggestion made on your pull request. Refer to the [GitHub docs](https://docs.github.com/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/incorporating-feedback-in-your-pull-request) for more details. +The easiest way to apply suggested changes is to accept the suggestion made on your pull request. +Refer to the [GitHub docs](https://docs.github.com/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/incorporating-feedback-in-your-pull-request) for more details. To commit a suggestion to your pull request, click on `Commit suggestion`: @@ -268,7 +278,8 @@ For other cases, it is suggested to follow Copyright © 2014—present the [tldr-pages team](https://github.com/orgs/tldr-pages/people) and [contributors](https://github.com/tldr-pages/tldr/graphs/contributors). diff --git a/MAINTAINERS.md b/MAINTAINERS.md index 0cad6c346..0b119bd1c 100644 --- a/MAINTAINERS.md +++ b/MAINTAINERS.md @@ -6,7 +6,8 @@ This file contains a list of the maintainers of the tldr-pages project. > Only the people marked with **bold** are currently in the indicated role. > The other entries are kept for historical record. -There are three types of maintainers, as described in [COMMUNITY-ROLES.md](https://github.com/tldr-pages/tldr/blob/main/COMMUNITY-ROLES.md#when-to-change-roles): repository collaborators, organization members, and organization owners — each having specific roles in maintaining the project, as outlined below. +There are three types of maintainers, as described in [COMMUNITY-ROLES.md](https://github.com/tldr-pages/tldr/blob/main/COMMUNITY-ROLES.md#when-to-change-roles): repository collaborators, organization members, +and organization owners — each having specific roles in maintaining the project, as outlined below. In general terms, all maintainers are expected to follow the [Maintainer's guide](contributing-guides/maintainers-guide.md). @@ -27,8 +28,6 @@ If you are an owner of the organization, you can see an automated list [here](ht [8 May 2019](https://github.com/tldr-pages/tldr/issues/2988) — present - **Pierre Rudloff ([@Rudloff](https://github.com/Rudloff))**: [16 November 2019](https://github.com/tldr-pages/tldr/issues/3580) — present -- **Proscream ([@Proscream](https://github.com/Proscream))**: - [19 November 2019](https://github.com/tldr-pages/tldr/issues/3592) — present - **Guido Lena Cota ([@glenacota](https://github.com/glenacota))**: [19 October 2020](https://github.com/tldr-pages/tldr/issues/4763) — present - **Sahil Dhiman ([@sahilister](https://github.com/sahilister))**: @@ -53,26 +52,24 @@ If you are an owner of the organization, you can see an automated list [here](ht [4 September 2023](https://github.com/tldr-pages/tldr/issues/10611) — present - **Lucas Schneider ([@schneiderl](https://github.com/schneiderl))**: [11 April 2019](https://github.com/tldr-pages/tldr/issues/2898) — [17 January 2020](https://github.com/tldr-pages/tldr/issues/3764), [7 February 2023](https://github.com/tldr-pages/tldr/issues/10674) — present -- **Darío Hereñú ([@kant](https://github.com/kant))**: - [20 September 2023](https://github.com/tldr-pages/tldr/issues/10738) — present -- **Magrid0 ([@Magrid0](https://github.com/Magrid0))**: - [22 October 2023](https://github.com/tldr-pages/tldr/issues/11159) — present - **HoJeong Im ([@IMHOJEONG](https://github.com/IMHOJEONG))**: [24 October 2023](https://github.com/tldr-pages/tldr/issues/11200) — present -- **Shashank Hebbar ([@quantumflo](https://github.com/quantumflo))**: - [13 November 2023](https://github.com/tldr-pages/tldr/issues/11460) — present - **Leon ([@leonvsc](https://github.com/leonvsc))**: [14 November 2023](https://github.com/tldr-pages/tldr/issues/11495) — present - **Matthew Peveler ([@MasterOdin](https://github.com/MasterOdin))**: [9 January 2021](https://github.com/tldr-pages/tldr/issues/5122) — [18 March 2021](https://github.com/tldr-pages/tldr/issues/5473), [15 November 2023](https://github.com/tldr-pages/tldr/issues/11509) — present - **Marcher Simon ([@marchersimon](https://github.com/marchersimon))**: [9 March 2021](https://github.com/tldr-pages/tldr/issues/5390) — [9 April 2021](https://github.com/tldr-pages/tldr/issues/5722), [20 November 2023](https://github.com/tldr-pages/tldr/issues/11381) — present -- **cyqsimon ([@cyqsimon](https://github.com/cyqsimon))**: [28 December 2023](https://github.com/tldr-pages/tldr/issues/11864) — present -- **Jongwon Youn ([@korECM](https://github.com/korECM))**: [29 December 2023](https://github.com/tldr-pages/tldr/issues/11892) — present -- **Alejandro Cervera ([@tricantivu](https://github.com/tricantivu))**: [4 January 2024](https://github.com/tldr-pages/tldr/issues/11989) — present -- **Mohammad Reza Soleimani ([@MrMw3](https://github.com/MrMw3))**: [07 January 2024](https://github.com/tldr-pages/tldr/issues/12011) — present -- **Fazle Arefin ([@fazlearefin](https://github.com/fazlearefin))**: [09 February 2024](https://github.com/tldr-pages/tldr/issues/12227) — present -- **Alexandre ZANNI ([@noraj](https://github.com/noraj))**: [22 February 2024](https://github.com/tldr-pages/tldr/issues/12324) — present +- **cyqsimon ([@cyqsimon](https://github.com/cyqsimon))**: + [28 December 2023](https://github.com/tldr-pages/tldr/issues/11864) — present +- **Jongwon Youn ([@korECM](https://github.com/korECM))**: + [29 December 2023](https://github.com/tldr-pages/tldr/issues/11892) — present +- **Mohammad Reza Soleimani ([@MrMw3](https://github.com/MrMw3))**: + [07 January 2024](https://github.com/tldr-pages/tldr/issues/12011) — present +- **Alexandre ZANNI ([@noraj](https://github.com/noraj))**: + [22 February 2024](https://github.com/tldr-pages/tldr/issues/12324) — present +- **Shashank Hebbar ([@quantumflo](https://github.com/quantumflo))**: + [13 November 2023](https://github.com/tldr-pages/tldr/issues/11460) — [27 March 2024](https://github.com/tldr-pages/tldr/issues/12209), [30 March 2024](https://github.com/tldr-pages/tldr/pull/11622#issuecomment-2027932865) — present - Owen Voke ([@owenvoke](https://github.com/owenvoke)) [11 January 2018](https://github.com/tldr-pages/tldr/issues/1885) — [26 August 2018](https://github.com/tldr-pages/tldr/issues/2258) - Marco Bonelli ([@mebeim](https://github.com/mebeim)): @@ -113,7 +110,22 @@ If you are an owner of the organization, you can see an automated list [here](ht [19 October 2023](https://github.com/tldr-pages/tldr/issues/11075) — [24 October 2023](https://github.com/tldr-pages/tldr/issues/11202) - Isaac Vicente ([@isaacvicente](https://github.com/isaacvicente)): [20 September 2023](https://github.com/tldr-pages/tldr/issues/10737) — [29 December 2023](https://github.com/tldr-pages/tldr/issues/11918) -- Vitor Henrique ([@vitorhcl](https://github.com/vitorhcl)): [18 December 2023](https://github.com/tldr-pages/tldr/issues/11771) — [21 January 2024](https://github.com/tldr-pages/tldr/issues/12094) +- Vitor Henrique ([@vitorhcl](https://github.com/vitorhcl)): + [18 December 2023](https://github.com/tldr-pages/tldr/issues/11771) — [21 January 2024](https://github.com/tldr-pages/tldr/issues/12094) +- Geipro/Proscream ([@Geipro)](https://github.com/Geipro)): + [19 November 2019](https://github.com/tldr-pages/tldr/issues/3592) — [27 March 2024](https://github.com/tldr-pages/tldr/issues/12209) (Removed during 2FA enforcement) +- Ruben Vereecken ([@rubenvereecken](https://github.com/rubenvereecken)): + [18 January 2018](https://github.com/tldr-pages/tldr/issues/1878#issuecomment-358610454) — [27 March 2024](https://github.com/tldr-pages/tldr/issues/12209) (Removed during 2FA enforcement) +- Fazle Arefin ([@fazlearefin](https://github.com/fazlearefin)): + [09 February 2024](https://github.com/tldr-pages/tldr/issues/12227) — [2 April 2024](https://github.com/tldr-pages/tldr/issues/12595) +- Alejandro Cervera ([@tricantivu](https://github.com/tricantivu)): + [4 January 2024](https://github.com/tldr-pages/tldr/issues/11989) — [3 April 2024](https://github.com/tldr-pages/tldr/issues/12594) +- Magrid0 ([@Magrid0](https://github.com/Magrid0)): + [22 October 2023](https://github.com/tldr-pages/tldr/issues/11159) — [3 May 2024](https://github.com/tldr-pages/tldr/issues/12717) +- Darío Hereñú ([@kant](https://github.com/kant)): + [20 September 2023](https://github.com/tldr-pages/tldr/issues/10738) — [3 May 2024](https://github.com/tldr-pages/tldr/issues/12718) +- Wiktor ([@spageektti](https://github.com/spageektti)): + [11 May 2024](https://github.com/tldr-pages/tldr/issues/12776) — [1 June 2024](https://github.com/tldr-pages/tldr/issues/12869) ## Organization members @@ -130,13 +142,20 @@ An automated list can be found [here](https://github.com/orgs/tldr-pages/people) [19 May 2021](https://github.com/tldr-pages/tldr/issues/5989) — present - **Seth Falco ([@SethFalco](https://github.com/SethFalco))**: [21 June 2021](https://github.com/tldr-pages/tldr/issues/6149) — present -- **Juri ([@gutjuri](https://github.com/gutjuri))**: - [24 October 2023](https://github.com/tldr-pages/tldr/issues/11201) — present -- **Sebastiaan Speck ([@sebastiaanspeck](https://github.com/sebastiaanspeck))**: - [24 October 2023](https://github.com/tldr-pages/tldr/issues/11202) — present - **Isaac Vicente ([@isaacvicente](https://github.com/isaacvicente))**: [29 December 2023](https://github.com/tldr-pages/tldr/issues/11918) — present -- **Vitor Henrique ([@vitorhcl](https://github.com/vitorhcl))**: [21 January 2024](https://github.com/tldr-pages/tldr/issues/12094) — present +- **Vitor Henrique ([@vitorhcl](https://github.com/vitorhcl))**: + [21 January 2024](https://github.com/tldr-pages/tldr/issues/12094) — present +- **Fazle Arefin ([@fazlearefin](https://github.com/fazlearefin))**: + [2 April 2024](https://github.com/tldr-pages/tldr/issues/12595) — present +- **Alejandro Cervera ([@tricantivu](https://github.com/tricantivu))**: + [3 April 2024](https://github.com/tldr-pages/tldr/issues/12594) — present +- **Magrid0 ([@Magrid0](https://github.com/Magrid0))**: + [3 May 2024](https://github.com/tldr-pages/tldr/issues/12717) — present +- **Darío Hereñú ([@kant](https://github.com/kant))**: + [3 May 2024](https://github.com/tldr-pages/tldr/issues/12718) — present +- **Wiktor ([@spageektti](https://github.com/spageektti))**: + [1 June 2024](https://github.com/tldr-pages/tldr/issues/12869) — present - Owen Voke ([@owenvoke](https://github.com/owenvoke)) [26 August 2018](https://github.com/tldr-pages/tldr/issues/2258) — [8 May 2019](https://github.com/tldr-pages/tldr/issues/2989) - Marco Bonelli ([@mebeim](https://github.com/mebeim)): @@ -167,6 +186,10 @@ An automated list can be found [here](https://github.com/orgs/tldr-pages/people) [18 March 2021](https://github.com/tldr-pages/tldr/issues/5473) — [15 November 2023](https://github.com/tldr-pages/tldr/issues/11509) - Lena ([@acuteenvy](https://github.com/acuteenvy)): [21 June 2023](https://github.com/tldr-pages/tldr/issues/10406) — [27 December 2023](https://github.com/tldr-pages/tldr/issues/11839) +- Sebastiaan Speck ([@sebastiaanspeck](https://github.com/sebastiaanspeck)): + [24 October 2023](https://github.com/tldr-pages/tldr/issues/11202) — [28 April 2024](https://github.com/tldr-pages/tldr/issues/12687) +- Juri ([@gutjuri](https://github.com/gutjuri)): + [24 October 2023](https://github.com/tldr-pages/tldr/issues/11201) — [29 April 2024](https://github.com/tldr-pages/tldr/issues/12686) ## Organization owners @@ -197,6 +220,10 @@ An automated list can be found [here](https://github.com/orgs/tldr-pages/people) [7 July 2023](https://github.com/tldr-pages/tldr/issues/10054) — present - **Lena ([@acuteenvy](https://github.com/acuteenvy))**: [27 December 2023](https://github.com/tldr-pages/tldr/issues/11839) — present +- **Sebastiaan Speck ([@sebastiaanspeck](https://github.com/sebastiaanspeck))**: + [28 April 2024](https://github.com/tldr-pages/tldr/issues/12687) — present +- **Juri ([@gutjuri](https://github.com/gutjuri))**: + [29 April 2024](https://github.com/tldr-pages/tldr/issues/12686) — present - Igor Shubovych ([@igorshubovych](https://github.com/igorshubovych)): until [18 January 2018](https://github.com/tldr-pages/tldr/issues/1878#issuecomment-358610454) - Ruben Vereecken ([@rubenvereecken](https://github.com/rubenvereecken)): diff --git a/README.md b/README.md index 076345b91..d70ef836e 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,4 @@ +

tldr-pages

@@ -42,11 +43,14 @@ $ man tar There seems to be room for simpler help pages, focused on practical examples. How about: -![Screenshot of the tldr client displaying the tar command in light mode.](images/tldr-light.png#gh-light-mode-only) -![Screenshot of the tldr client displaying the tar command in dark mode.](images/tldr-dark.png#gh-dark-mode-only) + + + + Screenshot of the tldr client displaying the tar command. + This repository is just that: an ever-growing collection of examples -for the most common UNIX, Linux, macOS, SunOS, Android and Windows command-line tools. +for the most common UNIX, Linux, macOS, SunOS, Android, and Windows command-line tools. ## How do I use it? @@ -67,7 +71,8 @@ Alternatively, you can also use the official [Python client](https://github.com/ pip3 install tldr ``` -Linux and Mac users can also install the official [Rust Client](https://github.com/tldr-pages/tlrc) using [Homebrew](https://formulae.brew.sh/formula/tlrc) (or [other package managers](https://github.com/tldr-pages/tlrc#installation) on other operating systems): +Linux and Mac users can also install the official [Rust Client](https://github.com/tldr-pages/tlrc) using [Homebrew](https://formulae.brew.sh/formula/tlrc) +(or [other package managers](https://github.com/tldr-pages/tlrc#installation) on other operating systems): ```shell brew install tlrc @@ -91,7 +96,7 @@ All contributions are welcome! Some ways to contribute include: -- Adding your favorite command which isn't covered. +- Adding your favorite command that isn't covered. - Adding examples or improving the content of an existing page. - Adding requested pages from our issues with the [help wanted](https://github.com/tldr-pages/tldr/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) label. - Translating pages into different languages. @@ -111,11 +116,11 @@ You are also welcome to join us on the [matrix chatroom](https://matrix.to/#/#tl ## Similar projects - [Command Line Interface Pages](https://github.com/command-line-interface-pages) - allows you to write standardized help pages for CLI, directories and configs. + allows you to write standardized help pages for CLI, directories, and configs. - [Cheat](https://github.com/cheat/cheat) allows you to create and view interactive cheatsheets on the command-line. - It was designed to help remind *nix system administrators of options + It was designed to help remind Unix system administrators of options for commands that they use frequently, but not frequently enough to remember. - [cheat.sh](https://cheat.sh/) diff --git a/contributing-guides/git-terminal.md b/contributing-guides/git-terminal.md index 319c404bc..f649a85d7 100644 --- a/contributing-guides/git-terminal.md +++ b/contributing-guides/git-terminal.md @@ -1,4 +1,5 @@ # Using Git + ## Opening a Pull Request Most people submit pull requests to the tldr-pages project @@ -61,6 +62,7 @@ git fetch upstream main git rebase upstream/main # in case you have any merge conflicts, click the link below to see how to resolve them git push --force-with-lease # not needed if you only want to update your local repository ``` + [How to resolve merge conflicts](https://docs.github.com/en/github/collaborating-with-pull-requests/addressing-merge-conflicts/resolving-a-merge-conflict-using-the-command-line) ## Changing the email of your last commit @@ -74,15 +76,18 @@ git push --force-with-lease ## Changing the email of any commit(s) -1. Perform an [interactive rebase](https://git-scm.com/docs/git-rebase#Documentation/git-rebase.txt--i), specifying the reference of the earliest commit to modify as the argument. For example, if the earliest commit with the wrong email address was 6 commits ago, you can specify the commit hash or just `HEAD~6`. +1. Perform an [interactive rebase](https://git-scm.com/docs/git-rebase#Documentation/git-rebase.txt--i), specifying the reference of the earliest commit to modify as the argument. +For example, if the earliest commit with the wrong email address was 6 commits ago, you can specify the commit hash (check it with `git log`) or just `HEAD~6`. ```bash git rebase --interactive HEAD~6 ``` -2. You'll see a list of commits starting from the referenced commit to `HEAD`. All of them will default to the instruction `pick`, this means using the commit as-is when replaying them. For the commits you want to edit, replace the word `pick` with `edit`, then save and exit the editor. +2. You'll see a list of commits starting from the referenced commit to `HEAD`. All of them will default to the instruction `pick`, this means using the commit as-is when replaying them. +For the commits you want to edit, replace the word `pick` with `edit`, then save and exit the editor. -3. The branch will rewind to the referenced commit, then replay them until it reaches a commit with the `edit` instruction. Amend the commit for the correct email address, then continue rebasing. Repeat this step until you've successfully finished rebasing and replayed all commits. +3. The branch will rewind to the referenced commit, then replay them until it reaches a commit with the `edit` instruction. Amend the commit for the correct email address, then continue rebasing. +Repeat this step until you've successfully finished rebasing and replayed all commits. ```bash git commit --amend --author "Your Name " diff --git a/contributing-guides/style-guide.md b/contributing-guides/style-guide.md index 62c7a8062..c557c4395 100644 --- a/contributing-guides/style-guide.md +++ b/contributing-guides/style-guide.md @@ -2,7 +2,17 @@ This page lists specific formatting instructions for `tldr` pages. -## Layout +## Contents + +1. [General layout](#general-layout) +2. [Pages](#pages) +3. [General writing](#general-writing) +4. [Heading](#heading) +5. [Example descriptions](#example-descriptions) +6. [Example commands](#example-commands) +7. [Language-specific rules](#language-specific-rules) + +## General layout The basic format of each page should match the following template and have at most 8 command examples: @@ -66,10 +76,10 @@ npm install --global tldr-lint tldr-lint path/to/tldr_page.md ``` -For other ways to use `tldr-lint`, such as linting an entire directory, check out (what else!) -[`tldr tldr-lint`](https://github.com/tldr-pages/tldr/blob/main/pages/common/tldr-lint.md). Alternatively, you can also use its alias `tldrl`. +For other ways to use `tldr-lint`, such as linting an entire directory, check out the +[`tldr page on tldr-lint`](https://github.com/tldr-pages/tldr/blob/main/pages/common/tldr-lint.md). Alternatively, you can also use its alias `tldrl`. -Your client may be able to preview a page locally using the `--render` flag: +Depending on your client, you may be able to preview a page locally using the `--render` flag: ```sh tldr --render path/to/tldr_page.md @@ -83,17 +93,31 @@ When documenting PowerShell commands, please take note of the following naming c - The page title/heading must be written as-is (matching the spelling intended by Microsoft or the PowerShell module author), such as `Invoke-WebRequest` instead of `invoke-webrequest`. - The command name and options in the examples should also be written as-is, such as `Command-Name {{input}} -CommandParameter {{value}}` instead of `command-name {{input}} -commandparameter {{value}}`. -Due to [various compatibility differences](https://learn.microsoft.com/powershell/scripting/whats-new/differences-from-windows-powershell) and removed Windows-specific commands in PowerShell 6.x, Ensure that the command works on between **PowerShell 5.1** (aka. the "Legacy Windows PowerShell" as installed in Windows 10 and 11), and the **latest version of the Cross-Platform PowerShell** (formerly known as PowerShell Core). If the command or its options is unavailable or contains different behavior between each version, please kindly note them in the descriptions. For example, +Due to [various compatibility differences](https://learn.microsoft.com/powershell/scripting/whats-new/differences-from-windows-powershell) and removed Windows-specific commands in PowerShell 6.x, ensure that +the command works on between **PowerShell 5.1** (aka. the "Legacy Windows PowerShell" as installed in Windows 10 +and 11), and the **latest version of the Cross-Platform PowerShell** (formerly known as PowerShell Core). + +Thus, if the command or its options are unavailable or contain different behaviors between each version, please kindly note them in the descriptions. For example: ```md # Clear-RecycleBin > Clear items from the Recycle Bin. -> This command can only be used through PowerShell versions 5.1 and below, or 7.1 and above. +> Note: This command can only be used through PowerShell versions 5.1 and below, or 7.1 and above. > More information: . ``` -## Aliases +## Pages + +### Platform differences + +If you are afraid the commands may differ between platforms or operating systems (e.g. Windows vs macOS), +most [tldr pages clients](https://github.com/tldr-pages/tldr/wiki/tldr-pages-clients) will choose the most suitable version of the command to be displayed to the end user. + +In this case, the information of the Windows version of `cd` (stored in `pages/windows/cd.md`) will be displayed by default to Windows users, and a generic/common version (stored in `pages/common/cd.md`) +will be displayed for Linux, macOS, and other platform users. + +### Aliases If a command can be called with alternative names (like `vim` can be called by `vi`), alias pages can be created to point the user to the original command name. @@ -123,11 +147,12 @@ Example: - Pre-translated alias page templates can be found [here](https://github.com/tldr-pages/tldr/blob/main/contributing-guides/translation-templates/alias-pages.md). -### PowerShell-Specific Aliases +#### PowerShell-Specific Aliases Some PowerShell commands may introduce aliases which fall into one of these three categories: -**1. Substituting an existing Windows Command Prompt (`cmd`) command**, such as `cd` aliasing to `Set-Location` with different command options. In this case, add the following alias note into the second line of the original Command Prompt command's tldr description, for example: +1. **Replaces an existing Windows Command Prompt (`cmd`) command**, such as `cd` aliasing to `Set-Location` with different command options. In this case, add the following alias note into the second line of the original +Command Prompt command's tldr description, for example: ```md # cd @@ -141,10 +166,11 @@ Some PowerShell commands may introduce aliases which fall into one of these thre `tldr set-location` ``` -> [!TIP] -> The "View documentation of the equivalent PowerShell command" example is optional and may be excluded if the page already has the maximum number (8) of examples. +> [!NOTE] +> The "View documentation of the equivalent PowerShell command" example is optional and must be excluded if the page already has the maximum number (8) of examples. -**2. Provides a new alias but only executable in PowerShell**, such as `ni` for `New-Item`. In this case, use the [standard alias template](https://github.com/tldr-pages/tldr/blob/main/contributing-guides/translation-templates/alias-pages.md), but add the word "In Powershell," (or equivalent) to indicate that the command is exclusive to PowerShell. For example, +2. **Provides a new alias but only executable in PowerShell**, such as `ni` for `New-Item`. In this case, use the [standard alias template](https://github.com/tldr-pages/tldr/blob/main/contributing-guides/translation-templates/alias-pages.md), +but add the word "In Powershell," (or equivalent) to indicate that the command is exclusive to PowerShell. For example, ```md # ni @@ -157,7 +183,8 @@ Some PowerShell commands may introduce aliases which fall into one of these thre `tldr new-item` ``` -**3. Provides a new alias that conflicts with other programs**, most notoriously the inclusion of `curl` and `wget` as aliases of `Invoke-WebRequest` (with a non-compatible set of command options). Note that PowerShell system aliases that fall into this category are commonly exclusive to Windows. +**3. Provides a new alias that conflicts with other programs**, most notoriously the inclusion of `curl` and `wget` as aliases of `Invoke-WebRequest` (with a non-compatible set of command options). +Note that PowerShell system aliases that fall into this category are commonly exclusive to Windows. In this case, provide a note and method to determine whether the command currently refers to a PowerShell command (by alias) or others. For example, @@ -180,92 +207,52 @@ In this case, provide a note and method to determine whether the command current `tldr invoke-webrequest` ``` -## Option syntax +## General writing -- For commonly/frequently used commands (e.g. `grep`, `tar`, `etc`), we prefer using short options along with [mnemonics](#short-option-mnemonics) or both inside a placeholder. -- For highlighting both long and short options in commands (instead of using mnemonics), combine them within a placeholder i.e. `{{-o|--output}}`. -- For user-friendliness, use **GNU-style long options** (like `--help` rather than `-h`) when they are cross-platform compatible (intended to work the same across multiple platforms) for pages in `common` directory. -- When documenting PowerShell commands, use **PowerShell-style long options** (like `-Help` instead of `-H`). -- We prefer using a space instead of the equals sign (`=`) to separate options from their arguments (i.e. use `--opt arg` instead of `--opt=arg`) unless the program does not support it. +### Emphasis -### Short option mnemonics +Do not use *italics*, **boldface** or any other text styling on the pages. These are reserved for client emphasis of placeholders. -Short option mnemonics are optional hints which can be added to help users understand the meaning of these short options. The assigned mnemonics should match with the ones in the command's official documentation (e.g. from `man` or `Get-Help`). For example: +### Imperative Mood + +- **All descriptions must be phrased in the imperative mood.** +- This also applies to all translations by default unless otherwise specified in the language-specific section below. + +When writing descriptions for command examples, **check for any grammatical errors**. `Go to the specified directory` is preferred instead of: + +- `Going to the specified directory` (should not be in present participle form) +- `This command will go to the specified directory` (it is clear that this example works for *this* comment) +- `Let's go to the specified directory!` +- `Directory change` (use the active form instead of passive, if possible) + +For instance, instead of `Listing all files:`, `List all files:` can be used as the example's description below: ```md -- [d]isplay the ins[t]allation [i]D for the current device. Useful for offline license activation: +- Listing all files: -`slmgr.vbs /dti` - -- Display the current license's e[xp]i[r]ation date and time: - -`slmgr.vbs /xpr` + `ls` ``` -Note that, in the first example, the `[d]`, `[t]`, and `[i]` characters are enclosed with square brackets to indicate that the `/dti` option of the command is a combination of "display", "installation", and "ID", respectively. Consecutive mnemonic characters can be grouped under the same square brackets, such as `e[xp]i[r]ation` instead of `e[x][p]i[r]ation`. +### Serial Comma -**Mnemonic characters must be written in a case-sensitive manner**, even when it is placed as the first character of the sentence (i.e. use `[d]isplay` instead of `[D]isplay`). This is to avoid conflicts with GNU-style command options which may interpret uppercase options differently than the lowercase ones, such as `-v` for displaying the command's `[v]ersion` number and `-V` to run the command in `[V]erbose` mode. +- When declaring a list of 3 or more items, +use a [serial comma](https://en.wikipedia.org/wiki/Serial_comma), +also known as the Oxford comma, +since omitting it can create ambiguity. -Option mnemonics may also be used in translations as long as the highlighted word contains similar meanings to the language (commonly English) which the command is written for. For example, `[d]ownload` in English may be translated into `[d]escargar` in Spanish, `[i]nstall` in English may be translated to `[i]nstallieren` in German, and `[a]pp` in English may be translated into `[a]plikasi` in Indonesian and Malay. +> Delete the Git branches, tags, and remotes. -- Optionally, mnemonics and their enclosed terms can be separated with brackets from the rest of the description (i.e. `([a]ll)`) in translations and specific pages to provide additional context or mention a word not present in the description. +The example above does not use a serial comma, so this could mean one of two things: -> [!NOTE] -> In cases where the character isn't present in the translated word, you can highlight the option before/next to the equivalent word or you can add the English work beside the translation inside a bracket. For example, `E[x]tract` in English maybe translated into `[x] ekstrak` or `ekstrak [x]` or `ekstrak (E[x]tract)` in Indonesian. +- Delete the Git branches named `tags` and `remotes`. +- Delete all of the following: Git branches, Git tags, and Git remotes. -## Placeholder syntax +This can be resolved by inserting a comma before the "and" or "or" in the final element in the list. -User-provided values should use the `{{placeholder}}` syntax -in order to allow `tldr` clients to highlight them. +> Delete the Git branches, tags, and remotes. -Keep the following guidelines in mind when choosing placeholders: - -### Naming - -- Use short but descriptive placeholders, - such as `{{path/to/source_file}}` or `{{path/to/wallet.txt}}`. -- Use [`snake_case`](https://wikipedia.org/wiki/snake_case) for multi-word placeholders. -- Use a generic placeholder rather than an actual value where a generic placeholder is available (but there is an exception to this listed below). For example, use - `iostat {{1..infinity}}` rather than `iostat {{2}}`. - - If there are several consecutive placeholders of the same type - which don't allow adding arbitrary text in them (ranges), then instead of generic placeholders use descriptive ones. For example prefer `input swipe {{x_position}} {{y_position}} {{x_position}} {{y_position}} {{seconds}}` - instead of `input swipe {{-infinity..infinity}} {{-infinity..infinity}} {{-infinity..infinity}} {{-infinity..infinity}} {{1..infinity}}`. - -### Paths - -- Use `{{filename}}` when just the file name is expected. -- For any reference to paths of files or directories, - use the format `{{path/to/}}`, - except when the location is implicit. -- When the path cannot be relative, - but has to start at the root of the filesystem, - prefix it with a slash, - such as `get {{/path/to/remote_file}}`. -- In case of a possible reference both to a file or a directory, - use `{{path/to/file_or_directory}}`. - -> [!NOTE] -> If the command is specific to Windows, use backslashes (`\`) instead, such as `{{path\to\file_or_directory}}`. Drive letters such as `C:` are optional unless the command input requires an absolute path or specific drive letter range, such as `cd /d {{C}}:{{path\to\directory}}`. - -### Extensions - -- If a particular extension is expected for the file, append it. - For example, `unrar x {{path/to/compressed.rar}}`. -- In case a generic extension is needed, use `{{.ext}}`, but **only** if an extension is required. - For instance, in `find.md`'s example "Find files by extension" (`find {{path/to/root}} -name '{{*.ext}}'`) - using `{{*.ext}}` explains the command without being unnecessarily specific; - while in `wc -l {{path/to/file}}` using `{{path/to/file}}` (without extension) is sufficient. - -### Grouping placeholders - -- If a command can take 0 or more arguments of the same kind, use an ellipsis: `{{placeholder1 placeholder2 ...}}`. - For instance, if multiple paths are expected `{{path/to/directory1 path/to/directory2 ...}}` can be used. -- If a command can take 0 or more arguments of different kinds, use an ellipsis: `{{placeholder1|placeholder2|...}}`. - If there are more than 5 possible values, you can use `|...` after the last item. -- It's impossible to restrict the minimum or (and) maximum placeholder count via `ellipsis`. - -It's up to the program to decide how to handle duplicating values, provided syntax -tells no info about whether items are mutually exclusive or not. +> [!NOTE] +> Brand and project names can be capitalized in the description whenever applicable (e.g. use `A tool for interacting with a Git repository.` instead of ``A tool for interacting with a `git` repository.``). ### Special cases @@ -287,72 +274,44 @@ Use backticks on the following: - Standard streams: `stdout`, `stdin`, `stderr`. **Do not** use the full names (e.g. standard output). - Compression algorithms, e.g. `zip`, `7z`, `xz`. -## Descriptions +## Heading -- Avoid using the page title in the description (e.g. use `A sketching and painting program designed for digital artists` instead of `Krita is a sketching and painting program designed for digital artists`) unless the program name differs from the executable name (e.g. `rg` and Ripgrep). -- Avoid mentioning that the program is used on the command-line (e.g. use `Ripgrep is a recursive line-oriented search tool` instead of `Ripgrep is a recursive line-oriented CLI search tool`). -- Brand and project names can be capitalized in the description whenever applicable (e.g. use `A tool for interacting with a Git repository.` instead of ``A tool for interacting with a `git` repository.``). -- Acronym expansions (i.e. protocols, tools, etc) must not be translated unless there is a recognized native equivalent for them. -- When documenting keycaps or a keyboard shortcut for a utility it is suggested to wrap them in backticks to make them stand out in the description (i.e. ``Print the last lines of a given file and keep reading it until `Ctrl + C`:``). Alternatively, you can document them as a separate command and optionally highlight them as placeholders (i.e. `:wq{{Enter}}` or `:wq` or `:wq(Enter)`). +### More information links -### Imperative Mood +- On the `More information` link line, we prefer linking to the author's provided documentation of the command-line reference or the man page. When not available, use as the default fallback for all platforms +(except `osx` and BSD platforms other than FreeBSD). +Alternatively, you can link to the author's website or a tutorial page if the command doesn't have a documentation page. -- **All descriptions must be concise and phrased in the imperative mood.** -- This also applies to all translations by default unless otherwise specified in the language-specific section below. -- For example, when writing documentation for `cd`, a tool to check out and work on a specific directory in the Terminal or Command Prompt, **do not** write a lengthy description such as: +- For `osx`: Apple distributes the built-in man pages [in Xcode](https://developer.apple.com/documentation/os/reading_unix_manual_pages). +For commands documented there, we recommend using , an HTML export of all Apple's man pages bundled with Xcode. -```md -> `cd` is a system tool, available in Windows, macOS, and Linux, to check out a specific directory to get things done in the Command Prompt, Terminal, and PowerShell. -``` +> [!IMPORTANT] +> All links must be enclosed inside angular brackets (`<` and `>`). -It should instead be simplified to make it easier for everyone to read: +- It is suggested to use a more information link with English content in both translations and English pages. That's because the links can eventually change, but the translations are often out of sync with the English pages. -```md -> Change the current working directory. -``` +#### Versioned links -If you are afraid the commands may differ between platforms or operating systems (e.g. Windows vs macOS), most [tldr pages clients](https://github.com/tldr-pages/tldr/wiki/tldr-pages-clients) will choose the most suitable version of the command. +When a utility or distribution has versioned links for the packages, link to the most recent version of documentation (i.e. `latest`) or none if the website automatically redirects to the latest version of the documentation. -In this case, the information of the Windows version of `cd` (stored in `pages/windows/cd.md`) will be displayed by default to Windows users, and a generic/common version (stored in `pages/common/cd.md`) will be displayed for Linux, macOS, and other platforms. +For example, use: -When writing descriptions for command examples, **check for any grammatical errors**. `Go to the specified directory` is preferred instead of: +- instead of . +- instead of . -- `Going to the specified directory` (should not be in present participle form) -- `This command will go to the specified directory` (it is clear that this example works for *this* comment) -- `Let's go to the specified directory!` -- `Directory change` (use the active form instead of passive, if possible) +#### Microsoft Learn links -For instance, instead of `Listing all files:`, `List all files:` can be used as the example's description below: +When linking pages to the Microsoft Learn links, remove the locale from the address as the website will automatically redirect to the reader's preferred locale setting. +For example, Use instead of +. -```md -- Listing all files: +Additionally, if the link is related to PowerShell command documentation, remove the **documentation version indicator** (in which the version of PowerShell/module that the documentation is derived from), aka. +the part of the address that starts with `?view=`. - `ls` -``` +- Use instead of . +- Use instead of . -## Emphasis - -Do not use *italics*, **boldface** or any other text styling on the pages. These are reserved for client emphasis of placeholders. - -## Serial Comma - -- When declaring a list of 3 or more items, -use a [serial comma](https://en.wikipedia.org/wiki/Serial_comma), -also known as the Oxford comma, -since omitting it can create ambiguity. - -> Delete the Git branches, tags and remotes. - -The example above does not use a serial comma, so this could mean one of two things: - -- Delete the Git branches named `tags` and `remotes`. -- Delete all of the following: Git branches, Git tags, and Git remotes. - -This can be resolved by inserting a comma before the "and" or "or" in the final element in the list. - -> Delete the Git branches, tags, and remotes. - -## See also section +### See also section - To reference a related command or subcommand, use: @@ -368,38 +327,140 @@ This can be resolved by inserting a comma before the "and" or "or" in the final - Optionally, you can add a short description beside the referenced pages: -``See also: `date`, for Unix information; `umount`, for unmounting partitions.`` +```md +> See also: `date` for Unix information, `uname` for system information and `umount` for unmounting partitions. +``` -## More information links +## Example descriptions -- On the `More information` link line, we prefer linking to the author's provided documentation of the command line reference or the man page. When not available, use as the default fallback for all platforms (except `osx` and BSD platforms other than FreeBSD). Alternatively, you can link to the author's website or a tutorial page if the command doesn't have a documentation page. +### Wording -- For `osx`: Apple distributes the built-in man pages [in Xcode](https://developer.apple.com/documentation/os/reading_unix_manual_pages). For commands documented there, we recommend using https://keith.github.io/xcode-man-pages/, an HTML export of all Apple's man pages bundled with Xcode. +- Avoid using the page title in the description (e.g. use `A sketching and painting program designed for digital artists` instead of `Krita is a sketching and painting program designed for digital artists`) +unless the program name differs from the executable name (e.g. `rg` and Ripgrep). +- Avoid mentioning that the program is used on the command-line (e.g. use `Ripgrep is a recursive line-oriented search tool` instead of `Ripgrep is a recursive line-oriented CLI search tool`). +- For example, when writing documentation for `cd`, a tool to check out and work on a specific directory in the Terminal or Command Prompt, **do not** write a lengthy description such as: -- **All links must be enclosed inside angular brackets (`<` and `>`) for proper rendering in clients.** +```md +> `cd` is a system tool, available in Windows, macOS, and Linux, to check out a specific directory to get things done in the Command Prompt, Terminal, and PowerShell. +``` -- We prefer translations to use the more information link of the English page by default. +It should instead be simplified to make it easier for everyone to read: -### Versioned links +```md +> Change the current working directory. +``` -When a utility or distribution has versioned links for the packages, we prefer linking to the most recent version of documentation (i.e. `latest`) or none if the website automatically redirects to the latest version of the documentation. +### Formatting -For example, use: +- Proper names should be capitalized in the description whenever applicable (e.g. use `A tool for interacting with a Git repository.` instead of ``A tool for interacting with a `git` repository.``). +- Acronym expansions (i.e. protocols, tools, etc) must not be translated unless there is a recognized native equivalent for them. +- When documenting keycaps or a keyboard shortcut for a utility, make it stand out in the description: -- instead of . -- instead of . +1. If it is not translatable, enclose it with backticks (i.e. ``Print the last lines of a given file and keep reading it until `Ctrl + C`:``) +2. If it is translatable, enclose it with double angled brackets inside a placeholder (i.e. ``:wq{{<>}}``). -### Microsoft Learn links +### Short option mnemonics -When linking pages to the Microsoft Learn links, remove the locale from the address as the website will automatically redirect to the reader's preferred locale setting. For example, Use instead of -. +Short option mnemonics are optional hints that can be added to help users understand the meaning of these short options. The assigned mnemonics should match with the ones in the command's official documentation (e.g. from `man` or `Get-Help`). For example: -Additionally, if the link is related to PowerShell command documentation, remove the **documentation version indicator** (in which the version of PowerShell/module that the documentation is derived from), aka. the part of the address that starts with `?view=`. +```md +- [d]isplay the ins[t]allation [i]D for the current device. Useful for offline license activation: -- Use instead of . -- Use instead of . +`slmgr.vbs /dti` -## Help and version commands +- Display the current license's e[xp]i[r]ation date and time: + +`slmgr.vbs /xpr` +``` + +Note that, in the first example, the `[d]`, `[t]`, and `[i]` characters are enclosed with square brackets to indicate that the `/dti` option of the command is a combination of "display", "installation", and "ID", respectively. +Group consecutive mnemonic characters under the same square brackets, for example: `e[xp]i[r]ation` instead of `e[x][p]i[r]ation`. + +**Mnemonic characters must be written in a case-sensitive manner**, even when it is placed as the first character of the sentence (i.e. use `[d]isplay` instead of `[D]isplay`). +This is to avoid conflicts with GNU-style command options which may interpret uppercase options differently than the lowercase ones, such as `-v` for displaying the command's `[v]ersion` number and `-V` to run the command in `[V]erbose` mode. + +Option mnemonics may also be used in translations as long as the highlighted word contains similar meanings to the language (commonly English) which the command is written for. +For example, `[d]ownload` in English may be translated into `[d]escargar` in Spanish, `[i]nstall` in English may be translated to `[i]nstallieren` in German, and `[a]pp` in English may be translated into `[a]plikasi` in Indonesian and Malay. + +- Optionally, mnemonics and their enclosed terms can be separated with brackets from the rest of the description (i.e. `([a]ll)`) in translations and specific pages to provide additional context or mention a word not present in the description. + +> [!NOTE] +> In cases where the character isn't present in the translated word, you can highlight the option before/next to the equivalent word or you can add the English work beside the translation inside a bracket. +> For example, `E[x]tract` in English maybe translated into `[x] ekstrak` or `ekstrak [x]` or `ekstrak (E[x]tract)` in Indonesian. + +## Example commands + +### Option syntax + +- For commonly/frequently used commands (e.g. `grep`, `tar`, `etc`), we prefer using short options along with [mnemonics](#short-option-mnemonics) or both inside a placeholder. +- For highlighting both long and short options in commands (instead of using mnemonics), combine them within a placeholder i.e. `{{-o|--output}}`. +- For user-friendliness, use **GNU-style long options** (like `--help` rather than `-h`) when they are cross-platform compatible (intended to work the same across multiple platforms) for pages in the `common` directory. + +### Placeholder syntax + +User-provided values should use the `{{placeholder}}` syntax +in order to allow `tldr` clients to highlight them. + +> [!TIP] +> It is suggested to enclose placeholders accepting strings as input within quotes. i.e. Use `"{{placeholder}}"` instead of `{{"placeholder"}}`. + +Keep the following guidelines in mind when choosing placeholders: + +#### Naming + +- Use short but descriptive placeholders, + such as `{{path/to/source_file}}` or `{{path/to/wallet.txt}}`. +- Use [`snake_case`](https://wikipedia.org/wiki/snake_case) for multi-word placeholders. +- Use a generic placeholder rather than an actual value where a generic placeholder is available (but there is an exception to this listed below). For example, use +`iostat {{1..infinity}}` rather than `iostat {{2}}`. +- If there are several consecutive placeholders of the same type + which don't allow adding arbitrary text in them (ranges), then instead of generic placeholders use descriptive ones. For example prefer `input swipe {{x_position}} {{y_position}} {{x_position}} {{y_position}} {{seconds}}` + instead of `input swipe {{-infinity..infinity}} {{-infinity..infinity}} {{-infinity..infinity}} {{-infinity..infinity}} {{1..infinity}}`. + +#### Paths + +- Use `{{filename}}` when just the file name is expected. +- For any reference to paths of files or directories, + use the format `{{path/to/placeholder}}`, + except when the location is implicit. +- When the path cannot be relative, + but has to start at the root of the filesystem, + prefix it with a slash, + such as `get {{/path/to/remote_file}}`. +- In case of a possible reference both to a file or a directory, + use `{{path/to/file_or_directory}}`. + +> [!NOTE] +> If the command is specific to Windows, use backslashes (`\`) instead, such as `{{path\to\file_or_directory}}`. Drive letters such as `C:` are optional unless the command input requires an absolute path +> or specific drive letter range, such as `cd /d {{C}}:{{path\to\directory}}`. + +#### Extensions + +- If a particular extension is expected for the file, append it. + For example, `unrar x {{path/to/compressed.rar}}`. +- In case a generic extension is needed, use `{{.ext}}`, but **only** if an extension is required. + For instance, in `find.md`'s example "Find files by extension" (`find {{path/to/root}} -name '{{*.ext}}'`) + using `{{*.ext}}` explains the command without being unnecessarily specific; + while in `wc -l {{path/to/file}}` using `{{path/to/file}}` (without extension) is sufficient. + +#### Grouping placeholders + +- If a command can optionally take 1 or more arguments of the same kind, use an ellipsis: `{{placeholder1 placeholder2 ...}}`. + For instance, if multiple paths are expected, use `{{path/to/directory1 path/to/directory2 ...}}`. +- If a command can optionally take 1 or more arguments of different kinds, use an ellipsis: `{{placeholder1|placeholder2|...}}`. + If there are more than 5 possible values, you can use `|...` after the last item. +- It's impossible to restrict the minimum or (and) maximum placeholder count via `ellipsis`. + +It's up to the program to decide how to handle duplicating values, provided syntax +tells no info about whether items are mutually exclusive or not. + +#### Optional placeholders + +When documenting optional placeholders like paths or file extensions, it is suggested to specify them in the page or example descriptions instead of the placeholder itself. For example: + +- Use `{{path/to/source.ext}}` instead of `{{path/to/source.tar[.gz|.bz2|.xz]}}`. + +### Help and version commands - We generally put, **in this order**, the help and version commands as the **last two** examples of the page to highlight more practical commands at the beginning of the page. They can be replaced to accommodate other useful examples if required. - For consistency, we prefer generic wording `Display help` and `Display version` for these commands. @@ -411,7 +472,7 @@ The below section contains additional language-specific rules for translating pa ### Chinese-Specific Rules -When Chinese words, Latin words and Arabic numerals are written in the same sentence, more attention must be paid to copywriting. +When Chinese words, Latin words, and Arabic numerals are written in the same sentence, more attention must be paid to copywriting. The following guidelines are applied to Chinese (`zh`) and traditional Chinese (`zh_TW`) pages: @@ -439,7 +500,7 @@ The following guidelines are applied to Chinese (`zh`) and traditional Chinese ( 6. Use precise form for technical terms, and do not use unofficial Chinese abbreviations. -- For example, use `Facebook` rather than `facebook`, `fb` or `脸书`. +- For example, use `Facebook` rather than `facebook`, `fb`, or `脸书`. To maintain readability and normalization, please comply with the 6 rules above as much as possible when translating pages into Chinese. @@ -500,7 +561,7 @@ Second, we recommend using the following forms of technical terms to make transl | Update | Perbarui | Do not confuse with `upgrade`. | | Upgrade | Tingkatkan | Do not confuse with `update`. | -When translating sentences that contain the word `boot` and `load` together, please add the context of the item that is being booted and/or loaded, so the use of the `muat` word may not be ambiguous. For example, when translating: +When translating sentences that contain the words `boot` and `load` together, please add the context of the item that is being booted and/or loaded, so the use of the `muat` word may not be ambiguous. For example, when translating: > Load configuration from a specific file after reboot @@ -523,12 +584,15 @@ To ensure that the sentence may not be confused with `start processing the web s ### French-Specific Rules -- Command and example descriptions on pages in French must use the third person singular present indicative tense (présent de l'indicatif à la troisième personne du singulier). For example, use `Extrait une archive` rather than `Extraire une archive` or `Extrais une archive`. -- There must be a single blank space between special characters in the descriptions. For example, use `Plus d'informations : https://example.com.` instead of `Plus d'informations: https://example.com.` and use `Crée une archive à partir de fichiers :` instead of `Crée une archive à partir de fichiers:`. +- Command and example descriptions on pages in French must use the third person singular present indicative tense (présent de l'indicatif à la troisième personne du singulier). +For example, use `Extrait une archive` rather than `Extraire une archive` or `Extrais une archive`. +- There must be a single blank space between special characters in the descriptions. +For example, use `Plus d'informations : https://example.com.` instead of `Plus d'informations: https://example.com.` and use `Crée une archive à partir de fichiers :` instead of `Crée une archive à partir de fichiers:`. ### Portuguese-Specific Rules -Example descriptions on pages in Portuguese (for both European and Brazilian Portuguese) must start with verbs in the third person singular present indicative tense. This is because the descriptions must explain what the commands do, making this the correct form to express the intended meaning. +Example descriptions on pages in Portuguese (for both European and Brazilian Portuguese) must start with verbs in the third person singular present indicative tense. +This is because the descriptions must explain what the commands do, making this the correct form to express the intended meaning. For example, use `Lista os arquivos` instead of `Listar os arquivos`, `Listando os arquivos` or any other form. @@ -543,3 +607,13 @@ For example, use `Lista os arquivos` instead of `Listar os arquivos`, `Listando ```md - Crea un archivo en un directorio: ``` + +- Preferably, use the word `identificador` instead of `id` in the placeholders of command examples. For example: + +```md +{{identificador_de_usuario}} +``` + +*Writing prepositions is optional* + + However, if the line of a command example exceeds the [maximum length](https://github.com/tldr-pages/tldr/blob/main/.markdownlint.json#L5), choose the word `identificador` or `id` and use it across all placeholders in the page. diff --git a/contributing-guides/style-guide.zh.md b/contributing-guides/style-guide.zh.md index 5273b0c87..39d801a43 100644 --- a/contributing-guides/style-guide.zh.md +++ b/contributing-guides/style-guide.zh.md @@ -6,22 +6,22 @@ ## 排版 -首先，你的页面应该看起来像这样： +首先，你的页面应该看起来像这样，并且最多只能包含 8 个示例： ```md # 命令名称 -> 短小精悍的描述。 +> 简短、精炼的描述。 > 描述最好只有一行；当然，如果需要，也可以是两行。 > 更多信息：. - 命令描述： -`命令 -选项1 -选项2 -参数1 {{参数的值}}` +`命令 -选项 1 -选项 2 -参数 1 {{参数的值}}` - 命令描述： -`命令 -选项1 -选项2` +`命令 -选项 1 -选项 2` ``` 当你将自己的贡献提交 pull request 时，一个脚本会自动检查你的贡献是否符合上面的格式。 @@ -38,43 +38,306 @@ tldr-lint {{page.md}} 如果你用 tldr-pages 的 Node.js 客户端，你可以在命令后加 `-f` (`--render`) 来在本地预览自己的页面： ```sh -tldr --render {{page.md}} +tldr --render path/to/tldr_page.md ``` -## 占位符（token）语法 +### PowerShell 特定规则 +在记录 PowerShell 命令时，请注意以下命名约定。 -当命令涉及用户自己提供的值时，请用 `{{token}}` 语法来使 `tldr` 客户端自动高亮它们： +- 文件名必须以小写形式书写，例如 `invoke-webrequest.md` 而不是 `Invoke-WebRequest.md`。 +- 页面标题/标题必须按照原样书写（与 Microsoft 或 PowerShell 模块作者意图一致），例如 `Invoke-WebRequest` 而不是 `invoke-webrequest`。 +- 示例中的命令名称和选项也应按原样书写，例如 `Command-Name {{input}} -CommandParameter {{value}}` 而不是 `command-name {{input}} -commandparameter {{value}}`。 -`tar -cf {{目标.tar}} {{文件1}} {{文件2}} {{文件3}}` +由于[各种兼容性差异](https://learn.microsoft.com/powershell/scripting/whats-new/differences-from-windows-powershell)和在 PowerShell 6.x 中删除的特定于 Windows 的命令，确保命令在 PowerShell 5.1（即安装在 Windows 10 和 11 中的“传统 Windows PowerShell”）和 最新版本的跨平台 PowerShell（以前称为 PowerShell Core）之间可用。如果命令或其选项在每个版本之间不可用或包含不同的行为，请在描述中注明。例如， + +```md +# Clear-RecycleBin + +> 清空回收站中的项目。 +> 此命令仅适用于 PowerShell 版本 5.1 及以下版本，或 7.1 及以上版本。 +> 更多信息： . +``` + +## 别名 +如果一个命令可以通过其他名称调用（例如 `vim` 可以通过 `vi` 调用），可以创建别名页面将用户引导到原始命令名称。 + +```md +# command_name + +> 此命令是 `original-command-name` 的别名。 +> 更多信息： . + +- 查看原始命令的文档： + +`tldr original_command_name` +``` + +示例： + +```md +# vi + +> 这是 `vim` 命令的一个别名。 + +- 原命令的文档在： + +`tldr vim` +``` + +预先翻译好的别名模板见[这里](https://github.com/tldr-pages/tldr/blob/main/contributing-guides/translation-templates/alias-pages.md)。 + +### PowerShell 特定别名 +某些 PowerShell 命令可能会引入别名，这些别名可以分为以下三类： + +1. 替代现有的 Windows 命令提示符 (`cmd`) 命令，例如 `cd` 别名为 `Set-Location`，但带有不同的命令选项。在这种情况下，将以下别名注释添加到原始命令提示符命令的 tldr 描述的第二行中，例如： + +```md +# cd + +> 显示当前工作目录或移动到其他目录。 +> 在 PowerShell 中，此命令是 `Set-Location` 的别名。本文档基于命令提示符 (`cmd`) 版本的 `cd`。 +> 更多信息： . + +- 原命令的文档在： + +`tldr set-location` +``` + +> [!TIP] +> “查看等效 PowerShell 命令的文档”的示例是可选的，如果页面已经具有 8 条示例，则可以省略。 + +2. 提供一个新的别名，但只能在 PowerShell 中执行，例如 `ni` 代表 `New-Item`。在这种情况下，使用[标准别名模板](https://github.com/tldr-pages/tldr/blob/main/contributing-guides/translation-templates/alias-pages.md)，但添加说明“在 PowerShell 中”，或表示该命令仅限于 PowerShell。例如， + +```md +# ni + +> 在 PowerShell 中，此命令是 `New-Item` 的别名。 +> 更多信息： . + +- 查看原始命令的文档： + +`tldr new-item` +``` + +3. 与其他程序冲突时 PowerShell 会提供一个新的别名，最为突出的是将 `curl` 和 `wget` 作为 `Invoke-WebRequest` 的别名（带有不兼容的命令选项集）。请注意，此类别的 PowerShell 系统别名通常仅限于 Windows。 + +在这种情况下，提供一个说明，并提供一种方法来确定命令当前是否引用了 PowerShell 命令（通过别名）或其他程序。例如， + +```md +# curl + +> 在 PowerShell 中，当原始的 `curl` 程序 () 未正确安装时，此命令可能是 `Invoke-WebRequest` 的别名。 +> 更多信息： . + +- 通过打印其版本号来检查 `curl` 是否已正确安装。如果此命令导致错误，则 PowerShell 可能已将此命令替换为 `Invoke-WebRequest`： + +`curl --version` + +- 查看原始 `curl` 命令的文档： + +`tldr curl -p common` + +- 查看 PowerShell 的 `Invoke-WebRequest` 命令的文档： + +`tldr invoke-webrequest` +``` + +## 选项语法 + +- 对于常用命令（例如 `grep`、`tar` 等），我们更推荐在占位符中使用简短选项以及[助记符](#short-option-mnemonics)。 +- 对于在命令中同时突出长选项和短选项（而不是使用助记符），将它们组合在占位符中，即 `{{-o|--output}}`。 +- 为了用户友好，在 `common` 目录下的页面中，当它们在跨平台（在多个平台上都可以正常工作）时，我们更推荐使用**GNU 风格的长选项**（例如 `--help` 而不是 `-h`)。 +- 在记录 PowerShell 命令时，使用**PowerShell 风格的长选项**（例如 `-Help` 而不是 `-H`）。 +- 我们更推荐使用空格而不是等号 (`=`) 来分隔选项和其参数（即使用 `--opt arg` 而不是 `--opt=arg`），除非程序不支持此方法。 + +### 短选项助记符 + +短选项助记符是可选的提示，可以添加以帮助用户理解这些短选项的含义。分配的助记符应与命令的官方文档（例如来自 `man` 或 `Get-Help`）中的内容相匹配。例如： + +```md +- [d]isplay the ins[t]allation [i]D for the current device. Useful for offline license activation: + +`slmgr.vbs /dti` + +Display the current license's e[xp]i[r]ation date and time: + +`slmgr.vbs /xpr` +``` + +请注意，在第一个示例中，`[d]`、`[t]` 和 `[i]` 字符被方括号括起来，以指示命令的 `/dti` 选项分别是 "display"、"installation" 和 "ID" 的组合。连续的助记符字符可以在同一方括号下进行分组，例如 `e[xp]i[r]ation` 而不是 `e[x][p]i[r]ation`。 + +**助记符字符必须以区分大小写的方式编写**，即使它放在句子的第一个字符位置（例如使用 `[d]isplay` 而不是 `[D]isplay`）。这是为了避免与 GNU 风格命令选项产生冲突，GNU 风格命令选项可能会以不同于小写的方式解释大写选项，例如 `-v` 用于显示命令的 `[v]ersion` 号码，而 `-V` 则用于以 `[V]erbose` 模式运行命令。 + +选项助记符也可以在翻译中使用，只要突出显示的单词与命令所用语言（通常为英语）中的单词具有相似的含义即可。例如，英语中的 `[d]ownload` 可以翻译为西班牙语中的 `[d]escargar`，英语中的 `[i]nstall` 可以翻译为德语中的 `[i]nstallieren`，而英语中的 `[a]pp` 可以翻译为印尼语和马来语中的 `[a]plikasi`。 + +可选地，在翻译和特定页面中，助记符及其包含的术语可以用括号与描述的其余部分分开（即 `([a]ll)`），以提供额外的上下文或提及描述中不存在的单词。 + +> [!NOTE] +> 在翻译的单词中如果缺少字符，您可以在等效词的前面或旁边突出显示选项，或您可以在括号内的翻译旁边添加英文单词。例如，英语中的 `E[x]tract` 可以翻译为印尼语中的 `[x] ekstrak` 或 `ekstrak [x]` 或 `ekstrak (E[x]tract)`。 + +## 占位符语法 + +当命令涉及用户自己提供的值时，请用 `{{token}}` 语法来使 `tldr` 客户端能自动高亮它们： + +`tar -cf {{目标.tar}} {{文件 1}} {{文件 2}} {{文件 3}}` 翻译时，请尽量翻译原文中的西文占位符。下面是命名占位符的规则： -1. 占位符需要短小精悍， +1. 占位符需要短小精悍， 例如 `{{源文件}}` 或者 `{{钱包.txt}}` 2. 如果占位符是西文，请用 [`snake_case`](https://en.wikipedia.org/wiki/Snake_case) 来分词。 -3. 当占位符涉及文件路径时，请用 `{{目录/子目录/<占位符>}}` 的格式。 - 例如：`ln -s {{目录/子目录/源文件}} {{目录/子目录/链接}}` +3. 当占位符涉及文件路径时，请用 `{{目录/子目录/《占位符》}}` 的格式。 + 例如：`ln -s {{目录/子目录/源文件}} {{目录/子目录/链接}}` 如果占位符提到的文件也可能是目录，请用 `{{目录/子目录/文件或目录}}` -4. 除非文件是特定的，上述 `{{目录/子目录/<占位符>}}` 的文件路径格式应用于所有包含路径的命令。 -5. 如果命令需要的文件扩展名是固定的，请在占位符里加上文件格式。 - 例如：`unrar x {{压缩包.rar}}` - 如果文件 **必须** 有一个扩展名，请用 `{{.ext}}` 。 - 例如，在 `find {{起始目录}} -name '{{*.ext}}'` 的例子里， - 这样做简单地演示了查找一个特定文件扩展名的方法。 +4. 除非文件是特定的，上述 `{{目录/子目录/《占位符》}}` 的文件路径格式应用于所有包含路径的命令。 +5. 如果命令需要的文件扩展名是固定的，请在占位符里加上文件格式。 + 例如：`unrar x {{压缩包.rar}}` + 如果文件 **必须** 有一个扩展名，请用 `{{.ext}}` 。 + 例如，在 `find {{起始目录}} -name '{{*.ext}}'` 的例子里， + 这样做简单地演示了查找一个特定文件扩展名的方法。 但是，在 `wc -l {{file}}` 的例子里，用不加扩展名的 `{{file}}` 就足够了。 -6. 如果用实际的值比描述这个占位符更加明了，请举一个值做例子。 +6. 如果用实际的值比描述这个占位符更加明了，请举一个值做例子。 例如：`iostat {{2}}` 比 `iostat {{以秒为单位的间隔}}` 更清晰。 -7. 如果一个命令可能对文件系统或设备造成不可逆的影响，请在示例命令中注意改写，使其不能被盲目复制粘贴运行。 - 例如，`ddrescue --force --no-scrape /dev/sda /dev/sdb` 被盲目复制粘贴时可能对系统造成毁灭性的打击；`ddrescue --force --no-scrape {{/dev/sdX}} {{/dev/sdY}}` 则更安全。 +7. 如果一个命令可能对文件系统或设备造成不可逆的影响，请在示例命令中注意改写，使其不能被盲目复制粘贴运行。 + 例如，`ddrescue --force --no-scrape /dev/sda /dev/sdb` 被盲目复制粘贴时可能对系统造成毁灭性的打击；`ddrescue --force --no-scrape {{/dev/sdX}} {{/dev/sdY}}` 则更安全。 因此，请用 `{{/dev/sdXY}}` 而不是 `{{/dev/sda1}}` 来表示一个 **块设备** 。 占位符应该尽可能简单明了，让人一眼就能看出应该替换它的值。 +### 路径 + +- 当只期望文件名时，请使用 `{{filename}}`。 +- 对于文件或目录路径的任何引用，请使用格式 `{{path/to/}}`，除非位置是隐含的。 +- 当路径不能是相对路径，而必须从文件系统的根目录开始时，请使用斜杠作为前缀，例如 `get {{/path/to/remote_file}}`。 +- 如果可能引用文件或目录，请使用 `{{path/to/file_or_directory}}`。 + +> [!NOTE] +> 如果命令专用于 Windows，请使用反斜杠（`\`），例如 `{{path\to\file_or_directory}}`。驱动器号（如 `C:`）是可选的，除非命令输入要求绝对路径或特定的驱动器号范围，例如 `cd /d {{C}}:{{path\to\directory}}`。 + +### 扩展名 + +- 如果文件有特定的扩展名，请写出来。 + 例如，`unrar x {{path/to/compressed.rar}}`。 +- 如果需要通用的扩展名，请使用 `{{.ext}}`，但**只有**在需要扩展名时才使用。 + 例如，在 `find.md` 的示例“按扩展名查找文件”中（`find {{path/to/root}} -name '{{*.ext}}'`）， + 使用 `{{*.ext}}` 可以解释命令而不必过于具体； + 而在 `wc -l {{path/to/file}}` 中，使用 `{{path/to/file}}`（不带扩展名）就足够了。 + +### 分组占位符 + +- 如果命令可以接受相同类型的 0 个或多个参数，请使用省略号：`{{placeholder1 placeholder2 ...}}`。 + 例如，期望多个路径，则可以使用 `{{path/to/directory1 path/to/directory2 ...}}`。 +- 如果命令可以接受不同类型的 0 个或多个参数，请使用竖线和省略号：`{{placeholder1|placeholder2|...}}`。 + 如果可能值超过 5 个，则可以在最后一项后面使用 `|...`。 +- 无法通过省略号限制占位符的最小或最大数量。 + +### 特殊情况 + +- 如果一个命令可能对文件系统或设备进行不可逆转的更改， + 请以一种不会被轻易复制粘贴的方式编写每个示例。 + 例如，不要写成 `ddrescue --force --no-scrape /dev/sda /dev/sdb`， + 而是写成 `ddrescue --force --no-scrape {{/dev/sdX}} {{/dev/sdY}}`， + 并且对于*块设备*，使用 `{{/dev/sdXY}}` 占位符，而不是 `/dev/sda1`。 + +通常情况下，占位符应尽可能直观，以便于理解如何使用命令并填入相应的值。 + 在命令描述中，如果出现了技术性的专有名词，请用 `反引号` 括起来： -1. 路径，例如 `package.json`，`/etc/package.json`. -2. 扩展名，例如 `.dll`. -3. 命令，例如 `ls`. +- 路径，例如 `package.json`，`/etc/package.json`。 +- 扩展名，例如 `.dll`。 +- 命令，例如 `ls`。 +- 标准流：`stdout`，`stdin`，`stderr`。**不要**使用完整的名称（例如标准输出）。 +- 压缩算法，例如 `zip`，`7z`，`xz`。 + +## 描述 + +### 祈使句 + +- **所有描述必须以祈使句表达。** + +如果你担心命令在不同平台或操作系统之间可能不同（例如 Windows 对比 macOS），大多数 [tldr 页面客户端](https://github.com/tldr-pages/tldr/wiki/tldr-pages-clients) 将选择最适合的命令版本。 + +在这种情况下，默认将显示 Windows 版本的 `cd` 信息（存储在 `pages/windows/cd.md` 中）给 Windows 用户，并为 Linux、macOS 和其他平台显示一个通用版本（存储在 `pages/common/cd.md` 中）。 + +在为命令示例编写描述时，**检查任何语法错误**。例如，应该使用 `前往指定目录` 而不是： + +- `正前往指定目录`（不应使用现在分词形式） +- `该命令将前往指定目录`（很明显此示例适用于 *此* 命令） +- `让我们前往指定目录！` +- `目录被更改为`（如果可能，应使用主动形式而不是被动形式） + +例如，可以使用 `列出所有文件：` 的描述，下面是示例的描述可以使用 `列出所有文件：`。 + +```md +- 列出所有文件： + +`ls` +``` + +### 措辞 + +- 所有描述**必须简洁**。 +- 避免在描述中使用页面标题（例如，使用 `为数字艺术家设计的素描和绘画程序`，而不是 `Krita 是为数字艺术家设计的素描和绘画程序`），除非程序名称与可执行文件名称不同（例如 `rg` 和 Ripgrep）。 +- 避免提及程序是在命令行上使用的（例如，使用 `Ripgrep 是一个递归的面向行的搜索工具`，而不是 `Ripgrep 是一个递归的面向行的 CLI 搜索工具`）。 +- 例如，在为 `cd` 编写文档时，一个用于在终端或命令提示符中更改当前工作目录的工具，**不要**写出像这样冗长的描述： + +```md +> `cd` 是一个系统工具，在 Windows、macOS 和 Linux 中可用，用于在命令提示符、终端和 PowerShell 中更改当前工作目录以完成任务。 +``` + +它应该简化以使每个人都能更轻松地阅读： + +```md +> 更改当前工作目录。 +``` + +### 格式 + +- 在描述中，应该对专有名词进行大写（例如，使用 `用于与 Git 仓库交互的工具。`，而不是 ``用于与 `git` 仓库交互的工具。``）。 +- 首字母缩写（即协议、工具等）在没有本地同类物时不应进行翻译。 +- 当编写包含键盘按键或键盘快捷键时，建议将它们用反引号括起来，以突出显示在描述中（即 ``打印给定文件的最后几行，并一直读取直到按下 `Ctrl + C`：``）。 或者，您可以将它们记录为单独的命令，然后选择性地将它们突出显示为占位符（即 `:wq{{Enter}}` 或 `:wq` 或 `:wq(Enter)`）。 + +## 斜体和粗体 + +请不要在页面上使用 *斜体*、**粗体** 或任何其他文本样式。这些样式被用于客户端对占位符的修饰。 + +## 更多信息链接 + +- 在`更多信息`链接行上，我们更推荐链接到作者提供的命令行参考文档或 man 手册。如果没有提供，请使用 作为所有系统（除 `osx` 和除了 FreeBSD 之外的 BSD 平台）的默认链接。或者，如果命令没有文档页面，您也可以链接到作者的网站或教程页面。 + +- 对于 `osx`：苹果在 Xcode 中分发内置的 man 手册 [在这里](https://developer.apple.com/documentation/os/reading_unix_manual_pages)。对于那里记录的命令，我们建议使用 https://keith.github.io/xcode-man-pages/, 这是 Xcode 捆绑的所有苹果 man 手册的 HTML。 + +- **所有链接必须放在尖括号（`<` 和 `>`）中，以便在客户端中正确呈现。** + +- 我们更倾向于在翻译页面中直接使用英文页面的更多信息链接。 + +### 版本化链接 + +当一个应用程序或发行版的包具有版本化链接时，我们更倾向于链接到文档的最新版本（即 `latest`），或者如果网站自动重定向到文档的最新版本，则不用链接到任何版本。 + +例如，使用： + +- 而不是 。 +- 而不是 。 + +### Microsoft Learn 链接 + +当链接到 Microsoft Learn 页面时，请删除地址中的语言环境，因为网站会自动重定向到读者的首选语言环境。例如，使用 而不是 。 + +此外，如果链接与 PowerShell 命令文档相关，请删除**文档版本指示符**（即文档来源的 PowerShell/module 版本），即地址中以 `?view=` 开头的部分。 + +- 使用 而不是 。 +- 使用 而不是 。 + +## 帮助和版本命令 + +- 通常我们将帮助命令和版本命令**按照这个顺序**放在页面的**最后两个**示例中，以突出页面开头更实用的命令。如果需要，它们可以被替换为其他有用的示例。 +- 为了保持一致性，我们更推荐使用通用的术语 `显示帮助` 和 `显示版本` 来描述这些命令。 +- 如果命令在 Windows 等平台中使用了不同的标志，建议记录下帮助和版本示例。 + +## 特定语言规则 + +以下部分包含了用于翻译页面的额外的特定语言规则： ## 中西文混排规则 @@ -82,19 +345,19 @@ tldr --render {{page.md}} 以下规则适用于中文（zh）和繁体中文（zh_TW）： -1. 在西文单词和数字前后放置一个空格。 - 例如：`列出所有 docker 容器` 而不是 `列出所有docker容器`。 - 例如：`宽度为 50 个字` 而不是 `宽度为50个字`。 -2. 除了度数和百分比，在数字和单位之间留一个空格。 - 例如：`容量 50 MB` 而不是 `容量 50MB`。 +1. 在西文单词和数字前后放置一个空格。 + 例如：`列出所有 docker 容器` 而不是 `列出所有 docker 容器`。 + 例如：`宽度为 50 个字` 而不是 `宽度为 50 个字`。 +2. 除了度数和百分比，在数字和单位之间留一个空格。 + 例如：`容量 50 MB` 而不是 `容量 50MB`。 对于度数和百分比：使用 `50°C` 和 `50%` 而不是 `50 °C` 和 `50 %`. -3. 不要在全角标点符号前后放置空格。 +3. 不要在全角标点符号前后放置空格。 例如：`开启 shell，进入交互模式` 而不是 `开启 shell ，进入交互模式`。 -4. 除了西文长句，一律使用全角标点符号。 - 例如：`嗨，你好。` 而不是 `嗨, 你好.`。 -5. 当最句子最后一个字符是半角时，使用半角标点符号来结束句子。 +4. 除了西文长句，一律使用全角标点符号。 + 例如：`嗨，你好。` 而不是 `嗨，你好.`。 +5. 当最句子最后一个字符是半角时，使用半角标点符号来结束句子。 例如：`将代码转化为 Python 3.` 而不是 `将代码转化为 Python 3。`。 -6. 使用精准的专有名词，不要使用非官方的中文缩写。 +6. 使用精准的专有名词，不要使用非官方的中文缩写。 例如：`Facebook` 而非 `facebook`、`fb` 或 `脸书`。 为保持可读性和一致性，将页面翻译成中文时，请尽可能遵守以上 6 条规则。 diff --git a/package-lock.json b/package-lock.json index 57807c8e5..1f7169053 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,15 +1,15 @@ { "name": "tldr-pages", - "lockfileVersion": 2, + "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "tldr-pages", "license": "SEE LICENSE IN LICENSE.md", "dependencies": { - "glob": "10.3.10", - "markdownlint-cli": "^0.39.0", - "tldr-lint": "^0.0.13" + "glob": "10.4.1", + "markdownlint-cli": "^0.41.0", + "tldr-lint": "^0.0.15" }, "devDependencies": { "husky": "^9.0.11" @@ -97,11 +97,11 @@ "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==" }, "node_modules/commander": { - "version": "11.1.0", - "resolved": "https://registry.npmjs.org/commander/-/commander-11.1.0.tgz", - "integrity": "sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ==", + "version": "12.1.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-12.1.0.tgz", + "integrity": "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA==", "engines": { - "node": ">=16" + "node": ">=18" } }, "node_modules/cross-spawn": { @@ -173,21 +173,21 @@ } }, "node_modules/glob": { - "version": "10.3.10", - "resolved": "https://registry.npmjs.org/glob/-/glob-10.3.10.tgz", - "integrity": "sha512-fa46+tv1Ak0UPK1TOy/pZrIybNNt4HCv7SDzwyfiOZkvZLEbjsZkJBPtDHVshZjbecAoAGSC20MjLDG/qr679g==", + "version": "10.4.1", + "resolved": "https://registry.npmjs.org/glob/-/glob-10.4.1.tgz", + "integrity": "sha512-2jelhlq3E4ho74ZyVLN03oKdAZVUa6UDZzFLVH1H7dnoax+y9qyaq8zBkfDIggjniU19z0wU18y16jMB2eyVIw==", "dependencies": { "foreground-child": "^3.1.0", - "jackspeak": "^2.3.5", - "minimatch": "^9.0.1", - "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0", - "path-scurry": "^1.10.1" + "jackspeak": "^3.1.2", + "minimatch": "^9.0.4", + "minipass": "^7.1.2", + "path-scurry": "^1.11.1" }, "bin": { "glob": "dist/esm/bin.mjs" }, "engines": { - "node": ">=16 || 14 >=14.17" + "node": ">=16 || 14 >=14.18" }, "funding": { "url": "https://github.com/sponsors/isaacs" @@ -209,17 +209,17 @@ } }, "node_modules/ignore": { - "version": "5.3.0", - "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.0.tgz", - "integrity": "sha512-g7dmpshy+gD7mh88OC9NwSGTKoc3kyLAZQRU1mt53Aw/vnvfXnbC+F/7F7QoYVKbV+KNvJx8wArewKy1vXMtlg==", + "version": "5.3.1", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.1.tgz", + "integrity": "sha512-5Fytz/IraMjqpwfd34ke28PTVMjZjJG2MPn5t7OE4eUCUNf8BAa7b5WUS9/Qvr6mwOQS7Mk6vdsMno5he+T8Xw==", "engines": { "node": ">= 4" } }, "node_modules/ini": { - "version": "4.1.1", - "resolved": "https://registry.npmjs.org/ini/-/ini-4.1.1.tgz", - "integrity": "sha512-QQnnxNyfvmHFIsj7gkPcYymR8Jdw/o7mp5ZFihxn6h8Ci6fh3Dx4E1gPjpQEpIuPo9XVNY/ZUwh4BPMjGyL01g==", + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/ini/-/ini-4.1.2.tgz", + "integrity": "sha512-AMB1mvwR1pyBFY/nSevUX6y8nJWS63/SzUKD3JyQn97s4xgIdgQPT75IRouIiBAN4yLQBUShNYVW0+UG25daCw==", "engines": { "node": "^14.17.0 || ^16.13.0 || >=18.0.0" } @@ -238,9 +238,9 @@ "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==" }, "node_modules/jackspeak": { - "version": "2.3.6", - "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-2.3.6.tgz", - "integrity": "sha512-N3yCS/NegsOBokc8GAdM8UcmfsKiSS8cipheD/nivzr700H+nsMOxJjQnvwOcRYVuFkdH0wGUvW2WbXGmrZGbQ==", + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-3.1.2.tgz", + "integrity": "sha512-kWmLKn2tRtfYMF/BakihVVRzBKOxz4gJMiL2Rj91WnAB5TPZumSH99R/Yf1qE1u4uRimvCSJfm6hnxohXeEXjQ==", "dependencies": { "@isaacs/cliui": "^8.0.2" }, @@ -270,6 +270,14 @@ "resolved": "https://registry.npmjs.org/jsonc-parser/-/jsonc-parser-3.2.1.tgz", "integrity": "sha512-AilxAyFOAcK5wA1+LeaySVBrHsGQvUFCDWXKpZjzaL0PqW+xfBOttn8GNtWKFWqneyMZj41MWF9Kl6iPWLwgOA==" }, + "node_modules/jsonpointer": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/jsonpointer/-/jsonpointer-5.0.1.tgz", + "integrity": "sha512-p/nXbhSEcu3pZRdkW1OfJhpsVtW1gd4Wa1fnQc9YLiTfAjn0312eMKimbdIQzuZl9aa9xUGaRlP9T/CJE/ditQ==", + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/linkify-it": { "version": "5.0.0", "resolved": "https://registry.npmjs.org/linkify-it/-/linkify-it-5.0.0.tgz", @@ -279,36 +287,36 @@ } }, "node_modules/lru-cache": { - "version": "10.0.0", - "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.0.0.tgz", - "integrity": "sha512-svTf/fzsKHffP42sujkO/Rjs37BCIsQVRCeNYIm9WN8rgT7ffoUnRtZCqU+6BqcSBdv8gwJeTz8knJpgACeQMw==", + "version": "10.2.0", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.2.0.tgz", + "integrity": "sha512-2bIM8x+VAf6JT4bKAljS1qUWgMsqZRPGJS6FSahIMPVvctcNhyVp7AJu7quxOW9jwkryBReKZY5tY5JYv2n/7Q==", "engines": { "node": "14 || >=16.14" } }, "node_modules/markdown-it": { - "version": "14.0.0", - "resolved": "https://registry.npmjs.org/markdown-it/-/markdown-it-14.0.0.tgz", - "integrity": "sha512-seFjF0FIcPt4P9U39Bq1JYblX0KZCjDLFFQPHpL5AzHpqPEKtosxmdq/LTVZnjfH7tjt9BxStm+wXcDBNuYmzw==", + "version": "14.1.0", + "resolved": "https://registry.npmjs.org/markdown-it/-/markdown-it-14.1.0.tgz", + "integrity": "sha512-a54IwgWPaeBCAAsv13YgmALOF1elABB08FxO9i+r4VFk5Vl4pKokRPeX8u5TCgSsPi6ec1otfLjdOpVcgbpshg==", "dependencies": { "argparse": "^2.0.1", "entities": "^4.4.0", "linkify-it": "^5.0.0", "mdurl": "^2.0.0", "punycode.js": "^2.3.1", - "uc.micro": "^2.0.0" + "uc.micro": "^2.1.0" }, "bin": { "markdown-it": "bin/markdown-it.mjs" } }, "node_modules/markdownlint": { - "version": "0.33.0", - "resolved": "https://registry.npmjs.org/markdownlint/-/markdownlint-0.33.0.tgz", - "integrity": "sha512-4lbtT14A3m0LPX1WS/3d1m7Blg+ZwiLq36WvjQqFGsX3Gik99NV+VXp/PW3n+Q62xyPdbvGOCfjPqjW+/SKMig==", + "version": "0.34.0", + "resolved": "https://registry.npmjs.org/markdownlint/-/markdownlint-0.34.0.tgz", + "integrity": "sha512-qwGyuyKwjkEMOJ10XN6OTKNOVYvOIi35RNvDLNxTof5s8UmyGHlCdpngRHoRGNvQVGuxO3BJ7uNSgdeX166WXw==", "dependencies": { - "markdown-it": "14.0.0", - "markdownlint-micromark": "0.1.8" + "markdown-it": "14.1.0", + "markdownlint-micromark": "0.1.9" }, "engines": { "node": ">=18" @@ -318,19 +326,21 @@ } }, "node_modules/markdownlint-cli": { - "version": "0.39.0", - "resolved": "https://registry.npmjs.org/markdownlint-cli/-/markdownlint-cli-0.39.0.tgz", - "integrity": "sha512-ZuFN7Xpsbn1Nbp0YYkeLOfXOMOfLQBik2lKRy8pVI/llmKQ2uW7x+8k5OMgF6o7XCsTDSYC/OOmeJ+3qplvnJQ==", + "version": "0.41.0", + "resolved": "https://registry.npmjs.org/markdownlint-cli/-/markdownlint-cli-0.41.0.tgz", + "integrity": "sha512-kp29tKrMKdn+xonfefjp3a/MsNzAd9c5ke0ydMEI9PR98bOjzglYN4nfMSaIs69msUf1DNkgevAIAPtK2SeX0Q==", "dependencies": { - "commander": "~11.1.0", + "commander": "~12.1.0", "get-stdin": "~9.0.0", - "glob": "~10.3.10", - "ignore": "~5.3.0", + "glob": "~10.4.1", + "ignore": "~5.3.1", "js-yaml": "^4.1.0", "jsonc-parser": "~3.2.1", - "markdownlint": "~0.33.0", - "minimatch": "~9.0.3", - "run-con": "~1.3.2" + "jsonpointer": "5.0.1", + "markdownlint": "~0.34.0", + "minimatch": "~9.0.4", + "run-con": "~1.3.2", + "smol-toml": "~1.2.0" }, "bin": { "markdownlint": "markdownlint.js" @@ -340,11 +350,11 @@ } }, "node_modules/markdownlint-micromark": { - "version": "0.1.8", - "resolved": "https://registry.npmjs.org/markdownlint-micromark/-/markdownlint-micromark-0.1.8.tgz", - "integrity": "sha512-1ouYkMRo9/6gou9gObuMDnvZM8jC/ly3QCFQyoSPCS2XV1ZClU0xpKbL1Ar3bWWRT1RnBZkWUEiNKrI2CwiBQA==", + "version": "0.1.9", + "resolved": "https://registry.npmjs.org/markdownlint-micromark/-/markdownlint-micromark-0.1.9.tgz", + "integrity": "sha512-5hVs/DzAFa8XqYosbEAEg6ok6MF2smDj89ztn9pKkCtdKHVdPQuGMH7frFfYL9mLkvfFe4pTyAMffLbjf3/EyA==", "engines": { - "node": ">=16" + "node": ">=18" }, "funding": { "url": "https://github.com/sponsors/DavidAnson" @@ -356,9 +366,9 @@ "integrity": "sha512-Lf+9+2r+Tdp5wXDXC4PcIBjTDtq4UKjCPMQhKIuzpJNW0b96kVqSwW0bT7FhRSfmAiFYgP+SCRvdrDozfh0U5w==" }, "node_modules/minimatch": { - "version": "9.0.3", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.3.tgz", - "integrity": "sha512-RHiac9mvaRw0x3AYRgDC1CxAP7HTcNrrECeA8YYJeWnpo+2Q5CegtZjaotWTWxDG3UeGA1coE05iH1mPjT/2mg==", + "version": "9.0.4", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.4.tgz", + "integrity": "sha512-KqWh+VchfxcMNRAJjj2tnsSJdNbHsVgnkBhTNrW7AjVo6OvLtxw8zfT9oLw1JSohlFzJ8jCoTgaoXvJ+kHt6fw==", "dependencies": { "brace-expansion": "^2.0.1" }, @@ -378,9 +388,9 @@ } }, "node_modules/minipass": { - "version": "6.0.2", - "resolved": "https://registry.npmjs.org/minipass/-/minipass-6.0.2.tgz", - "integrity": "sha512-MzWSV5nYVT7mVyWCwn2o7JH13w2TBRmmSqSRCKzTw+lmft9X4z+3wjvs06Tzijo5z4W/kahUCDpRXTF+ZrmF/w==", + "version": "7.1.2", + "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.2.tgz", + "integrity": "sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==", "engines": { "node": ">=16 || 14 >=14.17" } @@ -394,15 +404,15 @@ } }, "node_modules/path-scurry": { - "version": "1.10.1", - "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-1.10.1.tgz", - "integrity": "sha512-MkhCqzzBEpPvxxQ71Md0b1Kk51W01lrYvlMzSUaIzNsODdd7mqhiimSZlr+VegAz5Z6Vzt9Xg2ttE//XBhH3EQ==", + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-1.11.1.tgz", + "integrity": "sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==", "dependencies": { - "lru-cache": "^9.1.1 || ^10.0.0", + "lru-cache": "^10.2.0", "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0" }, "engines": { - "node": ">=16 || 14 >=14.17" + "node": ">=16 || 14 >=14.18" }, "funding": { "url": "https://github.com/sponsors/isaacs" @@ -450,9 +460,9 @@ } }, "node_modules/signal-exit": { - "version": "4.0.2", - "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.0.2.tgz", - "integrity": "sha512-MY2/qGx4enyjprQnFaZsHib3Yadh3IXyV2C321GY0pjGfVBu4un0uDJkwgdxqO+Rdx8JMT8IfJIRwbYVz3Ob3Q==", + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz", + "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==", "engines": { "node": ">=14" }, @@ -460,6 +470,15 @@ "url": "https://github.com/sponsors/isaacs" } }, + "node_modules/smol-toml": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.2.0.tgz", + "integrity": "sha512-KObxdQANC/xje3OoatMbSwQf2XAvJ0RbK+4nmQRszFNZptbNRnMWqbLF/zb4sMi9xJ6HNyhWXeuZ9zC/I/XY7w==", + "engines": { + "node": ">= 18", + "pnpm": ">= 9" + } + }, "node_modules/string-width": { "version": "5.1.2", "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz", @@ -560,29 +579,28 @@ } }, "node_modules/tldr-lint": { - "version": "0.0.13", - "resolved": "https://registry.npmjs.org/tldr-lint/-/tldr-lint-0.0.13.tgz", - "integrity": "sha512-xPIg5465dypL4szZpUmQMenFF8uMnI0Fq6h2CADMso47w8xe5zZVrn7TSocd3I5mZxJDqxNoGG82g1Kzvz1wdA==", + "version": "0.0.15", + "resolved": "https://registry.npmjs.org/tldr-lint/-/tldr-lint-0.0.15.tgz", + "integrity": "sha512-LjKXuoU3tax0NTfNVxyACueTxEDrzBJf7n4dveRSRCCdnQH69PdfamwLaAqBsgpgSRNK+QopWXkLZhmq1smPNA==", "dependencies": { - "commander": "^8.1.0" + "commander": "^12.0.0" }, "bin": { "tldr-lint": "lib/tldr-lint-cli.js", "tldrl": "lib/tldr-lint-cli.js" - } - }, - "node_modules/tldr-lint/node_modules/commander": { - "version": "8.3.0", - "resolved": "https://registry.npmjs.org/commander/-/commander-8.3.0.tgz", - "integrity": "sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww==", + }, "engines": { - "node": ">= 12" + "node": ">=18" + }, + "funding": { + "type": "liberapay", + "url": "https://liberapay.com/tldr-pages" } }, "node_modules/uc.micro": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/uc.micro/-/uc.micro-2.0.0.tgz", - "integrity": "sha512-DffL94LsNOccVn4hyfRe5rdKa273swqeA5DJpMOeFmEn1wCDc7nAbbB0gXlgBCL7TNzeTv6G7XVWzan7iJtfig==" + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/uc.micro/-/uc.micro-2.1.0.tgz", + "integrity": "sha512-ARDJmphmdvUk6Glw7y9DQ2bFkKBHwQHLi2lsaH6PPmz/Ka9sFOBsBluozhDltWmnv9u/cF6Rt87znRTPV+yp/A==" }, "node_modules/which": { "version": "2.0.2", @@ -682,457 +700,5 @@ "node": ">=8" } } - }, - "dependencies": { - "@isaacs/cliui": { - "version": "8.0.2", - "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz", - "integrity": "sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==", - "requires": { - "string-width": "^5.1.2", - "string-width-cjs": "npm:string-width@^4.2.0", - "strip-ansi": "^7.0.1", - "strip-ansi-cjs": "npm:strip-ansi@^6.0.1", - "wrap-ansi": "^8.1.0", - "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0" - } - }, - "@pkgjs/parseargs": { - "version": "0.11.0", - "resolved": "https://registry.npmjs.org/@pkgjs/parseargs/-/parseargs-0.11.0.tgz", - "integrity": "sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==", - "optional": true - }, - "ansi-regex": { - "version": "6.0.1", - "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.0.1.tgz", - "integrity": "sha512-n5M855fKb2SsfMIiFFoVrABHJC8QtHwVx+mHWP3QcEqBHYienj5dHSgjbxtC0WEZXYt4wcD6zrQElDPhFuZgfA==" - }, - "ansi-styles": { - "version": "6.2.1", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.1.tgz", - "integrity": "sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==" - }, - "argparse": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", - "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==" - }, - "balanced-match": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", - "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==" - }, - "brace-expansion": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz", - "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==", - "requires": { - "balanced-match": "^1.0.0" - } - }, - "color-convert": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", - "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", - "requires": { - "color-name": "~1.1.4" - } - }, - "color-name": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", - "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==" - }, - "commander": { - "version": "11.1.0", - "resolved": "https://registry.npmjs.org/commander/-/commander-11.1.0.tgz", - "integrity": "sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ==" - }, - "cross-spawn": { - "version": "7.0.3", - "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.3.tgz", - "integrity": "sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w==", - "requires": { - "path-key": "^3.1.0", - "shebang-command": "^2.0.0", - "which": "^2.0.1" - } - }, - "deep-extend": { - "version": "0.6.0", - "resolved": "https://registry.npmjs.org/deep-extend/-/deep-extend-0.6.0.tgz", - "integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==" - }, - "eastasianwidth": { - "version": "0.2.0", - "resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz", - "integrity": "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==" - }, - "emoji-regex": { - "version": "9.2.2", - "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz", - "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==" - }, - "entities": { - "version": "4.5.0", - "resolved": "https://registry.npmjs.org/entities/-/entities-4.5.0.tgz", - "integrity": "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==" - }, - "foreground-child": { - "version": "3.1.1", - "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.1.1.tgz", - "integrity": "sha512-TMKDUnIte6bfb5nWv7V/caI169OHgvwjb7V4WkeUvbQQdjr5rWKqHFiKWb/fcOwB+CzBT+qbWjvj+DVwRskpIg==", - "requires": { - "cross-spawn": "^7.0.0", - "signal-exit": "^4.0.1" - } - }, - "get-stdin": { - "version": "9.0.0", - "resolved": "https://registry.npmjs.org/get-stdin/-/get-stdin-9.0.0.tgz", - "integrity": "sha512-dVKBjfWisLAicarI2Sf+JuBE/DghV4UzNAVe9yhEJuzeREd3JhOTE9cUaJTeSa77fsbQUK3pcOpJfM59+VKZaA==" - }, - "glob": { - "version": "10.3.10", - "resolved": "https://registry.npmjs.org/glob/-/glob-10.3.10.tgz", - "integrity": "sha512-fa46+tv1Ak0UPK1TOy/pZrIybNNt4HCv7SDzwyfiOZkvZLEbjsZkJBPtDHVshZjbecAoAGSC20MjLDG/qr679g==", - "requires": { - "foreground-child": "^3.1.0", - "jackspeak": "^2.3.5", - "minimatch": "^9.0.1", - "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0", - "path-scurry": "^1.10.1" - } - }, - "husky": { - "version": "9.0.11", - "resolved": "https://registry.npmjs.org/husky/-/husky-9.0.11.tgz", - "integrity": "sha512-AB6lFlbwwyIqMdHYhwPe+kjOC3Oc5P3nThEoW/AaO2BX3vJDjWPFxYLxokUZOo6RNX20He3AaT8sESs9NJcmEw==", - "dev": true - }, - "ignore": { - "version": "5.3.0", - "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.0.tgz", - "integrity": "sha512-g7dmpshy+gD7mh88OC9NwSGTKoc3kyLAZQRU1mt53Aw/vnvfXnbC+F/7F7QoYVKbV+KNvJx8wArewKy1vXMtlg==" - }, - "ini": { - "version": "4.1.1", - "resolved": "https://registry.npmjs.org/ini/-/ini-4.1.1.tgz", - "integrity": "sha512-QQnnxNyfvmHFIsj7gkPcYymR8Jdw/o7mp5ZFihxn6h8Ci6fh3Dx4E1gPjpQEpIuPo9XVNY/ZUwh4BPMjGyL01g==" - }, - "is-fullwidth-code-point": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", - "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==" - }, - "isexe": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", - "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==" - }, - "jackspeak": { - "version": "2.3.6", - "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-2.3.6.tgz", - "integrity": "sha512-N3yCS/NegsOBokc8GAdM8UcmfsKiSS8cipheD/nivzr700H+nsMOxJjQnvwOcRYVuFkdH0wGUvW2WbXGmrZGbQ==", - "requires": { - "@isaacs/cliui": "^8.0.2", - "@pkgjs/parseargs": "^0.11.0" - } - }, - "js-yaml": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", - "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==", - "requires": { - "argparse": "^2.0.1" - } - }, - "jsonc-parser": { - "version": "3.2.1", - "resolved": "https://registry.npmjs.org/jsonc-parser/-/jsonc-parser-3.2.1.tgz", - "integrity": "sha512-AilxAyFOAcK5wA1+LeaySVBrHsGQvUFCDWXKpZjzaL0PqW+xfBOttn8GNtWKFWqneyMZj41MWF9Kl6iPWLwgOA==" - }, - "linkify-it": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/linkify-it/-/linkify-it-5.0.0.tgz", - "integrity": "sha512-5aHCbzQRADcdP+ATqnDuhhJ/MRIqDkZX5pyjFHRRysS8vZ5AbqGEoFIb6pYHPZ+L/OC2Lc+xT8uHVVR5CAK/wQ==", - "requires": { - "uc.micro": "^2.0.0" - } - }, - "lru-cache": { - "version": "10.0.0", - "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.0.0.tgz", - "integrity": "sha512-svTf/fzsKHffP42sujkO/Rjs37BCIsQVRCeNYIm9WN8rgT7ffoUnRtZCqU+6BqcSBdv8gwJeTz8knJpgACeQMw==" - }, - "markdown-it": { - "version": "14.0.0", - "resolved": "https://registry.npmjs.org/markdown-it/-/markdown-it-14.0.0.tgz", - "integrity": "sha512-seFjF0FIcPt4P9U39Bq1JYblX0KZCjDLFFQPHpL5AzHpqPEKtosxmdq/LTVZnjfH7tjt9BxStm+wXcDBNuYmzw==", - "requires": { - "argparse": "^2.0.1", - "entities": "^4.4.0", - "linkify-it": "^5.0.0", - "mdurl": "^2.0.0", - "punycode.js": "^2.3.1", - "uc.micro": "^2.0.0" - } - }, - "markdownlint": { - "version": "0.33.0", - "resolved": "https://registry.npmjs.org/markdownlint/-/markdownlint-0.33.0.tgz", - "integrity": "sha512-4lbtT14A3m0LPX1WS/3d1m7Blg+ZwiLq36WvjQqFGsX3Gik99NV+VXp/PW3n+Q62xyPdbvGOCfjPqjW+/SKMig==", - "requires": { - "markdown-it": "14.0.0", - "markdownlint-micromark": "0.1.8" - } - }, - "markdownlint-cli": { - "version": "0.39.0", - "resolved": "https://registry.npmjs.org/markdownlint-cli/-/markdownlint-cli-0.39.0.tgz", - "integrity": "sha512-ZuFN7Xpsbn1Nbp0YYkeLOfXOMOfLQBik2lKRy8pVI/llmKQ2uW7x+8k5OMgF6o7XCsTDSYC/OOmeJ+3qplvnJQ==", - "requires": { - "commander": "~11.1.0", - "get-stdin": "~9.0.0", - "glob": "~10.3.10", - "ignore": "~5.3.0", - "js-yaml": "^4.1.0", - "jsonc-parser": "~3.2.1", - "markdownlint": "~0.33.0", - "minimatch": "~9.0.3", - "run-con": "~1.3.2" - } - }, - "markdownlint-micromark": { - "version": "0.1.8", - "resolved": "https://registry.npmjs.org/markdownlint-micromark/-/markdownlint-micromark-0.1.8.tgz", - "integrity": "sha512-1ouYkMRo9/6gou9gObuMDnvZM8jC/ly3QCFQyoSPCS2XV1ZClU0xpKbL1Ar3bWWRT1RnBZkWUEiNKrI2CwiBQA==" - }, - "mdurl": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/mdurl/-/mdurl-2.0.0.tgz", - "integrity": "sha512-Lf+9+2r+Tdp5wXDXC4PcIBjTDtq4UKjCPMQhKIuzpJNW0b96kVqSwW0bT7FhRSfmAiFYgP+SCRvdrDozfh0U5w==" - }, - "minimatch": { - "version": "9.0.3", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.3.tgz", - "integrity": "sha512-RHiac9mvaRw0x3AYRgDC1CxAP7HTcNrrECeA8YYJeWnpo+2Q5CegtZjaotWTWxDG3UeGA1coE05iH1mPjT/2mg==", - "requires": { - "brace-expansion": "^2.0.1" - } - }, - "minimist": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", - "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==" - }, - "minipass": { - "version": "6.0.2", - "resolved": "https://registry.npmjs.org/minipass/-/minipass-6.0.2.tgz", - "integrity": "sha512-MzWSV5nYVT7mVyWCwn2o7JH13w2TBRmmSqSRCKzTw+lmft9X4z+3wjvs06Tzijo5z4W/kahUCDpRXTF+ZrmF/w==" - }, - "path-key": { - "version": "3.1.1", - "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", - "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==" - }, - "path-scurry": { - "version": "1.10.1", - "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-1.10.1.tgz", - "integrity": "sha512-MkhCqzzBEpPvxxQ71Md0b1Kk51W01lrYvlMzSUaIzNsODdd7mqhiimSZlr+VegAz5Z6Vzt9Xg2ttE//XBhH3EQ==", - "requires": { - "lru-cache": "^9.1.1 || ^10.0.0", - "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0" - } - }, - "punycode.js": { - "version": "2.3.1", - "resolved": "https://registry.npmjs.org/punycode.js/-/punycode.js-2.3.1.tgz", - "integrity": "sha512-uxFIHU0YlHYhDQtV4R9J6a52SLx28BCjT+4ieh7IGbgwVJWO+km431c4yRlREUAsAmt/uMjQUyQHNEPf0M39CA==" - }, - "run-con": { - "version": "1.3.2", - "resolved": "https://registry.npmjs.org/run-con/-/run-con-1.3.2.tgz", - "integrity": "sha512-CcfE+mYiTcKEzg0IqS08+efdnH0oJ3zV0wSUFBNrMHMuxCtXvBCLzCJHatwuXDcu/RlhjTziTo/a1ruQik6/Yg==", - "requires": { - "deep-extend": "^0.6.0", - "ini": "~4.1.0", - "minimist": "^1.2.8", - "strip-json-comments": "~3.1.1" - } - }, - "shebang-command": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", - "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", - "requires": { - "shebang-regex": "^3.0.0" - } - }, - "shebang-regex": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", - "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==" - }, - "signal-exit": { - "version": "4.0.2", - "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.0.2.tgz", - "integrity": "sha512-MY2/qGx4enyjprQnFaZsHib3Yadh3IXyV2C321GY0pjGfVBu4un0uDJkwgdxqO+Rdx8JMT8IfJIRwbYVz3Ob3Q==" - }, - "string-width": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz", - "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==", - "requires": { - "eastasianwidth": "^0.2.0", - "emoji-regex": "^9.2.2", - "strip-ansi": "^7.0.1" - } - }, - "string-width-cjs": { - "version": "npm:string-width@4.2.3", - "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", - "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", - "requires": { - "emoji-regex": "^8.0.0", - "is-fullwidth-code-point": "^3.0.0", - "strip-ansi": "^6.0.1" - }, - "dependencies": { - "ansi-regex": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", - "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==" - }, - "emoji-regex": { - "version": "8.0.0", - "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", - "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==" - }, - "strip-ansi": { - "version": "6.0.1", - "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", - "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", - "requires": { - "ansi-regex": "^5.0.1" - } - } - } - }, - "strip-ansi": { - "version": "7.1.0", - "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.0.tgz", - "integrity": "sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==", - "requires": { - "ansi-regex": "^6.0.1" - } - }, - "strip-ansi-cjs": { - "version": "npm:strip-ansi@6.0.1", - "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", - "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", - "requires": { - "ansi-regex": "^5.0.1" - }, - "dependencies": { - "ansi-regex": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", - "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==" - } - } - }, - "strip-json-comments": { - "version": "3.1.1", - "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz", - "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==" - }, - "tldr-lint": { - "version": "0.0.13", - "resolved": "https://registry.npmjs.org/tldr-lint/-/tldr-lint-0.0.13.tgz", - "integrity": "sha512-xPIg5465dypL4szZpUmQMenFF8uMnI0Fq6h2CADMso47w8xe5zZVrn7TSocd3I5mZxJDqxNoGG82g1Kzvz1wdA==", - "requires": { - "commander": "^8.1.0" - }, - "dependencies": { - "commander": { - "version": "8.3.0", - "resolved": "https://registry.npmjs.org/commander/-/commander-8.3.0.tgz", - "integrity": "sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww==" - } - } - }, - "uc.micro": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/uc.micro/-/uc.micro-2.0.0.tgz", - "integrity": "sha512-DffL94LsNOccVn4hyfRe5rdKa273swqeA5DJpMOeFmEn1wCDc7nAbbB0gXlgBCL7TNzeTv6G7XVWzan7iJtfig==" - }, - "which": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", - "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", - "requires": { - "isexe": "^2.0.0" - } - }, - "wrap-ansi": { - "version": "8.1.0", - "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz", - "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==", - "requires": { - "ansi-styles": "^6.1.0", - "string-width": "^5.0.1", - "strip-ansi": "^7.0.1" - } - }, - "wrap-ansi-cjs": { - "version": "npm:wrap-ansi@7.0.0", - "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", - "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", - "requires": { - "ansi-styles": "^4.0.0", - "string-width": "^4.1.0", - "strip-ansi": "^6.0.0" - }, - "dependencies": { - "ansi-regex": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", - "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==" - }, - "ansi-styles": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", - "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", - "requires": { - "color-convert": "^2.0.1" - } - }, - "emoji-regex": { - "version": "8.0.0", - "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", - "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==" - }, - "string-width": { - "version": "4.2.3", - "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", - "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", - "requires": { - "emoji-regex": "^8.0.0", - "is-fullwidth-code-point": "^3.0.0", - "strip-ansi": "^6.0.1" - } - }, - "strip-ansi": { - "version": "6.0.1", - "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", - "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", - "requires": { - "ansi-regex": "^5.0.1" - } - } - } - } } } diff --git a/package.json b/package.json index 71589ac1f..84585f212 100644 --- a/package.json +++ b/package.json @@ -6,9 +6,9 @@ "repository": "tldr-pages/tldr", "homepage": "https://tldr.sh/", "dependencies": { - "glob": "10.3.10", - "markdownlint-cli": "^0.39.0", - "tldr-lint": "^0.0.13" + "glob": "10.4.1", + "markdownlint-cli": "^0.41.0", + "tldr-lint": "^0.0.15" }, "devDependencies": { "husky": "^9.0.11" diff --git a/pages.ar/common/clamav.md b/pages.ar/common/clamav.md index 6953574f5..7d9b971e2 100644 --- a/pages.ar/common/clamav.md +++ b/pages.ar/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > هذا الأمر هو اسم مستعار لـ `clamdscan`. > لمزيد من التفاصيل: . diff --git a/pages.ar/common/fastmod.md b/pages.ar/common/fastmod.md index 0c5ae7b80..b7baba4f2 100644 --- a/pages.ar/common/fastmod.md +++ b/pages.ar/common/fastmod.md @@ -16,7 +16,7 @@ `fastmod {{regex}} {{replacement}} --dir {{path/to/directory}} --iglob {{'**/*.{js,json}'}}` -- استبدال بالنص مُطابقةً (وليس التعبيرات النمطية)، في ملفات امتداداتهم إما js أو json فحسب: +- استبدال بالنص مُطابقةً (وليس التعبيرات النمطية)، في ملفات امتداداتهم إما js أو JSON فحسب: `fastmod --fixed-strings {{exact_string}} {{replacement}} --extensions {{json,js}}` diff --git a/pages.ar/common/fossil-ci.md b/pages.ar/common/fossil-ci.md index 63ddb0e88..ff7e0ebdb 100644 --- a/pages.ar/common/fossil-ci.md +++ b/pages.ar/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> هذا الأمر هو اسم مستعار لـ `fossil-commit`. +> هذا الأمر هو اسم مستعار لـ `fossil commit`. > لمزيد من التفاصيل: . - إعرض التوثيقات للأمر الأصلي: diff --git a/pages.ar/common/fossil-delete.md b/pages.ar/common/fossil-delete.md index 00974671c..ffb90430c 100644 --- a/pages.ar/common/fossil-delete.md +++ b/pages.ar/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > هذا الأمر هو اسم مستعار لـ `fossil rm`. > لمزيد من التفاصيل: . diff --git a/pages.ar/common/fossil-forget.md b/pages.ar/common/fossil-forget.md index 5d034c6bd..7605c9ccb 100644 --- a/pages.ar/common/fossil-forget.md +++ b/pages.ar/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > هذا الأمر هو اسم مستعار لـ `fossil rm`. > لمزيد من التفاصيل: . diff --git a/pages.ar/common/fossil-new.md b/pages.ar/common/fossil-new.md index 6f2d22adb..230a70251 100644 --- a/pages.ar/common/fossil-new.md +++ b/pages.ar/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> هذا الأمر هو اسم مستعار لـ `fossil-init`. +> هذا الأمر هو اسم مستعار لـ `fossil init`. > لمزيد من التفاصيل: . - إعرض التوثيقات للأمر الأصلي: diff --git a/pages.ar/common/gh-cs.md b/pages.ar/common/gh-cs.md index 320a61b02..e7965191f 100644 --- a/pages.ar/common/gh-cs.md +++ b/pages.ar/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> هذا الأمر هو اسم مستعار لـ `gh-codespace`. +> هذا الأمر هو اسم مستعار لـ `gh codespace`. > لمزيد من التفاصيل: . - إعرض التوثيقات للأمر الأصلي: diff --git a/pages.ar/common/gnmic-sub.md b/pages.ar/common/gnmic-sub.md index 1f6704e1a..22ae242a2 100644 --- a/pages.ar/common/gnmic-sub.md +++ b/pages.ar/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > هذا الأمر هو اسم مستعار لـ `gnmic subscribe`. > لمزيد من التفاصيل: . diff --git a/pages.ar/common/pio-init.md b/pages.ar/common/pio-init.md index ae38c3b84..8855563ab 100644 --- a/pages.ar/common/pio-init.md +++ b/pages.ar/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > هذا الأمر هو اسم مستعار لـ `pio project`. diff --git a/pages.ar/common/tlmgr-arch.md b/pages.ar/common/tlmgr-arch.md index abd27803e..269ff2e2d 100644 --- a/pages.ar/common/tlmgr-arch.md +++ b/pages.ar/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > هذا الأمر هو اسم مستعار لـ `tlmgr platform`. > لمزيد من التفاصيل: . diff --git a/pages.ar/linux/dockerd.md b/pages.ar/linux/dockerd.md index b47c58bfb..7f542ea12 100644 --- a/pages.ar/linux/dockerd.md +++ b/pages.ar/linux/dockerd.md @@ -1,7 +1,7 @@ # dockerd > هي عملية مستمرة تعمل في الخلفية تبدأها لتتحكم في حاويات الدوكر. -> لمزيد من التفاصيل: . +> لمزيد من التفاصيل: . - قم بتشغيل دوكر في الخلفية: @@ -21,4 +21,4 @@ - قم بتشغيل دوكر وحدد له مستوي سجل معين: -`dockerd --log-level={{debug|info|warn|error|fatal}}` +`dockerd --log-level {{debug|info|warn|error|fatal}}` diff --git a/pages.ar/linux/ip-route-list.md b/pages.ar/linux/ip-route-list.md index 1e8a95ae1..d63cfbf99 100644 --- a/pages.ar/linux/ip-route-list.md +++ b/pages.ar/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> هذا الأمر هو اسم مستعار لـ `ip-route-show`. +> هذا الأمر هو اسم مستعار لـ `ip route show`. - إعرض التوثيقات للأمر الأصلي: diff --git a/pages.bn/common/2to3.md b/pages.bn/common/2to3.md index efa8b45e8..44a3723b5 100644 --- a/pages.bn/common/2to3.md +++ b/pages.bn/common/2to3.md @@ -13,11 +13,11 @@ - নির্দিষ্ট পাইথন 2 ভাষা বৈশিষ্ট্যগুলি পাইথন 3 এ রূপান্তর করুন: -`2to3 --write {{ফাইলের/পথ.py}} --fix={{raw_input}} --fix={{print}}` +`2to3 --write {{ফাইলের/পথ.py}} --fix {{raw_input}} --fix {{print}}` - নির্দিষ্ট না করে সমস্ত পাইথন 2 ভাষা বৈশিষ্ট্যগুলি পাইথন 3 এ রূপান্তর করুন: -`2to3 --write {{ফাইলের/পথ.py}} --nofix={{has_key}} --nofix={{isinstance}}` +`2to3 --write {{ফাইলের/পথ.py}} --nofix {{has_key}} --nofix {{isinstance}}` - পাইথন 2 থেকে পাইথন 3 এ রূপান্তর করা যাবত সমস্ত উপলব্ধ ভাষা বৈশিষ্ট্যের তালিকা প্রদর্শন করুন: @@ -25,8 +25,8 @@ - একটি ডিরেক্টরিতে সমস্ত পাইথন 2 ফাইলগুলি পাইথন 3 এ রূপান্তর করুন: -`2to3 --output-dir={{পাথ/টু/পাইথন3_ডিরেক্টরি}} --write-unchanged-files --nobackups {{পাথ/টু/পাইথন2_ডিরেক্টরি}}` +`2to3 --output-dir {{পাথ/টু/পাইথন3_ডিরেক্টরি}} --write-unchanged-files --nobackups {{পাথ/টু/পাইথন2_ডিরেক্টরি}}` - মাল্টিপল থ্রেড সহ ২টু৩ চালান: -`2to3 --processes={{4}} --output-dir={{পাথ/টু/পাইথন3_ডিরেক্টরি}} --write --nobackups --no-diff {{পাথ/টু/পাইথন2_ডিরেক্টরি}}` +`2to3 --processes {{4}} --output-dir {{পাথ/টু/পাইথন3_ডিরেক্টরি}} --write --nobackups --no-diff {{পাথ/টু/পাইথন2_ডিরেক্টরি}}` diff --git a/pages.bn/common/7zr.md b/pages.bn/common/7zr.md index 037693820..f57ac4788 100644 --- a/pages.bn/common/7zr.md +++ b/pages.bn/common/7zr.md @@ -1,7 +1,7 @@ # 7zr > একটি উচ্চ সঙ্কোচন অনুবাদক সাথে ফাইল অ্যার্কাইভার। -> `7z` এর মত, কিন্তু এটি কেবলমাত্র `.7z` ফাইলগুলি সমর্থন করে। +> `7z` এর মত, কিন্তু এটি কেবলমাত্র 7z ফাইলগুলি সমর্থন করে। > আরও তথ্য পাবেন: । - একটি ফাইল বা ডিরেক্টরি অ্যার্কাইভ করুন: diff --git a/pages.bn/common/ack.md b/pages.bn/common/ack.md index 214e4eb2d..a7aaaed73 100644 --- a/pages.bn/common/ack.md +++ b/pages.bn/common/ack.md @@ -18,11 +18,11 @@ - নির্দিষ্ট প্রকারের ফাইলগুলিতে সীমাবদ্ধ খোঁজ করুন: -`ack --type={{ruby}} "{{খোঁজের_প্যাটার্ন}}"` +`ack --type {{ruby}} "{{খোঁজের_প্যাটার্ন}}"` - নির্দিষ্ট প্রকারের ফাইলগুলিতে খোঁজুন না: -`ack --type=no{{ruby}} "{{খোঁজের_প্যাটার্ন}}"` +`ack --type no{{ruby}} "{{খোঁজের_প্যাটার্ন}}"` - পাওয়া মিলে সম্পূর্ণ ম্যাচের সম্পূর্ণ সংখ্যা গণনা করুন: diff --git a/pages.bs/common/clamav.md b/pages.bs/common/clamav.md index 0a2e8e140..6548696fd 100644 --- a/pages.bs/common/clamav.md +++ b/pages.bs/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > Ova komanda je pseudonim za `clamdscan`. > Više informacija: . diff --git a/pages.bs/common/fossil-ci.md b/pages.bs/common/fossil-ci.md index 0e9860108..54d861b24 100644 --- a/pages.bs/common/fossil-ci.md +++ b/pages.bs/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> Ova komanda je pseudonim za `fossil-commit`. +> Ova komanda je pseudonim za `fossil commit`. > Više informacija: . - Pogledaj dokumentaciju za izvornu komandu: diff --git a/pages.bs/common/fossil-delete.md b/pages.bs/common/fossil-delete.md index e02011f95..536fec9da 100644 --- a/pages.bs/common/fossil-delete.md +++ b/pages.bs/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > Ova komanda je pseudonim za `fossil rm`. > Više informacija: . diff --git a/pages.bs/common/fossil-forget.md b/pages.bs/common/fossil-forget.md index fb18dad99..14a7c7d79 100644 --- a/pages.bs/common/fossil-forget.md +++ b/pages.bs/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > Ova komanda je pseudonim za `fossil rm`. > Više informacija: . diff --git a/pages.bs/common/fossil-new.md b/pages.bs/common/fossil-new.md index fc0f95418..0f2fde8ae 100644 --- a/pages.bs/common/fossil-new.md +++ b/pages.bs/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> Ova komanda je pseudonim za `fossil-init`. +> Ova komanda je pseudonim za `fossil init`. > Više informacija: . - Pogledaj dokumentaciju za izvornu komandu: diff --git a/pages.bs/common/gh-cs.md b/pages.bs/common/gh-cs.md index 9983ba1e6..ea7cd28ef 100644 --- a/pages.bs/common/gh-cs.md +++ b/pages.bs/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> Ova komanda je pseudonim za `gh-codespace`. +> Ova komanda je pseudonim za `gh codespace`. > Više informacija: . - Pogledaj dokumentaciju za izvornu komandu: diff --git a/pages.bs/common/gnmic-sub.md b/pages.bs/common/gnmic-sub.md index b0dc11512..63cb4ef6f 100644 --- a/pages.bs/common/gnmic-sub.md +++ b/pages.bs/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > Ova komanda je pseudonim za `gnmic subscribe`. > Više informacija: . diff --git a/pages.bs/linux/ip-route-list.md b/pages.bs/linux/ip-route-list.md index e86e52d17..7f87e1919 100644 --- a/pages.bs/linux/ip-route-list.md +++ b/pages.bs/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> Ova komanda je pseudonim za `ip-route-show`. +> Ova komanda je pseudonim za `ip route show`. - Pogledaj dokumentaciju za izvornu komandu: diff --git a/pages.ca/common/fossil-delete.md b/pages.ca/common/fossil-delete.md index cb22b9560..9553f1f18 100644 --- a/pages.ca/common/fossil-delete.md +++ b/pages.ca/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > Aquest comandament és un àlies de `fossil rm`. > Més informació: . diff --git a/pages.ca/common/fossil-forget.md b/pages.ca/common/fossil-forget.md index 485a67e92..78dab0a29 100644 --- a/pages.ca/common/fossil-forget.md +++ b/pages.ca/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > Aquest comandament és un àlies de `fossil rm`. > Més informació: . diff --git a/pages.ca/common/fossil-new.md b/pages.ca/common/fossil-new.md index f218ff197..5b99147b4 100644 --- a/pages.ca/common/fossil-new.md +++ b/pages.ca/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> Aquest comandament és un àlies de `fossil-init`. +> Aquest comandament és un àlies de `fossil init`. > Més informació: . - Veure documentació pel comandament original: diff --git a/pages.ca/common/gh-cs.md b/pages.ca/common/gh-cs.md index f5048c23e..d31c4191d 100644 --- a/pages.ca/common/gh-cs.md +++ b/pages.ca/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> Aquest comandament és un àlies de `gh-codespace`. +> Aquest comandament és un àlies de `gh codespace`. > Més informació: . - Veure documentació pel comandament original: diff --git a/pages.ca/common/gnmic-sub.md b/pages.ca/common/gnmic-sub.md index fb3cb9000..13062ac1c 100644 --- a/pages.ca/common/gnmic-sub.md +++ b/pages.ca/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > Aquest comandament és un àlies de `gnmic subscribe`. > Més informació: . diff --git a/pages.ca/common/pio-init.md b/pages.ca/common/pio-init.md index 879dc8914..f0a73935d 100644 --- a/pages.ca/common/pio-init.md +++ b/pages.ca/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > Aquest comandament és un àlies de `pio project`. diff --git a/pages.ca/common/tlmgr-arch.md b/pages.ca/common/tlmgr-arch.md index 5acb501d3..619ae5f60 100644 --- a/pages.ca/common/tlmgr-arch.md +++ b/pages.ca/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > Aquest comandament és un àlies de `tlmgr platform`. > Més informació: . diff --git a/pages.ca/linux/add-apt-repository.md b/pages.ca/linux/add-apt-repository.md index 4564c1c4b..71d16a483 100644 --- a/pages.ca/linux/add-apt-repository.md +++ b/pages.ca/linux/add-apt-repository.md @@ -1,13 +1,13 @@ # add-apt-repository -> Gestiona les definicions dels repositoris apt. +> Gestiona les definicions dels repositoris APT. > Més informació: . -- Afegeix un nou repositori apt: +- Afegeix un nou repositori APT: `add-apt-repository {{especificacions_del_respositori}}` -- Elimina un repositori apt: +- Elimina un repositori APT: `add-apt-repository --remove {{especificacions_del_repositori}}` diff --git a/pages.ca/linux/apt-add-repository.md b/pages.ca/linux/apt-add-repository.md index cbf1b3e77..5c00fce14 100644 --- a/pages.ca/linux/apt-add-repository.md +++ b/pages.ca/linux/apt-add-repository.md @@ -1,13 +1,13 @@ # apt-add-repository -> Gestiona les definicions del repositori apt. +> Gestiona les definicions del repositori APT. > Més informació: . -- Afegeix un nou repositori apt: +- Afegeix un nou repositori APT: `apt-add-repository {{repositori}}` -- Elimina un repositori apt: +- Elimina un repositori APT: `apt-add-repository --remove {{repositori}}` diff --git a/pages.ca/linux/apt-file.md b/pages.ca/linux/apt-file.md index 941c67054..6decdf77b 100644 --- a/pages.ca/linux/apt-file.md +++ b/pages.ca/linux/apt-file.md @@ -1,6 +1,6 @@ # apt-file -> Busca arxius en paquets apt, incloent els que encara no s'han instal·lat. +> Busca arxius en paquets APT, incloent els que encara no s'han instal·lat. > Més informació: . - Actualita les metadades de la base de dades: diff --git a/pages.ca/linux/ip-route-list.md b/pages.ca/linux/ip-route-list.md index 3263069b3..bb1965a4f 100644 --- a/pages.ca/linux/ip-route-list.md +++ b/pages.ca/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> Aquest comandament és un àlies de `ip-route-show`. +> Aquest comandament és un àlies de `ip route show`. - Veure documentació pel comandament original: diff --git a/pages.ca/linux/poweroff.md b/pages.ca/linux/poweroff.md index 889cfb183..d500bc536 100644 --- a/pages.ca/linux/poweroff.md +++ b/pages.ca/linux/poweroff.md @@ -1,7 +1,7 @@ # poweroff > Apaga la màquina. -> Més informació: . +> Més informació: . - Apaga la màquina: diff --git a/pages.da/common/clamav.md b/pages.da/common/clamav.md index ca69816e2..c417a443d 100644 --- a/pages.da/common/clamav.md +++ b/pages.da/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > Denne kommando er et alias af `clamdscan`. > Mere information: . diff --git a/pages.da/common/fossil-ci.md b/pages.da/common/fossil-ci.md index befdb7c04..9d065c29c 100644 --- a/pages.da/common/fossil-ci.md +++ b/pages.da/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> Denne kommando er et alias af `fossil-commit`. +> Denne kommando er et alias af `fossil commit`. > Mere information: . - Se dokumentation for den oprindelige kommando: diff --git a/pages.da/common/fossil-delete.md b/pages.da/common/fossil-delete.md index 5b4fa0080..6e9381ace 100644 --- a/pages.da/common/fossil-delete.md +++ b/pages.da/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > Denne kommando er et alias af `fossil rm`. > Mere information: . diff --git a/pages.da/common/fossil-forget.md b/pages.da/common/fossil-forget.md index 4adbd37b1..f58dc3ff9 100644 --- a/pages.da/common/fossil-forget.md +++ b/pages.da/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > Denne kommando er et alias af `fossil rm`. > Mere information: . diff --git a/pages.da/common/fossil-new.md b/pages.da/common/fossil-new.md index 870f9143f..8831c29ca 100644 --- a/pages.da/common/fossil-new.md +++ b/pages.da/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> Denne kommando er et alias af `fossil-init`. +> Denne kommando er et alias af `fossil init`. > Mere information: . - Se dokumentation for den oprindelige kommando: diff --git a/pages.da/common/gh-cs.md b/pages.da/common/gh-cs.md index 6cac0a8d2..acc66c5c2 100644 --- a/pages.da/common/gh-cs.md +++ b/pages.da/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> Denne kommando er et alias af `gh-codespace`. +> Denne kommando er et alias af `gh codespace`. > Mere information: . - Se dokumentation for den oprindelige kommando: diff --git a/pages.da/common/gnmic-sub.md b/pages.da/common/gnmic-sub.md index 0ef8b6b4e..389d18dc6 100644 --- a/pages.da/common/gnmic-sub.md +++ b/pages.da/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > Denne kommando er et alias af `gnmic subscribe`. > Mere information: . diff --git a/pages.da/common/grep.md b/pages.da/common/grep.md index 59ede1aa0..fb2da85e9 100644 --- a/pages.da/common/grep.md +++ b/pages.da/common/grep.md @@ -9,28 +9,28 @@ - Søg efter en eksakt streng (deaktiverer regulære udtryk): -`grep --fixed-strings "{{eksakt_streng}}" {{sti/til/fil}}` +`grep {{-F|--fixed-strings}} "{{eksakt_streng}}" {{sti/til/fil}}` - Søg efter et mønster i alle filer, pånær binære, rekursivt i en mappe. Vis linjenumre der matcher til mønstret: -`grep --recursive --line-number --binary-files={{without-match}} "{{søgemønster}}" {{sti/til/mappe}}` +`grep {{-r|--recursive}} {{-n|--line-number}} --binary-files {{without-match}} "{{søgemønster}}" {{sti/til/mappe}}` - Brug udvidede regulære udtryk (understøtter `?`, `+`, `{}`, `()` og `|`), i case-insensitive modus: -`grep --extended-regexp --ignore-case "{{søgemønster}}" {{sti/til/fil}}` +`grep {{-E|--extended-regexp}} {{-i|--ignore-case}} "{{søgemønster}}" {{sti/til/fil}}` - Print 3 linjer af kontekst omkring, før eller efter hvert match: -`grep --{{context|before-context|after-context}}={{3}} "{{søgemønster}}" {{sti/til/fil}}` +`grep --{{context|before-context|after-context}} 3 "{{søgemønster}}" {{sti/til/fil}}` - Print, filnavn og linjenummer for hvert match, med farveoutput: -`grep --with-filename --line-number --color=always "{{søgemønster}}" {{sti/til/fil}}` +`grep {{-H|--with-filename}} {{-n|--line-number}} --color=always "{{søgemønster}}" {{sti/til/fil}}` - Søg efter linjer som matcher et mønster. Print kun den matchende tekst: -`grep --only-matching "{{søgemønster}}" {{sti/til/fil}}` +`grep {{-o|--only-matching}} "{{søgemønster}}" {{sti/til/fil}}` - Søg i `stdin` efter linjer der ikke matcher et mønster: -`cat {{sti/til/fil}} | grep --invert-match "{{søgemønster}}"` +`cat {{sti/til/fil}} | grep {{-v|--invert-match}} "{{søgemønster}}"` diff --git a/pages.da/common/pio-init.md b/pages.da/common/pio-init.md index 4252f0c15..fdeaf003a 100644 --- a/pages.da/common/pio-init.md +++ b/pages.da/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > Denne kommando er et alias af `pio project`. diff --git a/pages.da/common/sed.md b/pages.da/common/sed.md index 98319014b..6385847ce 100644 --- a/pages.da/common/sed.md +++ b/pages.da/common/sed.md @@ -1,7 +1,7 @@ # sed > Rediger tekst, programmatisk. -> Mere information: . +> Mere information: . - Erstat den første forekomst af et regulært udtryk (regular expression) i hver linje af en fil, og print resultatet: diff --git a/pages.da/common/tlmgr-arch.md b/pages.da/common/tlmgr-arch.md index 99036a481..eddcac7f3 100644 --- a/pages.da/common/tlmgr-arch.md +++ b/pages.da/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > Denne kommando er et alias af `tlmgr platform`. > Mere information: . diff --git a/pages.da/linux/ip-route-list.md b/pages.da/linux/ip-route-list.md index 923867607..96a7dca22 100644 --- a/pages.da/linux/ip-route-list.md +++ b/pages.da/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> Denne kommando er et alias af `ip-route-show`. +> Denne kommando er et alias af `ip route show`. - Se dokumentation for den oprindelige kommando: diff --git a/pages.de/common/7zr.md b/pages.de/common/7zr.md index 22afab4f1..913263ddb 100644 --- a/pages.de/common/7zr.md +++ b/pages.de/common/7zr.md @@ -1,7 +1,7 @@ # 7zr > Ein Dateiarchivierer mit hoher Kompressionsrate. -> Eine alleinstehende Version von `7z`, die nur `.7z` Dateien unterstützt. +> Eine alleinstehende Version von `7z`, die nur 7z Dateien unterstützt. > Weitere Informationen: . - [a]rchiviere eine Datei oder ein Verzeichnis: diff --git a/pages.de/common/alacritty.md b/pages.de/common/alacritty.md index 40e1d6292..d7fdac283 100644 --- a/pages.de/common/alacritty.md +++ b/pages.de/common/alacritty.md @@ -15,10 +15,10 @@ `alacritty -e {{befehl}}` -- Gib eine alternative Konfigurations-Datei an (ist standardmäßig `$XDG_CONFIG_HOME/alacritty/alacritty.yml`): +- Gib eine alternative Konfigurations-Datei an (ist standardmäßig `$XDG_CONFIG_HOME/alacritty/alacritty.toml`): -`alacritty --config-file {{pfad/zu/konfiguration.yml}}` +`alacritty --config-file {{pfad/zu/konfiguration.toml}}` -- Starte mit aktiviertem Live-Konfigurations-Neuladen (kann auch standardmäßig in `alacritty.yml` eingestellt werden): +- Starte mit aktiviertem Live-Konfigurations-Neuladen (kann auch standardmäßig in `alacritty.toml` eingestellt werden): -`alacritty --live-config-reload --config-file {{pfad/zu/konfiguration.yml}}` +`alacritty --live-config-reload --config-file {{pfad/zu/konfiguration.toml}}` diff --git a/pages.de/common/ansible-vault.md b/pages.de/common/ansible-vault.md index 3612d55d2..03bb15cf6 100644 --- a/pages.de/common/ansible-vault.md +++ b/pages.de/common/ansible-vault.md @@ -9,11 +9,11 @@ - Erstelle eine neue verschlüsselte Vault-Datei mit einer Vault-Schlüsseldatei, um sie zu verschlüsseln: -`ansible-vault create --vault-password-file={{schlüsseldatei}} {{vault_datei}}` +`ansible-vault create --vault-password-file {{schlüsseldatei}} {{vault_datei}}` - Verschlüssle eine vorhandene Datei mit einer optionalen Schlüsseldatei: -`ansible-vault encrypt --vault-password-file={{schlüsseldatei}} {{vault_file}}` +`ansible-vault encrypt --vault-password-file {{schlüsseldatei}} {{vault_file}}` - Verschlüssle eine Zeichenfolge mit dem verschlüsselten Zeichenfolgenformat von Ansible, wobei interaktive Eingabeaufforderungen angezeigt werden: @@ -21,8 +21,8 @@ - Zeige eine verschlüsselte Datei an, wobei eine Kennwortdatei zum Entschlüsseln verwendet wird: -`ansible-vault view --vault-password-file={{schlüsseldatei}} {{vault_datei}}` +`ansible-vault view --vault-password-file {{schlüsseldatei}} {{vault_datei}}` - Verschlüssle eine bereits verschlüsselte Vault Datei mit einer neuen Kennwortdatei neu: -`ansible-vault rekey --vault-password-file={{alte_schlüsseldatei}} --new-vault-password-file={{neue_schlüsseldatei}} {{vault_datei}}` +`ansible-vault rekey --vault-password-file {{alte_schlüsseldatei}} --new-vault-password-file {{neue_schlüsseldatei}} {{vault_datei}}` diff --git a/pages.de/common/bash.md b/pages.de/common/bash.md index 66dd49d6a..1917dafad 100644 --- a/pages.de/common/bash.md +++ b/pages.de/common/bash.md @@ -28,6 +28,6 @@ `bash -s` -- Gib die Version von bash aus (verwende `echo $BASH_VERSION`, um nur die Versionszeichenkette anzuzeigen): +- Gib die Version von Bash aus (verwende `echo $BASH_VERSION`, um nur die Versionszeichenkette anzuzeigen): `bash --version` diff --git a/pages.de/common/brew-bundle.md b/pages.de/common/brew-bundle.md index 80da555cc..51ff3200b 100644 --- a/pages.de/common/brew-bundle.md +++ b/pages.de/common/brew-bundle.md @@ -9,7 +9,7 @@ - Installiere Pakete aus einer bestimmten Brewfile: -`brew bundle --file={{pfad/zu/brewfile}}` +`brew bundle --file {{pfad/zu/brewfile}}` - Gib eine Liste mit allen installierten Paketen aus: diff --git a/pages.de/common/cat.md b/pages.de/common/cat.md index 9bc9b4372..d096f60bd 100644 --- a/pages.de/common/cat.md +++ b/pages.de/common/cat.md @@ -1,7 +1,7 @@ # cat > Verkette und gib einzelne oder mehrere Dateien aus. -> Weitere Informationen: . +> Weitere Informationen: . - Gib den Inhalt einer Datei aus: diff --git a/pages.de/common/chown.md b/pages.de/common/chown.md index 0806dbd42..ed88b1ba7 100644 --- a/pages.de/common/chown.md +++ b/pages.de/common/chown.md @@ -21,4 +21,4 @@ - Ändere den Besitzer einer Datei/eines Verzeichnisses, damit sie/es mit einer Referenzdatei übereinstimmt: -`chown --reference={{pfad/zu/referenzdatei_oder_verzeichnis}} {{pfad/zu/datei_oder_verzeichnis}}` +`chown --reference {{pfad/zu/referenzdatei_oder_verzeichnis}} {{pfad/zu/datei_oder_verzeichnis}}` diff --git a/pages.de/common/clamav.md b/pages.de/common/clamav.md index 0dd445285..2710f48ee 100644 --- a/pages.de/common/clamav.md +++ b/pages.de/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > Dieser Befehl ist ein Alias von `clamdscan`. > Weitere Informationen: . diff --git a/pages.de/common/clang-format.md b/pages.de/common/clang-format.md index b55da3e9d..aea61ce57 100755 --- a/pages.de/common/clang-format.md +++ b/pages.de/common/clang-format.md @@ -13,7 +13,7 @@ - Formatiere eine Datei mit einem bestimmten Code-Stil: -`clang-format --style={{LLVM|GNU|Google|Chromium|Microsoft|Mozilla|WebKit}} {{pfad/zu/quelldatei.cpp}}` +`clang-format --style {{LLVM|GNU|Google|Chromium|Microsoft|Mozilla|WebKit}} {{pfad/zu/quelldatei.cpp}}` - Formatiere eine Datei mit der `.clang-format`-Datei aus einem der Überverzeichnisse der Quelldatei: @@ -21,4 +21,4 @@ - Generiere eine eigene `.clang-format`-Datei: -`clang-format --style={{LLVM|GNU|Google|Chromium|Microsoft|Mozilla|WebKit}} --dump-config > {{.clang-format}}` +`clang-format --style {{LLVM|GNU|Google|Chromium|Microsoft|Mozilla|WebKit}} --dump-config > {{.clang-format}}` diff --git a/pages.de/common/convert.md b/pages.de/common/convert.md deleted file mode 100644 index 0e2be4cb1..000000000 --- a/pages.de/common/convert.md +++ /dev/null @@ -1,36 +0,0 @@ -# convert - -> ImageMagick Bildkonvertierungswerkzeug. -> Weitere Informationen: . - -- Konvertiere ein Bild von JPG nach PNG: - -`convert {{pfad/zu/bild.jpg}} {{pfad/zu/bild.png}}` - -- Skaliere ein Bild auf 50% seiner Originalgröße: - -`convert {{pfad/zu/bild.png}} -resize 50% {{pfad/zu/bild2.png}}` - -- Skaliere ein Bild unter Beibehaltung des ursprünglichen Seitenverhältnisses auf eine maximale Größe von 640x480: - -`convert {{pfad/zu/bild.png}} -resize 640x480 {{pfad/zu/bild2.png}}` - -- Hänge Bilder horizontal aneinander: - -`convert {{pfad/zu/bild1.png pfad/zu/bild2.png ...}} +append {{pfad/zu/bild.png}}` - -- Hänge Bilder vertikal aneinander: - -`convert {{pfad/zu/bild1.png pfad/zu/bild2.png ...}} -append {{pfad/zu/bild.png}}` - -- Erstelle ein animiertes GIF aus einer Serie von Bildern mit einer Verzögerung von 100 ms zwischen den Bildern: - -`convert {{pfad/zu/bild1.png pfad/zu/bild2.png ...}} -delay {{10}} {{pfad/zu/animation.gif}}` - -- Erstelle ein Bild mit nichts als einem festen Hintergrund: - -`convert -size {{800x600}} "xc:{{#ff0000}}" {{pfad/zu/bild.png}}` - -- Erstelle ein Favicon aus mehreren Bildern verschiedener Größe: - -`convert {{pfad/zu/bild1.png pfad/zu/bild2.png ...}} {{pfad/zu/bild.ico}}` diff --git a/pages.de/common/cut.md b/pages.de/common/cut.md index 3cf059fcd..dc9aaa99d 100644 --- a/pages.de/common/cut.md +++ b/pages.de/common/cut.md @@ -5,12 +5,12 @@ - Schneide bestimmte Zeichen oder einen Bereich von Feldern jeder Zeile aus: -`{{befehl}} | cut --{{characters|fields}}={{1|1,10|1-10|1-|-10}}` +`{{befehl}} | cut --{{characters|fields}} {{1|1,10|1-10|1-|-10}}` - Schneide einen bestimmten Bereich von Feldern jeder Zeile mit einem bestimmten Trennzeichen aus: -`{{befehl}} | cut --delimiter="{{,}}" --fields={{1}}` +`{{befehl}} | cut --delimiter "{{,}}" --fields {{1}}` - Schneide einen bestimmten Bereich von Zeichen jeder Zeile einer bestimmten Datei aus: -`cut --characters={{1}} {{pfad/zu/datei}}` +`cut --characters {{1}} {{pfad/zu/datei}}` diff --git a/pages.de/common/date.md b/pages.de/common/date.md index 4d0f5bc9b..b549646b1 100644 --- a/pages.de/common/date.md +++ b/pages.de/common/date.md @@ -25,7 +25,7 @@ - Zeige das aktuelle Datum im RFC-3339 Format (`YYYY-MM-DD hh:mm:ss TZ`) an: -`date --rfc-3339=s` +`date --rfc-3339 s` - Setze das aktuelle Datum im Format `MMDDhhmmYYYY.ss` (`YYYY` und `.ss` sind optional): diff --git a/pages.de/common/dd.md b/pages.de/common/dd.md index 54d0918b5..10da798d4 100644 --- a/pages.de/common/dd.md +++ b/pages.de/common/dd.md @@ -1,32 +1,28 @@ # dd > Konvertiere und kopiere eine Datei. -> Weitere Informationen: . +> Weitere Informationen: . - Erstelle ein bootbares USB-Laufwerk von einer isohybriden Datei (wie `archlinux-xxxx.iso`) und zeige den Fortschritt an: -`dd if={{pfad/zu/datei.iso}} of=/dev/{{laufwerk}} status=progress` +`dd if={{pfad/zu/datei.iso}} of={{/dev/laufwerk}} status=progress` - Klone ein USB-Laufwerk in ein anderes in 4MiB Blöcken, ignoriere Fehler und zeige den Fortschritt an: -`dd if=/dev/{{quell_laufwerk}} of=/dev/{{ziel_laufwerk}} bs=4M conv=noerror status=progress` +`dd if={{/dev/quell_laufwerk}} of={{/dev/ziel_laufwerk}} bs=4M conv=noerror status=progress` -- Erstelle eine Datei mit 100 zufälligen Bytes mithilfe des Zufall-Treibers des Kernels: +- Erstelle eine Datei mit spezifizierte zufälligen Bytes mithilfe des Zufall-Treibers des Kernels: -`dd if=/dev/urandom of={{pfad/zu/datei}} bs=100 count=1` +`dd bs={{100}} count={{1}} if=/dev/urandom of={{pfad/zu/datei}}` - Teste die Schreibgeschwindigkeit eines Laufwerks: -`dd if=/dev/zero of={{pfad/zu/1GB_datei}} bs=1024 count=1000000` +`dd bs={{1024}} count={{1000000}} if=/dev/zero of={{pfad/zu/1GB_datei}}` - Erstelle ein System-Backup als IMG Datei und zeige den Fortschritt an: -`dd if=/dev/{{laufwerk}} of={{pfad/zu/datei.img}} status=progress` +`dd if={{/dev/laufwerk}} of={{pfad/zu/datei.img}} status=progress` - Stelle ein Laufwerk aus einer IMG Datei wieder her und zeige den Fortschritt an: -`dd if={{pfad/zu/datei.img}} of=/dev/{{laufwerk}} status=progress` - -- Überprüfe den Fortschritt eines laufenden dd-Prozesses (Führe diesen Befehl von einer anderen Shell aus): - -`kill -USR1 $(pgrep -x dd)` +`dd if={{pfad/zu/datei.img}} of={{/dev/laufwerk}} status=progress` diff --git a/pages.de/common/diff.md b/pages.de/common/diff.md index 30b233f2d..96c512c47 100644 --- a/pages.de/common/diff.md +++ b/pages.de/common/diff.md @@ -1,7 +1,7 @@ # diff > Vergleiche Dateien und Verzeichnisse. -> Weitere Informationen: . +> Weitere Informationen: . - Vergleiche Dateien (Listet jene Veränderungen auf, mit denen `datei1` zu `datei2` wird): diff --git a/pages.de/common/docker-machine.md b/pages.de/common/docker-machine.md index 976071755..594ed3495 100644 --- a/pages.de/common/docker-machine.md +++ b/pages.de/common/docker-machine.md @@ -1,7 +1,7 @@ # docker-machine > Erstelle und verwalte Maschinen, die Docker ausführen. -> Weitere Informationen: . +> Weitere Informationen: . - Liste zur Zeit laufende Docker Maschinen auf: diff --git a/pages.de/common/docker-ps.md b/pages.de/common/docker-ps.md index b3b5c8204..9fd81804c 100644 --- a/pages.de/common/docker-ps.md +++ b/pages.de/common/docker-ps.md @@ -17,7 +17,7 @@ - Zeige nur Container mit einer bestimmten Zeichenkette im Namen: -`docker ps --filter="name={{name}}"` +`docker ps --filter "name={{name}}"` - Zeige nur Container die von einem bestimmten Image abstammen: @@ -25,12 +25,12 @@ - Zeige nur Container mit einem bestimmten Exit-Code: -`docker ps --all --filter="exited={{code}}"` +`docker ps --all --filter "exited={{code}}"` - Zeige nur Container mit einem bestimmten Status (created, running, removing, paused, exited und dead): -`docker ps --filter="status={{status}}"` +`docker ps --filter "status={{status}}"` - Zeige nur Container, welche einen bestimmten Datenträger oder einen Datenträger an einem bestimmten Pfad eingehängt haben: -`docker ps --filter="volume={{pfad/zum/verzeichnis}}" --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Mounts}}"` +`docker ps --filter "volume={{pfad/zum/verzeichnis}}" --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Mounts}}"` diff --git a/pages.de/common/docker-system.md b/pages.de/common/docker-system.md index 4c05b5e5e..ebdb3cbe8 100644 --- a/pages.de/common/docker-system.md +++ b/pages.de/common/docker-system.md @@ -21,7 +21,7 @@ - Entferne nicht-verwendete Daten, die älter als die angegebene Zeit sind: -`docker system prune --filter="until={{stunden}}h{{minuten}}m"` +`docker system prune --filter "until={{stunden}}h{{minuten}}m"` - Zeige Echtzeit-Events vom Docker Daemon: diff --git a/pages.de/common/fish.md b/pages.de/common/fish.md index b8118f232..18bd85089 100644 --- a/pages.de/common/fish.md +++ b/pages.de/common/fish.md @@ -24,7 +24,7 @@ `fish --no-execute {{pfad/zu/skript.fish}}` -- Starte eine private, interaktive Shell-Sitzung, in der `fish` weder auf die Shell-History zugreift, noch diese verändert: +- Starte eine private, interaktive Shell-Sitzung, in der fish weder auf die Shell-History zugreift, noch diese verändert: `fish --private` diff --git a/pages.de/common/fossil-ci.md b/pages.de/common/fossil-ci.md index 819c7ff7c..4b9c0c479 100644 --- a/pages.de/common/fossil-ci.md +++ b/pages.de/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> Dieser Befehl ist ein Alias von `fossil-commit`. +> Dieser Befehl ist ein Alias von `fossil commit`. > Weitere Informationen: . - Zeige die Dokumentation für den originalen Befehl an: diff --git a/pages.de/common/fossil-delete.md b/pages.de/common/fossil-delete.md index d980843b6..1ef42c34d 100644 --- a/pages.de/common/fossil-delete.md +++ b/pages.de/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > Dieser Befehl ist ein Alias von `fossil rm`. > Weitere Informationen: . diff --git a/pages.de/common/fossil-forget.md b/pages.de/common/fossil-forget.md index 373524f24..8ce914b9c 100644 --- a/pages.de/common/fossil-forget.md +++ b/pages.de/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > Dieser Befehl ist ein Alias von `fossil rm`. > Weitere Informationen: . diff --git a/pages.de/common/fossil-new.md b/pages.de/common/fossil-new.md index 646c29963..389b28add 100644 --- a/pages.de/common/fossil-new.md +++ b/pages.de/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> Dieser Befehl ist ein Alias von `fossil-init`. +> Dieser Befehl ist ein Alias von `fossil init`. > Weitere Informationen: . - Zeige die Dokumentation für den originalen Befehl an: diff --git a/pages.de/common/gh-cs.md b/pages.de/common/gh-cs.md index 4c3ca374f..3c410066b 100644 --- a/pages.de/common/gh-cs.md +++ b/pages.de/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> Dieser Befehl ist ein Alias von `gh-codespace`. +> Dieser Befehl ist ein Alias von `gh codespace`. > Weitere Informationen: . - Zeige die Dokumentation für den originalen Befehl an: diff --git a/pages.de/common/git-am.md b/pages.de/common/git-am.md index fed74aa71..3d3ddd027 100644 --- a/pages.de/common/git-am.md +++ b/pages.de/common/git-am.md @@ -8,6 +8,10 @@ `git am {{pfad/zu/datei.patch}}` +- Herunterladen und Integrieren einer Patch-Datei: + +`curl -L {{https://beispiel.de/datei.patch}} | git apply` + - Brich das Integrieren einer Patch-Datei ab: `git am --abort` diff --git a/pages.de/common/git-format-patch.md b/pages.de/common/git-format-patch.md new file mode 100644 index 000000000..908d89bc6 --- /dev/null +++ b/pages.de/common/git-format-patch.md @@ -0,0 +1,17 @@ +# git format-patch + +> Erstelle `.patch` Dateien. Ermöglicht das Senden von Commits per E-Mail. +> Siehe auch `git am`, womit `.patch` Datein lokal angewandt werden. +> Weitere Informationen: . + +- Erzeuge eine `.patch` Datei aus allen nicht gepushten Commits: + +`git format-patch {{origin}}` + +- Erstelle eine `.patch` Datei aus allen Commits zwischen den angegebenen Revisionen und schreibe diese nach `stdout`: + +`git format-patch {{revision_1}}..{{revision_2}}` + +- Erstelle eine `.patch` Datei aus den letzten 3 Commits: + +`git format-patch -{{3}}` diff --git a/pages.de/common/git-send-email.md b/pages.de/common/git-send-email.md new file mode 100644 index 000000000..5f33ea778 --- /dev/null +++ b/pages.de/common/git-send-email.md @@ -0,0 +1,24 @@ +# git send-email + +> Sende eine Menge von Patches als E-Mail. Patches können als Dateien, Ordner oder Liste von Revisionen spezifiziert werden. +> Weitere Informationen: . + +- Sende den letzten Commit des aktuellen Branches: + +`git send-email -1` + +- Sende einen spezifischen Commit: + +`git send-email -1 {{commit}}` + +- Sende die letzten (z.B. 10) Commits des aktuellen Branches: + +`git send-email {{-10}}` + +- Editiere eine E-Mail mit einer Reihe von Patches im Standardmailclienten: + +`git send-email -{{anzahl_an_commits}} --compose` + +- Bearbeite den E-Mail Text jedes der zu versendenden Patches: + +`git send-email -{{anzahl_an_commits}} --annotate` diff --git a/pages.de/common/gnmic-sub.md b/pages.de/common/gnmic-sub.md index 5320b2892..99796b203 100644 --- a/pages.de/common/gnmic-sub.md +++ b/pages.de/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > Dieser Befehl ist ein Alias von `gnmic subscribe`. > Weitere Informationen: . diff --git a/pages.de/common/grep.md b/pages.de/common/grep.md index 927d44a3f..905c569de 100644 --- a/pages.de/common/grep.md +++ b/pages.de/common/grep.md @@ -10,12 +10,12 @@ - Suche nach einem exakten Ausdruck: -`grep --fixed-strings "{{exakter_ausdruck}}" {{pfad/zu/datei}}` +`grep {{-F|--fixed-strings}} "{{exakter_ausdruck}}" {{pfad/zu/datei}}` - Benutze erweiterte reguläre Ausdrücke (unterstützt `?`, `+`, `{}`, `()` und `|`) ohne Beachtung der Groß-, Kleinschreibung: -`grep --extended-regexp --ignore-case "{{ausdruck}}" {{pfad/zu/datei}}` +`grep {{-E|--extended-regexp}} {{-i|--ignore-case}} "{{ausdruck}}" {{pfad/zu/datei}}` - Zeige 3 Zeilen Kontext um [C], vor [B] oder nach [A] jedem Ergebnis: -`grep --{{context|before-context|after-context}}={{3}} "{{ausdruck}}" {{pfad/zu/datei}}` +`grep --{{context|before-context|after-context}} 3 "{{ausdruck}}" {{pfad/zu/datei}}` diff --git a/pages.de/common/jq.md b/pages.de/common/jq.md index 02e3f7990..732b7deab 100644 --- a/pages.de/common/jq.md +++ b/pages.de/common/jq.md @@ -1,7 +1,7 @@ # jq > Ein JSON-Verarbeiter für die Kommandozeile mit einer domänenspezifischen Sprache. -> Weitere Informationen: . +> Weitere Informationen: . - Führe den angegebenen Ausdruck aus (gib farbiges und formatiertes JSON aus): diff --git a/pages.de/linux/lastcomm.md b/pages.de/common/lastcomm.md similarity index 100% rename from pages.de/linux/lastcomm.md rename to pages.de/common/lastcomm.md diff --git a/pages.de/common/compare.md b/pages.de/common/magick-compare.md similarity index 50% rename from pages.de/common/compare.md rename to pages.de/common/magick-compare.md index 1918295b9..797edfa30 100644 --- a/pages.de/common/compare.md +++ b/pages.de/common/magick-compare.md @@ -1,12 +1,12 @@ -# compare +# magick compare > Zeige Unterschiede von zwei Bildern. > Weitere Informationen: . - Vergleiche 2 Bilder: -`compare {{pfad/zu/bild1.png}} {{pfad/zu/bild2.png}} {{pfad/zu/diff.png}}` +`magick compare {{pfad/zu/bild1.png}} {{pfad/zu/bild2.png}} {{pfad/zu/diff.png}}` - Vergleiche 2 Bilder mit einer bestimmten Metrik (standardmäßig NCC): -`compare -verbose -metric {{PSNR}} {{pfad/zu/bild1.png}} {{pfad/zu/bild2.png}} {{pfad/zu/diff.png}}` +`magick compare -verbose -metric {{PSNR}} {{pfad/zu/bild1.png}} {{pfad/zu/bild2.png}} {{pfad/zu/diff.png}}` diff --git a/pages.de/common/magick-convert.md b/pages.de/common/magick-convert.md new file mode 100644 index 000000000..5b51aabdc --- /dev/null +++ b/pages.de/common/magick-convert.md @@ -0,0 +1,36 @@ +# magick convert + +> ImageMagick Bildkonvertierungswerkzeug. +> Weitere Informationen: . + +- Konvertiere ein Bild von JPEG nach PNG: + +`magick convert {{pfad/zu/bild.jpg}} {{pfad/zu/bild.png}}` + +- Skaliere ein Bild auf 50% seiner Originalgröße: + +`magick convert {{pfad/zu/bild.png}} -resize 50% {{pfad/zu/bild2.png}}` + +- Skaliere ein Bild unter Beibehaltung des ursprünglichen Seitenverhältnisses auf eine maximale Größe von 640x480: + +`magick convert {{pfad/zu/bild.png}} -resize 640x480 {{pfad/zu/bild2.png}}` + +- Hänge Bilder horizontal aneinander: + +`magick convert {{pfad/zu/bild1.png pfad/zu/bild2.png ...}} +append {{pfad/zu/bild.png}}` + +- Hänge Bilder vertikal aneinander: + +`magick convert {{pfad/zu/bild1.png pfad/zu/bild2.png ...}} -append {{pfad/zu/bild.png}}` + +- Erstelle ein animiertes GIF aus einer Serie von Bildern mit einer Verzögerung von 100 ms zwischen den Bildern: + +`magick convert {{pfad/zu/bild1.png pfad/zu/bild2.png ...}} -delay {{10}} {{pfad/zu/animation.gif}}` + +- Erstelle ein Bild mit nichts als einem festen Hintergrund: + +`magick convert -size {{800x600}} "xc:{{#ff0000}}" {{pfad/zu/bild.png}}` + +- Erstelle ein Favicon aus mehreren Bildern verschiedener Größe: + +`magick convert {{pfad/zu/bild1.png pfad/zu/bild2.png ...}} {{pfad/zu/bild.ico}}` diff --git a/pages.de/common/nmap.md b/pages.de/common/nmap.md index 8fe60dbaa..1c608bf55 100644 --- a/pages.de/common/nmap.md +++ b/pages.de/common/nmap.md @@ -2,7 +2,7 @@ > Netzwerk-Erkundungs-Werkzeug und Security / Port Scanner. > Manche Funktionen können nur benutzt werden, wenn Nmap mit Root Rechten ausgeführt wird. -> Weitere Informationen: . +> Weitere Informationen: . - Überprüfe ob eine IP-Adresse online ist und versuche, das Betriebssystem herauszufinden: diff --git a/pages.de/common/omz.md b/pages.de/common/omz.md index 1cb1cdf9c..fa1c2fce3 100644 --- a/pages.de/common/omz.md +++ b/pages.de/common/omz.md @@ -11,7 +11,7 @@ `omz changelog` -- Starte die aktuelle zsh-Sitzung und Oh My Zsh neu: +- Starte die aktuelle Zsh-Sitzung und Oh My Zsh neu: `omz reload` diff --git a/pages.de/common/pcapfix.md b/pages.de/common/pcapfix.md new file mode 100644 index 000000000..abffdbe4a --- /dev/null +++ b/pages.de/common/pcapfix.md @@ -0,0 +1,24 @@ +# pcapfix + +> Repariere beschädigte oder korrumpierte `pcap`- und `pcapng`-Dateien. +> Weitere Informationen: . + +- Repariere eine `pcap`/`pcapng`-Datei (Hinweis: bei `pcap`-Dateien werden nur die ersten 262144 Bytes jedes Pakets gescannt): + +`pcapfix {{pfad/zu/datei.pcapng}}` + +- Repariere eine ganze `pcap`-Datei: + +`pcapfix --deep-scan {{pfad/zu/datei.pcap}}` + +- Repariere eine `pcap`/`pcapng`-Datei und schreibe die Reparieree Datei an einen bestimmten Speicherort: + +`pcapfix --outfile {{pfad/zu/Repariere.pcap}} {{pfad/zu/datei.pcap}}` + +- Behandle die zu reparierende Datei als `pcapng`-Datei, unabhängig von der automatischen Typenerkennung: + +`pcapfix --pcapng {{pfad/zu/datei.pcapng}}` + +- Repariere eine Datei und zeige den Reparaturprozess im Detail: + +`pcapfix --verbose {{pfad/zu/datei.pcap}}` diff --git a/pages.de/common/pio-init.md b/pages.de/common/pio-init.md index 9a88de4c4..dff00ffb1 100644 --- a/pages.de/common/pio-init.md +++ b/pages.de/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > Dieser Befehl ist ein Alias von `pio project`. diff --git a/pages.de/common/sc_analysis_dump.md b/pages.de/common/sc_analysis_dump.md new file mode 100644 index 000000000..8c4001a4b --- /dev/null +++ b/pages.de/common/sc_analysis_dump.md @@ -0,0 +1,8 @@ +# sc_analysis_dump + +> Ausgabe von Traceroute-Pfaden in einem leicht zu parsenden Format. +> Weitere Informationen: . + +- Gib die traceroute in `warts`-Dateien nacheinander in einem leicht zu parsendem Format aus: + +`sc_analysis_dump {{path/to/file1.warts path/to/file2.warts ...}}` diff --git a/pages.de/common/sc_tracediff.md b/pages.de/common/sc_tracediff.md new file mode 100644 index 000000000..48af4a145 --- /dev/null +++ b/pages.de/common/sc_tracediff.md @@ -0,0 +1,16 @@ +# sc_tracediff + +> Anzeige von Traceroute-Pfaden, bei denen sich der Pfad geändert hat. +> Weitere Informationen: . + +- Zeige den Unterschied zwischen den traceroutes in zwei `warts`-Dateien: + +`sc_tracediff {{path/to/file1.warts}} {{path/to/file2.warts}}` + +- Zeige den Unterschied zwischen den traceroutes in zwei `warts`-Dateien, einschließlich derer, die sich nicht geändert haben: + +`sc_tracediff -a {{path/to/file1.warts}} {{path/to/file2.warts}}` + +- Zeige den Unterschied zwischen den traceroutes in zwei `warts'-Dateien und versuche, wenn möglich, DNS-Namen und nicht IP-Adressen anzuzeigen: + +`sc_tracediff -n {{path/to/file1.warts}} {{path/to/file2.warts}}` diff --git a/pages.de/common/sc_ttlexp.md b/pages.de/common/sc_ttlexp.md new file mode 100644 index 000000000..53c6a1763 --- /dev/null +++ b/pages.de/common/sc_ttlexp.md @@ -0,0 +1,8 @@ +# sc_ttlexp + +> Ausgabe der Quelladressen von ICMP TTL expire-Nachrichten in `warts`-Dateien. +> Weitere Informationen: . + +- Gib die Quelladressen von ICMP TTL expire-Nachrichten in einer `warts`-Datei nacheinander aus: + +`sc_ttlexp {{path/to/file1.warts path/to/file2.warts ...}}` diff --git a/pages.de/common/sc_warts2csv.md b/pages.de/common/sc_warts2csv.md new file mode 100644 index 000000000..bf22cf854 --- /dev/null +++ b/pages.de/common/sc_warts2csv.md @@ -0,0 +1,8 @@ +# sc_warts2csv + +> Umwandlung von tracroutes aus `warts`-Dateien in das CSV-Format. +> Weitere Informationen: . + +- Wandle traceroute-Daten in einer `warts`-Datei in CSV um und gebe dieses aus: + +`sc_warts2csv {{path/to/file1.warts path/to/file2.warts ...}}` diff --git a/pages.de/common/sc_warts2json.md b/pages.de/common/sc_warts2json.md new file mode 100644 index 000000000..2f74ae8ea --- /dev/null +++ b/pages.de/common/sc_warts2json.md @@ -0,0 +1,8 @@ +# sc_warts2json + +> Wandelt eine WARTS-Datei in eine JSON-Datei um. +> Weitere Informationen: . + +- Wandle `warts`-Dateien in JSON um und gib diese aus: + +`sc_warts2json {{path/to/file1.warts path/to/file2.warts ...}}` diff --git a/pages.de/common/sc_warts2pcap.md b/pages.de/common/sc_warts2pcap.md new file mode 100644 index 000000000..1768f2d9a --- /dev/null +++ b/pages.de/common/sc_warts2pcap.md @@ -0,0 +1,13 @@ +# sc_warts2pcap + +> Schreibt die in den `warts`-Dateien enthaltenen Pakete in eine `pcap`-Datei. +> Dies ist nur bei tbit, sting und sniff möglich. +> Weitere Informationen: . + +- Wandle die Daten aus mehreren `warts`-Dateien in eine `pcap`-Datei um: + +`sc_warts2pcap -o {{path/to/output.pcap}} {{path/to/file1.warts path/to/file2.warts ...}}` + +- Wandle die Daten aus einer `warts`-Datei in eine `pcap`-Datei um und sortiere die Pakete nach Zeitstempel: + +`sc_warts2pcap -s -o {{path/to/output.pcap}} {{path/to/file.warts}}` diff --git a/pages.de/common/sc_warts2text.md b/pages.de/common/sc_warts2text.md new file mode 100644 index 000000000..79210e949 --- /dev/null +++ b/pages.de/common/sc_warts2text.md @@ -0,0 +1,8 @@ +# sc_warts2text + +> Einfache Ausgabe der in einer `warts`-Datei enthaltenen Informationen. +> Weitere Informationen: . + +- Gib die Informationen in einer `warts`-Datei als Text aus: + +`sc_warts2text {{path/to/file1.warts path/to/file2.warts ...}}` diff --git a/pages.de/common/sc_wartscat.md b/pages.de/common/sc_wartscat.md new file mode 100644 index 000000000..984c6f934 --- /dev/null +++ b/pages.de/common/sc_wartscat.md @@ -0,0 +1,8 @@ +# sc_wartscat + +> Füge mehrere `warts`-Dateien zusammen. +> Weitere Informationen: . + +- Verkette mehrere `warts`-Dateien zu Einer: + +`sc_wartscat -o {{path/to/output.warts}} {{path/to/file1.warts path/to/file2.warts ...}}` diff --git a/pages.de/common/sc_wartsdump.md b/pages.de/common/sc_wartsdump.md new file mode 100644 index 000000000..c9b3fd181 --- /dev/null +++ b/pages.de/common/sc_wartsdump.md @@ -0,0 +1,8 @@ +# sc_wartsdump + +> Ausführliche Ausgabe der in einer `warts`-Datei enthaltenen Daten. +> Weitere Informationen: . + +- Gib den Inhalt von `warts`-Dateien ausführlich aus: + +`sc_wartsdump {{path/to/file1.warts path/to/file2.warts ...}}` diff --git a/pages.de/common/sc_wartsfilter.md b/pages.de/common/sc_wartsfilter.md new file mode 100644 index 000000000..d45dba6e2 --- /dev/null +++ b/pages.de/common/sc_wartsfilter.md @@ -0,0 +1,16 @@ +# sc_wartsfilter + +> Filtert bestimmte Datensätze aus einer `warts`-Datei. +> Weitere Informationen: . + +- Filtere alle Datensätze, welche ein bestimmtes Ziel haben und schreibe sie in eine separate Datei: + +`sc_wartsfilter -i {{path/to/input.warts}} -o {{path/to/output.warts}} -a {{192.0.2.5}} -a {{192.0.2.6}}` + +- Filtere alle Datensätze, welche ein Ziel in einem bestimmten Prefix haben und schreibe sie in eine separate Datei: + +`sc_wartsfilter -i {{path/to/input.warts}} -o {{path/to/output.warts}} -a {{2001:db8::/32}}` + +- Filtere alle Datensätze, welche durch eine bestimmte Aktion entstanden sind und gebe sie als JSON aus: + +`sc_wartsfilter -i {{path/to/input.warts}} -t {{ping}} | sc_warts2json` diff --git a/pages.de/common/sc_wartsfix.md b/pages.de/common/sc_wartsfix.md new file mode 100644 index 000000000..0cbe8ce53 --- /dev/null +++ b/pages.de/common/sc_wartsfix.md @@ -0,0 +1,8 @@ +# sc_wartsfix + +> Rettet beschädigte `warts`-Dateien. +> Weitere Informationen: . + +- Speichere alle Datensätze (in einer separaten Datei) bis zum letzten intakten Datensatz: + +`sc_wartsfix {{path/to/file1.warts path/to/file2.warts ...}}` diff --git a/pages.de/common/scamper.md b/pages.de/common/scamper.md new file mode 100644 index 000000000..06a66aa82 --- /dev/null +++ b/pages.de/common/scamper.md @@ -0,0 +1,29 @@ +# scamper + +> Sondiert aktiv das Internet, um die Topologie und Leistung zu analysieren. +> Liefert einige Werkzeuge mit, welche mit `sc_` starten, beispielsweise `sc_warts2text` oder `sc_ttlexp`. +> Weitere Informationen: . + +- Führe die Standardoption (Traceroute) auf ein Ziel aus: + +`scamper -i {{192.0.2.1}}` + +- Führe zwei Aktionen (ping und traceroute) auf zwei verschiedenen Zielen aus: + +`scamper -I "{{ping}} {{192.0.2.1}}" -I "{{trace}} {{192.0.2.2}}` + +- Pinge mehrere Hosts mit UDP an, verwende eine bestimmte Portnummer für den ersten Ping und erhöhe sie für jeden weiteren Ping: + +`scamper -c "{{ping}} -P {{UDP-dport}} -d {{33434}}" -i {{192.0.2.1}} -i {{192.0.2.2}}` + +- Verwende den Multipath Discovery Algorithm (MDA), um das Vorhandensein von lastverteilten Pfaden zum Ziel zu ermitteln, und verwende für die Sondierung ICMP-Echopakete mit maximal drei Versuchen, und schreibe das Ergebnis in eine `warts`-Datei: + +`scamper -O {{warts}} -o {{path/to/output.warts}} -I "{{tracelb}} -P {{ICMP-echo}} -q {{3}} {{192.0.2.1}}"` + +- Führe eine Paris-Traceroute mit ICMP zu einem Ziel aus und speichere das Ergebnis in einer komprimierten `warts`-Datei: + +`scamper -O {{warts.gz}} -o {{path/to/output.warts}} -I "{{trace}} -P {{icmp-paris}} {{2001:db8:dead:beaf::4}}"` + +- Zeichne alle ICMP-Pakete, die an einer bestimmten IP-Adresse ankommen und eine bestimmte ICMP-ID haben, in einer `warts`-Datei auf: + +`scamper -O {{warts}} -o {{path/to/output.warts}} -I "sniff -S {{2001:db8:dead:beef::6}} icmp[icmpid] == {{101}}"` diff --git a/pages.de/common/ssh-keygen.md b/pages.de/common/ssh-keygen.md index 475fec69e..8e3893d5c 100644 --- a/pages.de/common/ssh-keygen.md +++ b/pages.de/common/ssh-keygen.md @@ -1,6 +1,6 @@ # ssh-keygen -> Generiert ssh Schlüssel für Authentifizierung, Passwort-lose Logins und mehr. +> Generiert SSH Schlüssel für Authentifizierung, Passwort-lose Logins und mehr. > Weitere Informationen: . - Erstelle ein SSH Schlüssel-Paar interaktiv: diff --git a/pages.de/common/tig.md b/pages.de/common/tig.md index 20bafb298..dbd98a2fb 100644 --- a/pages.de/common/tig.md +++ b/pages.de/common/tig.md @@ -1,7 +1,7 @@ # tig > Eine interaktive Kommandozeilenoberfläche für Git. -> Weitere Informationen: . +> Weitere Informationen: . - Zeige die Commits des aktuellen Branches: diff --git a/pages.de/common/tlmgr-arch.md b/pages.de/common/tlmgr-arch.md index 81aa4dbfe..155c092b0 100644 --- a/pages.de/common/tlmgr-arch.md +++ b/pages.de/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > Dieser Befehl ist ein Alias von `tlmgr platform`. > Weitere Informationen: . diff --git a/pages.de/common/traefik.md b/pages.de/common/traefik.md new file mode 100644 index 000000000..4929a6f4f --- /dev/null +++ b/pages.de/common/traefik.md @@ -0,0 +1,20 @@ +# traefik + +> Ein HTTP-Reverse-Proxy und Load-Balancer. +> Weitere Informationen: . + +- Starte den Server mit der Standardkonfiguration: + +`traefik` + +- Starte den Server mit einer benutzerdefinierten Konfigurationsdatei: + +`traefik --ConfigFile {{konfigurationsdatei.toml}}` + +- Starte den Server mit aktiviertem Cluster-Modus: + +`traefik --cluster` + +- Starte den Server mit dem Web-UI: + +`traefik --web` diff --git a/pages.de/common/ugrep.md b/pages.de/common/ugrep.md index 0a2880034..2e407f79d 100644 --- a/pages.de/common/ugrep.md +++ b/pages.de/common/ugrep.md @@ -23,7 +23,7 @@ `ugrep --fuzzy={{3}} "{{suchmuster}}"` -- Suche auch in allen komprimierten Dateien und `zip`- und `tar`-Archive: +- Suche auch in allen komprimierten Dateien und Zip- und tar-Archive: `ugrep --decompress "{{suchmuster}}"` diff --git a/pages.de/common/zsh.md b/pages.de/common/zsh.md index cba5dd295..35574985c 100644 --- a/pages.de/common/zsh.md +++ b/pages.de/common/zsh.md @@ -24,6 +24,6 @@ `zsh --verbose` -- Führe einen Befehl innerhalb von `zsh` mit ausgeschalteten Glob-Mustern aus: +- Führe einen Befehl innerhalb von Zsh mit ausgeschalteten Glob-Mustern aus: `noglob {{befehl}}` diff --git a/pages.de/linux/arch-chroot.md b/pages.de/linux/arch-chroot.md index c5ffa3543..d22fc4548 100644 --- a/pages.de/linux/arch-chroot.md +++ b/pages.de/linux/arch-chroot.md @@ -3,7 +3,7 @@ > Erweiterter `chroot`-Befehl zur Unterstützung des Arch-Linux-Installationsprozesses. > Weitere Informationen: . -- Starte eine interaktive Shell (Standardmäßig `bash`) in einem neuen Root-Verzeichnis: +- Starte eine interaktive Shell (Standardmäßig Bash) in einem neuen Root-Verzeichnis: `arch-chroot {{pfad/zu/neuem/root}}` @@ -11,10 +11,10 @@ `arch-chroot -u {{anderer_benutzer}} {{pfad/zu/neuem/root}}` -- Führe einen benutzerdefinierten Befehl (anstelle des Standardbefehls `bash`) im neuen Root-Verzeichnis aus: +- Führe einen benutzerdefinierten Befehl (anstelle des Standardbefehls Bash) im neuen Root-Verzeichnis aus: `arch-chroot {{pfad/zu/neuem/root}} {{befehl}} {{befehlsparameter}}` -- Gib die Shell an, die nicht die Standard-Shell `bash` ist (in diesem Fall sollte das Paket `zsh` auf dem Zielsystem installiert worden sein): +- Gib die Shell an, die nicht die Standard-Shell Bash ist (in diesem Fall sollte das Paket `zsh` auf dem Zielsystem installiert worden sein): `arch-chroot {{pfad/zu/neuem/root}} {{zsh}}` diff --git a/pages.de/linux/esa-snap.md b/pages.de/linux/esa-snap.md index f2beb5b89..2da30d107 100644 --- a/pages.de/linux/esa-snap.md +++ b/pages.de/linux/esa-snap.md @@ -1,4 +1,4 @@ -# snap +# esa snap > Sentinel Application Platform (SNAP) für die Prozessierung von Satellitendaten der Europäischen Raumfahrtagentur (ESA). > Weitere Informationen: . diff --git a/pages.de/linux/httpie.md b/pages.de/linux/httpie.md index 0ba62cccc..72440abd3 100644 --- a/pages.de/linux/httpie.md +++ b/pages.de/linux/httpie.md @@ -1,4 +1,4 @@ -# HTTPie +# httpie > Ein benutzerfreundliches HTTP-Tool. > Weitere Informationen: . diff --git a/pages.de/linux/ip-route-list.md b/pages.de/linux/ip-route-list.md index 4d0ff5925..c0c154ab2 100644 --- a/pages.de/linux/ip-route-list.md +++ b/pages.de/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> Dieser Befehl ist ein Alias von `ip-route-show`. +> Dieser Befehl ist ein Alias von `ip route show`. - Zeige die Dokumentation für den originalen Befehl an: diff --git a/pages.de/linux/ip.md b/pages.de/linux/ip.md index 49e0bfec5..e97740db4 100644 --- a/pages.de/linux/ip.md +++ b/pages.de/linux/ip.md @@ -1,7 +1,7 @@ # ip > Zeige und manipuliere routing, Geräte, Policy routing und Tunnel. -> Weitere Informationen: . +> Weitere Informationen: . - Zeige Interfaces mit detaillierten Informationen: diff --git a/pages.de/linux/nixos-container.md b/pages.de/linux/nixos-container.md new file mode 100644 index 000000000..315adfe96 --- /dev/null +++ b/pages.de/linux/nixos-container.md @@ -0,0 +1,28 @@ +# nixos-container + +> Startet NixOS Container basierend auf Linux Containern. +> Weitere Informationen: . + +- Gibt eine Liste der gestarteten Container aus: + +`sudo nixos-container list` + +- Erstelle einen NixOS Container mit einer spezifischen Konfigurations-Datei: + +`sudo nixos-container create {{container_name}} --config-file {{nix_config_file_path}}` + +- Starte, stoppe, terminiere oder zerstöre den angegebenen Container: + +`sudo nixos-container {{start|stop|terminate|destroy|status}} {{container_name}}` + +- Führe ein Kommando in einem laufenden Container aus: + +`sudo nixos-container run {{container_name}} -- {{command}} {{command_arguments}}` + +- Aktualisiere eine Containerkonfiguration: + +`sudo $EDITOR /var/lib/container/{{container_name}}/etc/nixos/configuration.nix && sudo nixos-container update {{container_name}}` + +- Starte eine interaktive Shell innerhalb eines laufenden Containers: + +`sudo nixos-container root-login {{container_name}}` diff --git a/pages.de/linux/nixos-option.md b/pages.de/linux/nixos-option.md new file mode 100644 index 000000000..e1573ae7b --- /dev/null +++ b/pages.de/linux/nixos-option.md @@ -0,0 +1,28 @@ +# nixos-option + +> Prüfe eine NixOS Konfiguration. +> Weitere Informationen: . + +- Liste alle Unterschlüssel eines angegebenen Options-Schlüssels: + +`nixos-option {{option_key}}` + +- Liste aktuelle Boot-Kernelmodule: + +`nixos-option boot.kernelModules` + +- Liste Authorisierungsschlüssel für einen spezifischen Benutzer: + +`nixos-option users.users.{{username}}.openssh.authorizedKeys.{{keyFiles|keys}}` + +- Liste alle Remote-Builder-Maschinen: + +`nixos-option nix.buildMachines` + +- Liste alle Unterschlüssel eines angegebenen Options-Schlüssels innerhalb einer angegebenen Konfigurations-Datei: + +`NIXOS_CONFIG={{path_to_configuration.nix}} nixos-option {{option_key}}` + +- Zeige rekursiv alle Werte eines Benutzers: + +`nixos-option -r users.users.{{user}}` diff --git a/pages.de/linux/nixos-rebuild.md b/pages.de/linux/nixos-rebuild.md new file mode 100644 index 000000000..459f40864 --- /dev/null +++ b/pages.de/linux/nixos-rebuild.md @@ -0,0 +1,32 @@ +# nixos-rebuild + +> Rekonfiguriere eine NixOS-Maschine. +> Weitere Informationen: . + +- Erstelle und wechsle zu einer neuen Konfiguration und nutze diese künftig als Standardkonfiguration: + +`sudo nixos-rebuild switch` + +- Gib der neu erstellten Standardkonfiguration einen Namen: + +`sudo nixos-rebuild switch -p {{name}}` + +- Erstelle und wechsle zu einer neuen Konfiguration, nutze diese künftig als Standardkonfiguration und installiere Updates: + +`sudo nixos-rebuild switch --upgrade` + +- Setze Änderungen der Konfiguration zurück und wechsle zur vorhergehenden Konfiguration: + +`sudo nixos-rebuild switch --rollback` + +- Erstelle eine neue Konfiguration und starte diese zukünftig direkt ohne sofort zu wechseln: + +`sudo nixos-rebuild boot` + +- Erstelle und wechsle direkt zu einer neuen Konfiguration, ändere den Standard-Start-Eintrag nicht (dieses Kommando ist für Testzwecke gedacht): + +`sudo nixos-rebuild test` + +- Erstelle die Konfiguration und öffne diese in einer virtuellen Maschine: + +`sudo nixos-rebuild build-vm` diff --git a/pages.es/android/bugreportz.md b/pages.es/android/bugreportz.md index 23722a464..c5e1e1c28 100644 --- a/pages.es/android/bugreportz.md +++ b/pages.es/android/bugreportz.md @@ -12,10 +12,10 @@ `bugreportz -p` -- Muestra la versión de `bugreportz`: - -`bugreportz -v` - - Muestra ayuda: `bugreportz -h` + +- Muestra la versión de `bugreportz`: + +`bugreportz -v` diff --git a/pages.es/android/logcat.md b/pages.es/android/logcat.md index a4c54d65b..55b9cd309 100644 --- a/pages.es/android/logcat.md +++ b/pages.es/android/logcat.md @@ -17,8 +17,8 @@ - Muestra registros de un proceso específico: -`logcat --pid={{pid}}` +`logcat --pid {{pid}}` - Muestra registros del proceso de un paquete específico: -`logcat --pid=$(pidof -s {{paquete}})` +`logcat --pid $(pidof -s {{paquete}})` diff --git a/pages.es/android/wm.md b/pages.es/android/wm.md index 9a3a779c9..97e16ab95 100644 --- a/pages.es/android/wm.md +++ b/pages.es/android/wm.md @@ -6,8 +6,8 @@ - Muestra el tamaño físico de la pantalla de un dispositivo Android: -`wm {{tamaño}}` +`wm size` - Muestra la densidad física de la pantalla de un dispositivo Android: -`wm {{densidad}}` +`wm density` diff --git a/pages.es/common/2to3.md b/pages.es/common/2to3.md index 1c2c32746..600d4503f 100644 --- a/pages.es/common/2to3.md +++ b/pages.es/common/2to3.md @@ -13,11 +13,11 @@ - Convierte funciones específicas del lenguaje Python 2 a Python 3: -`2to3 --write {{ruta/a/archivo.py}} --fix={{raw_input}} --fix={{print}}` +`2to3 --write {{ruta/a/archivo.py}} --fix {{raw_input}} --fix {{print}}` - Convierte todas las funciones del lenguaje Python 2 excepto las especificadas a Python 3: -`2to3 --write {{ruta/a/archivo.py}} --nofix={{has_key}} --nofix={{isinstance}}` +`2to3 --write {{ruta/a/archivo.py}} --nofix {{has_key}} --nofix {{isinstance}}` - Muestra una lista de todas las características disponibles del lenguaje que se pueden convertir de Python 2 a Python 3: @@ -25,8 +25,8 @@ - Convierte todos los archivos Python 2 en un directorio a Python 3: -`2to3 --output-dir={{ruta/a/directorio_python3}} --write-unchanged-files --nobackups {{ruta/a/directorio_python2}}` +`2to3 --output-dir {{ruta/a/directorio_python3}} --write-unchanged-files --nobackups {{ruta/a/directorio_python2}}` - Ejecuta 2to3 con varios subprocesos: -`2to3 --processes={{1..infinity}} --output-dir={{ruta/a/directorio_python3}} --write --nobackups --no-diff {{ruta/a/directorio_python2}}` +`2to3 --processes {{1..infinity}} --output-dir {{ruta/a/directorio_python3}} --write --nobackups --no-diff {{ruta/a/directorio_python2}}` diff --git a/pages.es/common/7z.md b/pages.es/common/7z.md index e7412003a..655dc98b0 100644 --- a/pages.es/common/7z.md +++ b/pages.es/common/7z.md @@ -3,30 +3,34 @@ > Un compresor de archivos con un alto ratio de compresión. > Más información: . -- Comprime un archivo o un directorio: +- [a]ñade un fichero o directorio a un archivo comprimido nuevo o existente: `7z a {{archivo_comprimido.7z}} {{ruta/al/archivo_o_directorio_a_comprimir}}` -- Encripta un archivo comprimido existente (incluyendo cabeceras): +- Encripta un archivo comprimido existente (incluyendo los nombres de los archivos): `7z a {{archivo_encriptado.7z}} -p{{contraseña}} -mhe=on {{archivo_comprimido.7z}}` -- Extrae un archivo comprimido en formato `.7z` con la estructura original que tenía antes de comprimir: +- E[x]trae un archivo comprimido preservando la estructura de directorios original: `7z x {{archivo_comprimido.7z}}` -- Extrae un archivo comprimido en una ruta definida por el usuario: +- E[x]trae un archivo comprimido a un directorio específico: -`7z x {{archivo_comprimido.7z}} -o {{ruta/donde/extraer}}` +`7z x {{archivo_comprimido.7z}} -o{{ruta/donde/extraer}}` -- Extrae un archivo comprimido a `stdout`: +- E[x]trae un archivo comprimido a `stdout`: `7z x {{archivo_comprimido.7z}} -so` -- Comprime usando un tipo de archivo comprimido específico: +- [a]rchiva usando un tipo de archivo comprimido específico: `7z a -t{{7z|bzip2|gzip|lzip|tar|zip}} {{archivo_comprimido}} {{ruta/al/archivo_o_directorio_a_comprimir}}` - Lista el contenido de un archivo comprimido: `7z l {{archivo_comprimido.7z}}` + +- Establece el nivel de compresión (entre mayor sea este, la compresión será más lenta): + +`7z a {{ruta/al/archivo_comprimido.7z}} -mx={{0|1|3|5|7|9}} {{ruta/al/archivo_o_directorio_a_comprimir}}` diff --git a/pages.es/common/7zr.md b/pages.es/common/7zr.md index 301d57438..ee19d606c 100644 --- a/pages.es/common/7zr.md +++ b/pages.es/common/7zr.md @@ -1,7 +1,7 @@ # 7zr > Archivador de ficheros con un alto ratio de compresión. -> Similar a `7z` excepto que sólo soporta ficheros `.7z`. +> Similar a `7z` excepto que sólo soporta ficheros 7z. > Más información: . - [a]rchiva un archivo o directorio: diff --git a/pages.es/common/ack.md b/pages.es/common/ack.md index a9a55f56f..04beae08a 100644 --- a/pages.es/common/ack.md +++ b/pages.es/common/ack.md @@ -18,11 +18,11 @@ - Limita la búsqueda a archivos de un tipo específico: -`ack --type={{ruby}} "{{patrón_de_búsqueda}}"` +`ack --type {{ruby}} "{{patrón_de_búsqueda}}"` - Busca archivos que no sean de un cierto tipo: -`ack --type=no{{ruby}} "{{patrón_de_búsqueda}}"` +`ack --type no{{ruby}} "{{patrón_de_búsqueda}}"` - Cuenta el número total de coincidencias encontradas: diff --git a/pages.es/common/act.md b/pages.es/common/act.md index 56dd70f03..b44a70c8d 100644 --- a/pages.es/common/act.md +++ b/pages.es/common/act.md @@ -17,7 +17,7 @@ - Ejecuta una acción específica: -`act -a {{action_id}}` +`act -a {{identificador_de_acción}}` - Simula una acción: diff --git a/pages.es/common/adb-logcat.md b/pages.es/common/adb-logcat.md index 2c0079959..60f91fa62 100644 --- a/pages.es/common/adb-logcat.md +++ b/pages.es/common/adb-logcat.md @@ -7,15 +7,15 @@ `adb logcat` -- Muestra las líneas que coinciden con una expresión regular: +- Muestra las líneas que coincidan con una expresión regular: -`adb logcat -e {{expresion_regular}}` +`adb logcat -e {{expresión_regular}}` -- Muestra los registros de una etiqueta en un modo específico ([V]erbose, [D]ebug, [I]nfo, [W]arning, [E]rror, [F]atal, [S]ilent), filtrando otras etiquetas: +- Muestra los registros de una etiqueta en un modo específico ([V]erboso, [D]epuración, [I]nformación, [W]arning, [E]rror, [F]atal, [S]ilencioso), filtrando otras etiquetas: `adb logcat {{etiqueta}}:{{modo}} *:S` -- Muestra los registros de aplicaciones React Native en modo [V]erbose [S]ilencing otras etiquetas: +- Muestra los registros de aplicaciones React Native en modo [V]erboso [S]ilenciando otras etiquetas: `adb logcat ReactNative:V ReactNativeJS:V *:S` @@ -25,12 +25,12 @@ - Muestra los registros de un proceso específico: -`adb logcat --pid={{pid}}` +`adb logcat --pid {{pid}}` - Muestra los registros del proceso de un paquete específico: -`adb logcat --pid=$(adb shell pidof -s {{paquete}})` +`adb logcat --pid $(adb shell pidof -s {{paquete}})` -- Colorea el registro (normalmente se utiliza con filtros): +- Colorea el registro (normalmente se usan filtros): `adb logcat -v color` diff --git a/pages.es/common/alacritty.md b/pages.es/common/alacritty.md index bf269c1f0..88f5fc7e0 100644 --- a/pages.es/common/alacritty.md +++ b/pages.es/common/alacritty.md @@ -15,10 +15,10 @@ `alacritty -e {{comando}}` -- Especifica un archivo de configuración alternativo (por defecto es `$XDG_CONFIG_HOME/alacritty/alacritty.yml`): +- Especifica un archivo de configuración alternativo (por defecto es `$XDG_CONFIG_HOME/alacritty/alacritty.toml`): -`alacritty --config-file {{ruta/al/config.yml}}` +`alacritty --config-file {{ruta/al/config.toml}}` -- Ejecuta con recarga automática de la configuración activada (puede activarse por defecto en `alacritty.yml`): +- Ejecuta con recarga automática de la configuración activada (puede activarse por defecto en `alacritty.toml`): -`alacritty --live-config-reload --config-file {{ruta/al/config.yml}}` +`alacritty --live-config-reload --config-file {{ruta/al/config.toml}}` diff --git a/pages.es/common/amass-db.md b/pages.es/common/amass-db.md deleted file mode 100644 index 134f59d48..000000000 --- a/pages.es/common/amass-db.md +++ /dev/null @@ -1,20 +0,0 @@ -# amass db - -> Interactúa con una base de datos Amass. -> Más información: . - -- Lista de todas las enumeraciones realizadas en la base de datos: - -`amass db -dir {{ruta/al/directorio_base_de_datos}} -list` - -- Muestra resultados para un índice de enumeración y un nombre de dominio especificados: - -`amass db -dir {{ruta/al/directorio_base_de_datos}} -d {{nombre_dominio}} -enum {{indice_de_lista}} -show` - -- Lista todos los subdominios encontrados en un dominio dentro de una enumeración: - -`amass db -dir {{ruta/al/directorio_base_de_datos}} -d {{nombre_dominio}} -enum {{indice_de_lista}} -names` - -- Muestra un resumen de los subdominios encontrados dentro de una enumeración: - -`amass db -dir {{ruta/al/directorio_base_de_datos}} -d {{nombre_dominio}} -enum {{indice_de_lista}} -summary` diff --git a/pages.es/common/amass-enum.md b/pages.es/common/amass-enum.md index c29777230..907d56da5 100644 --- a/pages.es/common/amass-enum.md +++ b/pages.es/common/amass-enum.md @@ -1,7 +1,7 @@ # amass enum > Busca subdominios de un dominio. -> Más información: . +> Más información: . - Búsqueda pasiva de subdominios de un dominio: diff --git a/pages.es/common/amass-intel.md b/pages.es/common/amass-intel.md index e1debb489..3e9289a21 100644 --- a/pages.es/common/amass-intel.md +++ b/pages.es/common/amass-intel.md @@ -1,7 +1,7 @@ # amass intel > Recopila información de código abierto sobre una organización, como dominios raíz y ASNs. -> Más información: . +> Más información: . - Encuentra dominios raíz en un rango de direcciones IP específico: diff --git a/pages.es/common/amass.md b/pages.es/common/amass.md index 7889e174d..ee118bbeb 100644 --- a/pages.es/common/amass.md +++ b/pages.es/common/amass.md @@ -1,20 +1,20 @@ # amass > Herramienta de mapeo de superficie de ataque en profundidad y descubrimiento de activos. -> Algunos subcomandos como `amass db` tienen su propia documentación de uso. -> Más información: . +> Algunos subcomandos como `amass intel` tienen su propia documentación de uso. +> Más información: . - Ejecuta un subcomando Amass: -`amass {{subcommand}}` +`amass {{intel|enum}} {{options}}` - Muestra ayuda: `amass -help` -- Muestra ayuda sobre un subcomando de Amass (como `intel`, `enum`, etc.): +- Muestra ayuda sobre un subcomando de Amass: -`amass -help {{subcommand}}` +`amass {{intel|enum}} -help` - Muestra la versión: diff --git a/pages.es/common/ansible.md b/pages.es/common/ansible.md new file mode 100644 index 000000000..bfffca581 --- /dev/null +++ b/pages.es/common/ansible.md @@ -0,0 +1,33 @@ +# ansible + +> Gestiona grupos de ordenadores de forma remota a través de SSH. (usa el fichero `/etc/ansible/hosts` para añadir nuevos grupos de hosts). +> Algunos subcomandos como `ansible galaxy` tienen su propia documentación. +> Más información: . + +- Lista los hosts pertenecientes a un grupo: + +`ansible {{grupo}} --list-hosts` + +- Hace ping a un grupo de hosts invocando al módulo ping: + +`ansible {{grupo}} -m ping` + +- Muestra información sobre un grupo de hosts invocando al módulo setup: + +`ansible {{grupo}} -m setup` + +- Ejecuta un comando en un grupo de hosts invocando el módulo de command con argumentos: + +`ansible {{grupo}} -m command -a '{{mi_comando}}'` + +- Ejecuta un comando con privilegios administrativos: + +`ansible {{grupo}} --become --ask-become-pass -m command -a '{{mi_comando}}'` + +- Ejecuta un comando utilizando un archivo de inventario personalizado: + +`ansible {{grupo}} -i {{archivo_de_inventario}} -m command -a '{{mi_comando}}'` + +- Lista los grupos de un inventario: + +`ansible localhost -m debug -a '{{var=groups.keys()}}'` diff --git a/pages.es/common/ansiweather.md b/pages.es/common/ansiweather.md index b1eed0fea..fbbd00af6 100644 --- a/pages.es/common/ansiweather.md +++ b/pages.es/common/ansiweather.md @@ -3,14 +3,14 @@ > Un script de shell para mostrar las condiciones meteorológicas actuales en tu terminal. > Más información: . -- Muestra una previsión en unidades métricas para los próximos cinco días en Rzeszow, Polonia: +- Muestra una previsión usando unidades métricas de los siguientes siete días de una ubicación: -`ansiweather -u {{metric}} -f {{5}} -l {{Rzeszow,PL}}` +`ansiweather -u metric -f 7 -l {{Rzeszow,PL}}` -- Muestra una previsión con símbolos y datos de la luz del día dada tu ubicación actual: +- Muestra una previsión de los siguientes cinco días con símbolos e información de luz diurna de tu ubicación actual: -`ansiweather -s {{true}} -d {{true}}` +`ansiweather -F -s true -d true` -- Muestra una previsión con los datos de viento y humedad dada tu ubicación actual: +- Muestra una previsión con los datos de viento y humedad de tu ubicación actual: -`ansiweather -w {{true}} -h {{true}}` +`ansiweather -w true -h true` diff --git a/pages.es/common/archwiki-rs.md b/pages.es/common/archwiki-rs.md new file mode 100644 index 000000000..acca757f7 --- /dev/null +++ b/pages.es/common/archwiki-rs.md @@ -0,0 +1,20 @@ +# archwiki-rs + +> Lee, busca y descarga páginas de la ArchWiki. +> Más información: . + +- Lee una página de la ArchWiki: + +`archwiki-rs read-page {{título_de_página}}` + +- Lee una página de la ArchWiki en el formato especificado: + +`archwiki-rs read-page {{título_de_página}} --format {{plain-text|markdown|html}}` + +- Busca páginas en ArchWiki con el texto proporcionado: + +`archwiki-rs search "{{texto_a_buscar}}" --text-search` + +- Descarga una copia local de todas las páginas de ArchWiki en un directorio específico: + +`archwiki-rs local-wiki {{ruta/a/wiki_local}} --format {{plain-text|markdown|html}}` diff --git a/pages.es/common/argocd-app.md b/pages.es/common/argocd-app.md index 1b990af2d..53ab0355d 100644 --- a/pages.es/common/argocd-app.md +++ b/pages.es/common/argocd-app.md @@ -33,4 +33,4 @@ - Retrocede la aplicación a una versión anterior desplegada por ID de historial (eliminando recursos inesperados): -`argocd app rollback {{nombre_de_la_aplicacion}} {{history_id}} --prune` +`argocd app rollback {{nombre_de_la_aplicacion}} {{identificador_de_historial}} --prune` diff --git a/pages.es/common/aria2c.md b/pages.es/common/aria2c.md index e650ca176..d0e59b096 100644 --- a/pages.es/common/aria2c.md +++ b/pages.es/common/aria2c.md @@ -10,28 +10,28 @@ - Descarga un archivo de una URI con un nombre de salida específico: -`aria2c --out={{ruta/al/archivo}} "{{url}}"` +`aria2c --out {{ruta/al/archivo}} "{{url}}"` - Descarga varios archivos diferentes en paralelo: `aria2c --force-sequential {{false}} "{{url1 url2 ...}}"` -- Descarga desde múltiples fuentes con cada URI apuntando al mismo archivo: +- Descarga el mismo archivo desde diferentes espejos y verifica la suma de comprobación del archivo descargado: -`aria2c "{{url1 url2 ...}}"` +`aria2c --checksum {{sha-256}}={{suma_de_comprobación}} "{{url1}}" "{{url2}}" "{{urlN}}"` - Descarga las URI enumeradas en un archivo con un número determinado de descargas paralelas: -`aria2c --input-file={{ruta/al/archivo}} --max-concurrent-downloads={{numero_de_descargas}}` +`aria2c --input-file {{ruta/al/archivo}} --max-concurrent-downloads {{número_de_descargas}}` - Descarga con varias conexiones: -`aria2c --split={{numero_de_conexiones}} "{{url}}"` +`aria2c --split {{número_de_conexiones}} "{{url}}"` -- Descarga FTP con nombre de usuario y contraseña: +- Descarga a través de FTP con un nombre de usuario y contraseña: -`aria2c --ftp-user={{nombre_usuario}} --ftp-passwd={{contrasena}} "{{url}}"` +`aria2c --ftp-user {{nombre_usuario}} --ftp-passwd {{contraseña}} "{{url}}"` - Limita la velocidad de descarga en bytes por segundo: -`aria2c --max-download-limit={{velocidad}} "{{url}}"` +`aria2c --max-download-limit {{velocidad}} "{{url}}"` diff --git a/pages.es/common/arp.md b/pages.es/common/arp.md new file mode 100644 index 000000000..e2863f239 --- /dev/null +++ b/pages.es/common/arp.md @@ -0,0 +1,16 @@ +# arp + +> Muestra y manipula la caché ARP del sistema. +> Más información: . + +- Muestra la tabla ARP actual: + +`arp -a` + +- Borra una entrada específica: + +`arp -d {{dirección}}` + +- Añade una nueva entrada en la tabla ARP: + +`arp -s {{dirección}} {{dirección_mac}}` diff --git a/pages.es/common/asciidoctor.md b/pages.es/common/asciidoctor.md index e1e5d9fcc..719daa90c 100644 --- a/pages.es/common/asciidoctor.md +++ b/pages.es/common/asciidoctor.md @@ -9,7 +9,7 @@ - Convierte un archivo `.adoc` específico a HTML y vincula una hoja de estilos CSS: -`asciidoctor -a stylesheet={{ruta/al/stylesheet.css}} {{ruta/al/archivo.adoc}}` +`asciidoctor -a stylesheet {{ruta/al/stylesheet.css}} {{ruta/al/archivo.adoc}}` - Convierte un archivo específico `.adoc` en HTML incrustable, eliminando todo excepto el cuerpo: @@ -17,4 +17,4 @@ - Convierte un archivo `.adoc` dado en un PDF utilizando la biblioteca `asciidoctor-pdf`: -`asciidoctor --backend={{pdf}} --require={{asciidoctor-pdf}} {{ruta/al/archivo.adoc}}` +`asciidoctor --backend {{pdf}} --require {{asciidoctor-pdf}} {{ruta/al/archivo.adoc}}` diff --git a/pages.es/common/asciinema.md b/pages.es/common/asciinema.md index e3ed029a5..ab5669c8a 100644 --- a/pages.es/common/asciinema.md +++ b/pages.es/common/asciinema.md @@ -21,7 +21,7 @@ - Reproduce una grabación desde asciinema.org: -`asciinema play https://asciinema.org/a/{{grabación_id}}` +`asciinema play https://asciinema.org/a/{{identificador_de_grabación}}` - Crea una nueva grabación, limitando el tiempo de espera máximo a 2.5 segundos: diff --git a/pages.es/common/audtool.md b/pages.es/common/audtool.md new file mode 100644 index 000000000..8c0f3bb84 --- /dev/null +++ b/pages.es/common/audtool.md @@ -0,0 +1,36 @@ +# audtool + +> Controla Audacious usando comandos. +> Más información: . + +- Reproduce/pausa la reproducción de audio: + +`audtool playback-playpause` + +- Imprime el nombre del artista, el álbum y la canción que se está reproduciendo: + +`audtool current-song` + +- Ajusta el volumen de la reproducción de audio: + +`audtool set-volume {{100}}` + +- Salta a la siguiente canción: + +`audtool playlist-advance` + +- Imprime la tasa de bits de la canción actual en kilobits: + +`audtool current-song-bitrate-kbps` + +- Abre Audacious en pantalla completa si está oculto: + +`audtool mainwin-show` + +- Muestra ayuda: + +`audtool help` + +- Muestra configuración: + +`audtool preferences-show` diff --git a/pages.es/common/autossh.md b/pages.es/common/autossh.md index 9c85dd0fe..596ef95a3 100644 --- a/pages.es/common/autossh.md +++ b/pages.es/common/autossh.md @@ -1,7 +1,7 @@ # autossh > Ejecuta, monitorea y reinicia conexiones SSH. -> Auto-reconecta para mantener los túneles de reenvío de puertos. Acepta todas las señales `ssh`. +> Auto-reconecta para mantener los túneles de reenvío de puertos. Acepta todas las señales SSH. > Más información: . - Inicia una sesión SSH, reiniciando cuando un puerto de monitoreo no retorna datos: @@ -12,7 +12,7 @@ `autossh -M {{puerto_monitor}} -L {{puerto_local}}:localhost:{{puerto_remoto}} {{usuario}}@{{host}}` -- Crea un proceso `autossh` en segundo plano antes de ejecutar `ssh` y no abre un shell remoto: +- Crea un proceso `autossh` en segundo plano antes de ejecutar SSH y no abre un shell remoto: `autossh -f -M {{puerto_monitor}} -N "{{comando_ssh}}"` @@ -24,6 +24,6 @@ `autossh -f -M 0 -N -o "ServerAliveInterval 10" -o "ServerAliveCountMax 3" -o ExitOnForwardFailure=yes -L {{local_port}}:localhost:{{puerto_remoto}} {{usuario}}@{{host}}` -- Se ejecuta en segundo plano, registrando la salida de depuración `autossh` y la salida detallada `ssh` en archivos: +- Se ejecuta en segundo plano, registrando la salida de depuración `autossh` y la salida detallada SSH en archivos: `AUTOSSH_DEBUG=1 AUTOSSH_LOGFILE={{ruta/al/autossh_log_file.log}} autossh -f -M {{puerto_monitor}} -v -E {{ruta/al/archivo_ssh_log.log}} {{comando_ssh}}` diff --git a/pages.es/common/aws-codecommit.md b/pages.es/common/aws-codecommit.md index e2cd3f9a6..37966fce9 100644 --- a/pages.es/common/aws-codecommit.md +++ b/pages.es/common/aws-codecommit.md @@ -1,12 +1,12 @@ # aws codecommit -> AWS CodeCommit es un servicio de control de origen administrado que aloja repositorios Git privados. +> Un servicio de control de versión capaz de alojar repositorios de Git privados. > Más información: . -- Muestra la ayuda para un comando específico: - -`aws codecommit {{comando}} help` - -- Muestra la ayuda: +- Muestra ayuda: `aws codecommit help` + +- Muestra ayuda de un comando: + +`aws codecommit {{comando}} help` diff --git a/pages.es/common/aws-cognito-idp.md b/pages.es/common/aws-cognito-idp.md index 3215d6663..95c0c7bed 100644 --- a/pages.es/common/aws-cognito-idp.md +++ b/pages.es/common/aws-cognito-idp.md @@ -13,16 +13,16 @@ - Elimina un grupo de usuarios específico: -`aws cognito-idp delete-user-pool --user-pool-id {{user_pool_id}}` +`aws cognito-idp delete-user-pool --user-pool-id {{identificador_de_pool}}` - Crea un usuario en un grupo específico: -`aws cognito-idp admin-create-user --username {{nombre_usuario}} --user-pool-id {{user_pool_id}}` +`aws cognito-idp admin-create-user --username {{nombre_usuario}} --user-pool-id {{identificador_de_pool}}` - Lista los usuarios de un pool específico: -`aws cognito-idp list-users --user-pool-id {{user_pool_id}}` +`aws cognito-idp list-users --user-pool-id {{identificador_de_pool}}` - Elimina un usuario de un grupo específico: -`aws cognito-idp admin-delete-user --username {{nombre_usuario}} --user-pool-id {{user_pool_id}}` +`aws cognito-idp admin-delete-user --username {{nombre_usuario}} --user-pool-id {{identificador_de_pool}}` diff --git a/pages.es/common/aws-ec2.md b/pages.es/common/aws-ec2.md index 55a31f0f5..2c08fb006 100644 --- a/pages.es/common/aws-ec2.md +++ b/pages.es/common/aws-ec2.md @@ -6,7 +6,7 @@ - Muestra información acerca de una instancia específica: -`aws ec2 describe-instances --instance-ids {{id_instancia}}` +`aws ec2 describe-instances --instance-ids {{identificador_de_instancia}}` - Muestra información sobre todas las instancias: @@ -18,11 +18,11 @@ - Elimina un volumen EC2: -`aws ec2 delete-volume --volume-id {{id_volumen}}` +`aws ec2 delete-volume --volume-id {{identificador_de_volumen}}` - Crea una instantánea a partir de un volumen EC2: -`aws ec2 create-snapshot --volume-id {{id_volumen}}` +`aws ec2 create-snapshot --volume-id {{identificador_de_volumen}}` - Lista las imágenes de máquina de Amazon disponibles (AMI): diff --git a/pages.es/common/aws-iam.md b/pages.es/common/aws-iam.md index aa650603b..01df6c4b5 100644 --- a/pages.es/common/aws-iam.md +++ b/pages.es/common/aws-iam.md @@ -1,12 +1,8 @@ # aws iam -> CLI para AWS IAM. +> Interactúa con el Manejo de Identidad y Acceso (o "IAM" en inglés), un servicio web para controlar seguramente el acceso a servicios de AWS. > Más información: . -- Muestra la página de ayuda de `aws iam` (incluyendo todos los comandos iam disponibles): - -`aws iam help` - - Lista usuarios: `aws iam list-users` @@ -19,13 +15,13 @@ `aws iam list-groups` -- Obtén los usuarios de un grupo: +- Obtén los usuarios en un grupo: -`aws iam get-group --group-name {{nombre_grupo}}` +`aws iam get-group --group-name {{nombre_del_grupo}}` - Describe una política IAM: -`aws iam get-policy --policy-arn arn:aws:iam::aws:policy/{{nombre_de_politica}}` +`aws iam get-policy --policy-arn arn:aws:iam::aws:policy/{{nombre_de_política}}` - Lista claves de acceso: @@ -33,4 +29,8 @@ - Lista claves de acceso para un usuario específico: -`aws iam list-access-keys --user-name {{nombre_usuario}}` +`aws iam list-access-keys --user-name {{nombre_de_usuario}}` + +- Muestra ayuda: + +`aws iam help` diff --git a/pages.es/common/aws-route53.md b/pages.es/common/aws-route53.md index 91dae9292..07f6797da 100644 --- a/pages.es/common/aws-route53.md +++ b/pages.es/common/aws-route53.md @@ -9,16 +9,16 @@ - Muestra todos los registros de una zona: -`aws route53 list-resource-record-sets --hosted-zone-id {{zone_id}}` +`aws route53 list-resource-record-sets --hosted-zone-id {{identificador_de_zona}}` - Crea una nueva zona pública utilizando un identificador de solicitud para reintentar la operación de forma segura: -`aws route53 create-hosted-zone --name {{nombre}} --caller-reference {{identificador_solicitud}}` +`aws route53 create-hosted-zone --name {{nombre}} --caller-reference {{identificador_de_solicitud}}` - Elimina una zona (si la zona tiene registros SOA y NS no predeterminados, el comando fallará): -`aws route53 delete-hosted-zone --id {{zone_id}}` +`aws route53 delete-hosted-zone --id {{identificador_de_zona}}` - Prueba la resolución DNS por parte de los servidores de Amazon de una zona determinada: -`aws route53 test-dns-answer --hosted-zone-id {{zone_id}} --record-name {{nombre}} --record-type {{tipo}}` +`aws route53 test-dns-answer --hosted-zone-id {{identificador_de_zona}} --record-name {{nombre}} --record-type {{tipo}}` diff --git a/pages.es/common/az-account.md b/pages.es/common/az-account.md index d28627464..51de18d9d 100644 --- a/pages.es/common/az-account.md +++ b/pages.es/common/az-account.md @@ -10,7 +10,7 @@ - Establece una `subscription` como la suscripción activa: -`az account set --subscription {{id_de_suscripción}}` +`az account set --subscription {{identificador_de_suscripción}}` - Lista las regiones admitidas para la suscripción activa: diff --git a/pages.es/common/az-tag.md b/pages.es/common/az-tag.md index 41d3c8856..38f15dfdc 100644 --- a/pages.es/common/az-tag.md +++ b/pages.es/common/az-tag.md @@ -18,7 +18,7 @@ - Enumera todas las etiquetas de una suscripción: -`az tag list --resource-id /subscriptions/{{subscription_id}}` +`az tag list --resource-id /subscriptions/{{identificador_de_subscripción}}` - Elimina un valor de etiqueta para un nombre de etiqueta específico: diff --git a/pages.es/common/az-vm.md b/pages.es/common/az-vm.md index f029e27f2..d87613801 100644 --- a/pages.es/common/az-vm.md +++ b/pages.es/common/az-vm.md @@ -8,7 +8,7 @@ `az vm list` -- Crea una máquina virtual usando la imagen por defecto de Ubuntu y genera claves ssh: +- Crea una máquina virtual usando la imagen por defecto de Ubuntu y genera claves SSH: `az vm create --resource-group {{grupo_de_recursos}} --name {{nombre}} --image {{UbuntuLTS}} --admin-user {{usuario_azure}} --generate-ssh-keys` diff --git a/pages.es/common/bc.md b/pages.es/common/bc.md index 4d36ffc2b..8ca86676f 100644 --- a/pages.es/common/bc.md +++ b/pages.es/common/bc.md @@ -2,7 +2,7 @@ > Un lenguaje de calculadora de precisión arbitraria. > Vea también: `dc`. -> Más información: . +> Más información: . - Inicia una sesión interactiva: diff --git a/pages.es/common/bmptoppm.md b/pages.es/common/bmptoppm.md new file mode 100644 index 000000000..8e2faf051 --- /dev/null +++ b/pages.es/common/bmptoppm.md @@ -0,0 +1,8 @@ +# bmptoppm + +> Este comando es reemplazado por `bmptopnm`. +> Más información: . + +- Ve documentación del comando actual: + +`tldr bmptopnm` diff --git a/pages.es/common/bpkg.md b/pages.es/common/bpkg.md new file mode 100644 index 000000000..3d7c13360 --- /dev/null +++ b/pages.es/common/bpkg.md @@ -0,0 +1,28 @@ +# bpkg + +> Un gestor de paquetes para scripts Bash. +> Más información: . + +- Actualiza el índice local: + +`bpkg update` + +- Instala un paquete globalmente: + +`bpkg install --global {{paquete}}` + +- Instala un paquete en un subdirectorio del directorio actual: + +`bpkg install {{paquete}}` + +- Instala una versión específica de un paquete de forma global: + +`bpkg install {{paquete}}@{{versión}} -g` + +- Muestra detalles sobre un paquete específico: + +`bpkg show {{paquete}}` + +- Ejecuta un comando, especificando opcionalmente sus argumentos: + +`bpkg run {{comando}} {{argumento1 argumento2 ...}}` diff --git a/pages.es/common/bpytop.md b/pages.es/common/bpytop.md index 305f289de..6472061bd 100644 --- a/pages.es/common/bpytop.md +++ b/pages.es/common/bpytop.md @@ -1,28 +1,29 @@ # bpytop -> Muestra información en tiempo real sobre procesos ejecutándose, con gráficos. Similar a `gtop` y `htop`. +> Un monitor de recursos que muestra información sobre el CPU, la memoria, los discos, las redes y los procesos. +> Una versión de `bashtop` en Python. > Más información: . -- Inicia bpytop: +- Inicia `bpytop`: `bpytop` -- Inicia en modo mínimalista sin recuadros de memoria y redes: +- Inicia en el modo mínimo sin los recuadros de memoria y redes: `bpytop -m` +- Cambia a el modo mínimo: + +`m` + +- Busca procesos o programas en ejecución: + +`f` + +- Cambia los ajustes: + +`M` + - Muestra la versión: `bpytop -v` - -- Cambia a modo minimalista: - -`m` - -- Busca procesos o programas ejecutándose: - -`f` - -- Cambia ajustes: - -`M` diff --git a/pages.es/common/bru.md b/pages.es/common/bru.md index a5ed85d2f..21801ba51 100644 --- a/pages.es/common/bru.md +++ b/pages.es/common/bru.md @@ -1,7 +1,7 @@ # bru > CLI para Bruno, un IDE de código abierto para explorar y probar APIs. -> Más información: . +> Más información: . - Ejecuta todos los archivos de petición en el directorio actual: diff --git a/pages.es/common/cat.md b/pages.es/common/cat.md index 5d6724f39..ebe241b0c 100644 --- a/pages.es/common/cat.md +++ b/pages.es/common/cat.md @@ -1,16 +1,24 @@ # cat > Imprime y concatena archivos. -> Más información: . +> Más información: . -- Imprime el contenido de un archivo por la salida estándar: +- Imprime el contenido de un fichero a `stdout`: -`cat {{archivo}}` +`cat {{ruta/al/archivo}}` -- Concatena múltiples archivos dentro de un archivo determinado: +- Concatena varios archivos en un archivo de salida: -`cat {{archivo1 archivo2 ...}} > {{archivo_final}}` +`cat {{ruta/al/archivo1 ruta/al/archivo2 ...}} > {{ruta/al/archivo_salida}}` -- Añade múltiples archivos dentro de un archivo determinado: +- Añade el contenido de varios archivos a un archivo de salida: -`cat {{archivo1 archivo2 ...}} >> {{archivo_final}}` +`cat {{ruta/al/archivo1 ruta/al/archivo2 ...}} >> {{ruta/al/archivo_salida}}` + +- Copia el contenido de un archivo en un archivo de salida sin almacenamiento en el búfer: + +`cat -u {{/dev/tty12}} > {{/dev/tty13}}` + +- Copia `stdin` en un archivo: + +`cat - > {{ruta/al/archivo}}` diff --git a/pages.es/common/colima.md b/pages.es/common/colima.md new file mode 100644 index 000000000..3c6503c2e --- /dev/null +++ b/pages.es/common/colima.md @@ -0,0 +1,36 @@ +# colima + +> Contenedores en tiempo de ejecución para macOS y Linux con una configuración mínima. +> Más información: . + +- Inicia el daemon en segundo plano: + +`colima start` + +- Crea un archivo de configuración y lo usa: + +`colima start --edit` + +- Inicia y configura containerd (instala `nerdctl` para usar containerd a través de `nerdctl`): + +`colima start --runtime containerd` + +- Inicia con Kubernetes (se requiere `kubectl`): + +`colima start --kubernetes` + +- Personaliza el recuento de CPU, memoria RAM y espacio en disco (en GiB): + +`colima start --cpu {{número}} --memory {{memoria}} --disk {{espacio_de_almacenamiento}}` + +- Usa Docker a través de Colima (se requiere Docker): + +`colima start` + +- Lista contenedores con su información y estado: + +`colima list` + +- Muestra estado de tiempo de ejecución: + +`colima status` diff --git a/pages.es/common/cut.md b/pages.es/common/cut.md index c44b1b0c2..066aff17c 100644 --- a/pages.es/common/cut.md +++ b/pages.es/common/cut.md @@ -5,12 +5,12 @@ - Imprime un rango específico de caracteres/campos de cada línea: -`{{comando}} | cut --{{characters|field}}={{1|1,10|1-10|1-|-10}}` +`{{comando}} | cut --{{characters|field}} {{1|1,10|1-10|1-|-10}}` - Imprime un rango de campos de cada línea con un delimitador específico: -`{{comando}} | cut --delimiter="{{,}}" --fields={{1}}` +`{{comando}} | cut --delimiter "{{,}}" --fields {{1}}` - Imprime un rango de caracteres de cada línea de un archivo específico: -`cut --characters={{1}} {{ruta/al/archivo}}` +`cut --characters {{1}} {{ruta/al/archivo}}` diff --git a/pages.es/common/d2.md b/pages.es/common/d2.md new file mode 100644 index 000000000..9f31f504b --- /dev/null +++ b/pages.es/common/d2.md @@ -0,0 +1,29 @@ +# d2 + +> Un lenguaje moderno de scripting de diagramas que convierte texto en diagramas. +> Nota: el archivo de salida admite formatos de archivo SVG y PNG. +> Más información: . + +- Compila y renderiza un archivo fuente D2 en un archivo de salida: + +`d2 {{ruta/al/archivo_de_entrada.d2}} {{ruta/al/archivo_de_salida.ext}}` + +- Ve en directo los cambios realizados en un archivo fuente D2 en el navegador web predeterminado: + +`d2 --watch {{ruta/al/archivo_de_entrada.d2}} {{ruta/al/archivo_de_salida.ext}}` + +- Formatea un archivo fuente D2: + +`d2 fmt {{ruta/al/archivo_de_entrada.d2}}` + +- Lista los temas disponibles: + +`d2 themes` + +- Usa un [t]ema diferente para el archivo de salida (primero enumera los temas disponibles para obtener el `theme_id` deseado): + +`d2 --theme {{identificador_tema}} {{ruta/al/archivo_de_entrada.d2}} {{ruta/al/archivo_de_salida.ext}}` + +- Haz que los diagramas renderizados parezcan bocetos hechos a mano: + +`d2 --sketch true {{ruta/al/archivo_de_entrada.d2}} {{ruta/al/archivo_de_salida.ext}}` diff --git a/pages.es/common/devenv.md b/pages.es/common/devenv.md new file mode 100644 index 000000000..74a677410 --- /dev/null +++ b/pages.es/common/devenv.md @@ -0,0 +1,28 @@ +# devenv + +> Entornos de desarrollo rápidos, declarativos, reproducibles y componibles utilizando Nix. +> Más información: . + +- Inicializa el entorno: + +`devenv init` + +- Entra en el entorno de desarrollo con hermeticidad relajada (estado de ser hermético): + +`devenv shell --impure` + +- Obtén información detallada sobre el entorno actual: + +`devenv info --verbose` + +- Inicia procesos con `devenv`: + +`devenv up --config /{{archivo}}/{{ruta}}/` + +- Limpia las variables de entorno y vuelve a entrar en el intérprete de comandos en el modo sin conexión: + +`devenv --clean --offline` + +- Borra las generaciones anteriores del intérprete de comandos: + +`devenv gc` diff --git a/pages.es/common/diff.md b/pages.es/common/diff.md new file mode 100644 index 000000000..7bf58482e --- /dev/null +++ b/pages.es/common/diff.md @@ -0,0 +1,36 @@ +# diff + +> Compara archivos y directorios. +> Más información: . + +- Compara archivos (lista los cambios para convertir `archivo_viejo` en `archivo_nuevo`): + +`diff {{archivo_viejo}} {{archivo_nuevo}}` + +- Compara archivos, ignorando los espacios en blanco: + +`diff {{-w|--ignore-all-space}} {{archivo_viejo}} {{archivo_nuevo}}` + +- Compara archivos, mostrando las diferencias lado a lado: + +`diff {{-y|--side-by-side}} {{archivo_viejo}} {{archivo_nuevo}}` + +- Compara archivos, mostrando las diferencias en formato unificado (como el que usa `git diff`): + +`diff {{-u|--unified}} {{archivo_viejo}} {{archivo_nuevo}}` + +- Compara directorios de forma recursiva (muestra los nombres de los archivos/directorios que difieran y los cambios realizados en los archivos): + +`diff {{-r|--recursive}} {{directorio_viejo}} {{directorio_nuevo}}` + +- Compara directorios, mostrando solo los nombres de los archivos que difieren: + +`diff {{-r|--recursive}} {{-q|--brief}} {{directorio_viejo}} {{directorio_nuevo}}` + +- Crea un archivo de revisión para Git a partir de las diferencias entre dos archivos de texto, tratando los archivos inexistentes como vacíos: + +`diff {{-a|--text}} {{-u|--unified}} {{-N|--new-file}} {{archivo_viejo}} {{archivo_nuevo}} > {{diff.patch}}` + +- Compara archivos, mostrando la salida en color y se esfuerza por encontrar el conjunto más pequeño de cambios: + +`diff {{-d|--minimal}} --color=always {{archivo_viejo}} {{archivo_nuevo}}` diff --git a/pages.es/common/difft.md b/pages.es/common/difft.md new file mode 100644 index 000000000..549d74336 --- /dev/null +++ b/pages.es/common/difft.md @@ -0,0 +1,33 @@ +# difft + +> Compara archivos o directorios en base de la sintaxis del lenguaje de programación. +> Vea también: `delta`, `diff`. +> Más información: . + +- Compara dos archivos o directorios: + +`difft {{ruta/al/archivo_o_directorio1}} {{ruta/al/archivo_o_directorio2}}` + +- Informa únicamente diferencias entre los archivos: + +`difft --check-only {{ruta/al/archivo1}} {{ruta/al/archivo2}}` + +- Especifica el modo de visualización (por defecto es `side-by-side`): + +`difft --display {{side-by-side|side-by-side-show-both|inline|json}} {{ruta/al/archivo1}} {{ruta/al/archivo2}}` + +- Ignora comentarios al comparar: + +`difft --ignore-comments {{ruta/al/archivo1}} {{ruta/al/archivo2}}` + +- Activa o desactiva el resaltado sintáctico del código fuente (por defecto está activado): + +`difft --syntax-highlight {{on|off}} {{ruta/al/archivo1}} {{ruta/al/archivo2}}` + +- Silenciosamente omite los archivos que no hayan cambiado: + +`difft --skip-unchanged {{ruta/al/archivo_o_directorio1}} {{ruta/al/archivo_o_directorio2}}` + +- Lista todos los lenguajes de programación soportados por la herramienta, junto con sus extensiones: + +`difft --list-languages` diff --git a/pages.es/common/dnsx.md b/pages.es/common/dnsx.md new file mode 100644 index 000000000..e0c5dba3f --- /dev/null +++ b/pages.es/common/dnsx.md @@ -0,0 +1,38 @@ +# dnsx + +> Un equipo de herramientas de DNS rápido y multipropósito para ejecutar múltiples consultas DNS. +> Nota: la entrada a `dnsx` necesita ser pasada a través de `stdin` (tubería `|`) en algunos casos. +> Ver también: `dig`, `dog`, `dnstracer`. +> Más información: . + +- Consulta el registro A de un subdominio y muestra la [re]spuesta recibida: + +`echo {{ejemplo.com}} | dnsx -a -re` + +- Consulta todos los registros DNS (A, AAAA, CNAME, NS, TXT, SRV, PTR, MX, SOA, AXFR y CAA): + +`dnsx -recon -re <<< {{ejemplo.com}}` + +- Consulta un tipo específico de registro DNS: + +`echo {{ejemplo.com}} | dnsx -re -{{a|aaaa|cname|ns|txt|srv|ptr|mx|soa|any|axfr|caa}}` + +- Muestra s[o]lo la [r]espuesta (no muestra el dominio o subdominio consultado): + +`echo {{ejemplo.com}} | dnsx -ro` + +- Muestra la respuesta sin procesar una consulta, especificando los solucionado[r]es a utilizar y el número de intentos en caso de haber errores: + +`echo {{ejemplo.com}} | dnsx -{{debug|raw}} -resolver {{1.1.1.1,8.8.8.8,...}} -retry {{número}}` + +- Aplica fuerza bruta a registros DNS utilizando un marcador de posición: + +`dnsx -domain {{FUZZ.ejemplo.com}} -wordlist {{ruta/a/lista_de_palabras.txt}} -re` + +- Aplica fuerza bruta a registros DNS a partir de una lista de [d]ominios y listas de palabras, adjuntando la salida a un archivo sin códigos de [c]olor: + +`dnsx -domain {{ruta/a/dominio.txt}} -wordlist {{ruta/a/lista_de_palabras.txt}} -re -output {{ruta/a/salida.txt}} -no-color` + +- Extrae registros `CNAME` desde una lista de subdominios, con una velocidad [l]ímite de consultas DNS por segundo: + +`subfinder -silent -d {{ejemplo.com}} | dnsx -cname -re -rl {{número}}` diff --git a/pages.es/common/docker-compose.md b/pages.es/common/docker-compose.md index 862fcadcf..9d5410612 100644 --- a/pages.es/common/docker-compose.md +++ b/pages.es/common/docker-compose.md @@ -1,6 +1,6 @@ # docker compose -> Ejecuta y gestiona aplicaciones docker multicontenedor. +> Ejecuta y gestiona aplicaciones Docker multicontenedor. > Más información: . - Lista todos los contenedores en ejecución: diff --git a/pages.es/common/dolt-gc.md b/pages.es/common/dolt-gc.md new file mode 100644 index 000000000..4423667ff --- /dev/null +++ b/pages.es/common/dolt-gc.md @@ -0,0 +1,12 @@ +# dolt gc + +> Busca en el repositorio los datos que ya no se referencian ni necesitan. +> Más información: . + +- Limpia datos no referenciados del repositorio: + +`dolt gc` + +- Inicia un proceso de recolección de basura más rápido pero menos exhaustivo: + +`dolt gc --shallow` diff --git a/pages.es/common/fclones.md b/pages.es/common/fclones.md new file mode 100644 index 000000000..a3c760a18 --- /dev/null +++ b/pages.es/common/fclones.md @@ -0,0 +1,32 @@ +# fclones + +> Eficaz buscador y eliminador de archivos duplicados. +> Más información: . + +- Busca ficheros duplicados en el directorio actual: + +`fclones group .` + +- Busca archivos duplicados en varios directorios y almacena los resultados en la caché: + +`fclones group --cache {{ruta/a/directorio1 ruta/a/directorio2}}` + +- Busca archivos duplicados solo en el directorio especificado, omitiendo los subdirectorios y guarda los resultados en un archivo: + +`fclones group {{ruta/a/directorio}} --depth 1 > {{ruta/al/archivo.txt}}` + +- Mueve los archivos duplicados en un archivo de texto a un directorio diferente: + +`fclones move {{ruta/a/directorio_objetivo}} < {{ruta/al/archivo.txt}}` + +- Simula un enlace simbólico a un archivo de texto sin realmente enlazarlo: + +`fclones link --soft < {{ruta/al/archivo.txt}} --dry-run 2> /dev/null` + +- Elimina los archivos duplicados más recientes en el directorio actual sin almacenarlos en un archivo: + +`fclones group . | fclones remove --priority newest` + +- Preprocesa los archivos JPEG en el directorio actual utilizando un comando externo para eliminar sus datos EXIF antes de buscar duplicados: + +`fclones group . --name '*.jpg' -i --transform 'exiv2 -d a $IN' --in-place` diff --git a/pages.es/common/figlet.md b/pages.es/common/figlet.md index bbc0ca7d0..5bf77a8fa 100644 --- a/pages.es/common/figlet.md +++ b/pages.es/common/figlet.md @@ -1,21 +1,33 @@ # figlet > Genera encabezados usando caracteres ASCII desde la entrada del usuario. -> Véase también `showfigfonts`. +> Vea también `showfigfonts`. > Más información: . - Genera el encabezado directamente introduciendo el texto: `figlet {{texto_de_entrada}}` -- Usa un archivo de fuente personalizada: +- Usa un archivo de [f]uente personalizada: `figlet {{texto_de_entrada}} -f {{ruta/al/archivo_de_fuente.flf}}` -- Use una fuente del directorio predeterminado (la extensión puede ser omitida): +- Usa una [f]uente del directorio predeterminado (la extensión puede ser omitida): `figlet {{texto_de_entrada}} -f {{archivo_de_fuente}}` -- Redirige la salida de un comando hacia figlet: +- Redirige la salida de un comando hacia FIGlet: `{{comando}} | figlet` + +- Muestra las fuentes de FIGlet disponibles: + +`showfigfonts {{texto_opcional_para_mostrar}}` + +- Utiliza el ancho total del [t]erminal y [c]entra el texto de entrada: + +`figlet -t -c {{texto_de_entrada}}` + +- Muestra todos los caracteres utilizando todo su ancho para evitar traslapes: + +`figlet -W {{input_text}}` diff --git a/pages.es/common/fossil-delete.md b/pages.es/common/fossil-delete.md index ae6c3a230..c97ead3d6 100644 --- a/pages.es/common/fossil-delete.md +++ b/pages.es/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > Este comando es un alias de `fossil rm`. > Más información: . diff --git a/pages.es/common/fossil-forget.md b/pages.es/common/fossil-forget.md index b29366af4..ea55390e8 100644 --- a/pages.es/common/fossil-forget.md +++ b/pages.es/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > Este comando es un alias de `fossil rm`. > Más información: . diff --git a/pages.es/common/fossil-new.md b/pages.es/common/fossil-new.md index 5c7ef68b3..b012c64b6 100644 --- a/pages.es/common/fossil-new.md +++ b/pages.es/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> Este comando es un alias de `fossil-init`. +> Este comando es un alias de `fossil init`. > Más información: . - Muestra la documentación del comando original: diff --git a/pages.es/common/gau.md b/pages.es/common/gau.md new file mode 100644 index 000000000..c05ce81b2 --- /dev/null +++ b/pages.es/common/gau.md @@ -0,0 +1,32 @@ +# gau + +> Obtén todas las URLs: obtén las URLs conocidas de Open Threat Exchange de AlienVault, Wayback Machine y Common Crawl para cualquier dominio. +> Más información: . + +- Obtén todas las URLs de un dominio de Open Threat Exchange de AlienVault, Wayback Machine, Common Crawl y URLScan: + +`gau {{ejemplo.com}}` + +- Obtén URLs de varios dominios: + +`gau {{dominio1 dominio2 ...}}` + +- Obtén todas las URLs de varios dominios en un archivo de entrada, ejecutando varios subprocesos: + +`gau --threads {{4}} < {{ruta/a/dominios.txt}}` + +- Escribe los resultados en un archivo: + +`gau {{ejemplo.com}} --o {{ruta/a/urls_encontradas.txt}}` + +- Busca las URLs de un solo proveedor específico: + +`gau --providers {{wayback|commoncrawl|otx|urlscan}} {{ejemplo.com}}` + +- Busca las URLs de varios proveedores: + +`gau --providers {{wayback,otx,...}} {{ejemplo.com}}` + +- Busca las URLs dentro de un intervalo de fechas específico: + +`gau --from {{AAAAMM}} --to {{YYYYMM}} {{ejemplo.com}}` diff --git a/pages.es/common/gh-cs.md b/pages.es/common/gh-cs.md index 30d9a5052..f730680d7 100644 --- a/pages.es/common/gh-cs.md +++ b/pages.es/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> Este comando es un alias de `gh-codespace`. +> Este comando es un alias de `gh codespace`. > Más información: . - Muestra la documentación del comando original: diff --git a/pages.es/common/git-am.md b/pages.es/common/git-am.md index 84a0df040..9eccd24ed 100644 --- a/pages.es/common/git-am.md +++ b/pages.es/common/git-am.md @@ -1,13 +1,17 @@ # git am > Aplica archivos de parche. Útil cuando se reciben commits por correo electrónico. -> Véase también `git format-patch`, comando que genera archivo de parche. +> Vea también `git format-patch`, comando que genera archivos de parche. > Más información: . - Aplica un archivo de parche: `git am {{ruta/al/archivo.patch}}` +- Aplica un archivo de parche remoto: + +`curl -L {{https://ejemplo.com/file.patch}} | git apply` + - Aborta el proceso de aplicar un archivo de parche: `git am --abort` diff --git a/pages.es/common/git-checkout.md b/pages.es/common/git-checkout.md index e463789c4..017bda25e 100644 --- a/pages.es/common/git-checkout.md +++ b/pages.es/common/git-checkout.md @@ -23,7 +23,7 @@ `git checkout --track {{nombre_remoto}}/{{nombre_de_la_rama}}` -- Descarta todos los cambios sin marcar en el directorio actual (véase `git reset` para más comandos para deshacer): +- Descarta todos los cambios sin marcar en el directorio actual (vea `git reset` para más comandos para deshacer): `git checkout .` diff --git a/pages.es/common/git-cherry-pick.md b/pages.es/common/git-cherry-pick.md index 1f438e452..5fbb7ca76 100644 --- a/pages.es/common/git-cherry-pick.md +++ b/pages.es/common/git-cherry-pick.md @@ -8,13 +8,13 @@ `git cherry-pick {{confirmación}}` -- Aplica un rango de confirmaciones de la rama actual (véase también `git rebase --onto`): +- Aplica un rango de confirmaciones de la rama actual (vea también `git rebase --onto`): `git cherry-pick {{confirmación_inicial}}~..{{confirmación_final}}` - Aplica múltiples confirmaciones no secuenciales a la rama actual: -`git cherry-pick {{confirmación_1}} {{confirmación_2}}` +`git cherry-pick {{confirmación_1 confirmación_2 ...}}` - Añade los cambios de una confirmación al directorio de trabajo, sin crear una confirmación: diff --git a/pages.es/common/git-format-patch.md b/pages.es/common/git-format-patch.md index 9fad43762..f16eafe21 100644 --- a/pages.es/common/git-format-patch.md +++ b/pages.es/common/git-format-patch.md @@ -1,7 +1,7 @@ # git format-patch > Prepara archivos .patch. Es útil cuando se envían commits por correo electrónico. -> Véase también `git-am`, comando que puede aplicar los archivos .patch generados. +> Vea también `git-am`, comando que puede aplicar los archivos .patch generados. > Más información: . - Crea un archivo `.patch` con nombre automático para todos los cambios que no están en el push: diff --git a/pages.es/common/git-init.md b/pages.es/common/git-init.md index c86b2caf3..08d92dcb1 100644 --- a/pages.es/common/git-init.md +++ b/pages.es/common/git-init.md @@ -15,6 +15,6 @@ `git init --object-format={{sha256}}` -- Inicializa un repositorio vacío, adecuado para usarlo como remoto a través de ssh: +- Inicializa un repositorio vacío, adecuado para usarlo como remoto a través de SSH: `git init --bare` diff --git a/pages.es/common/git-lfs.md b/pages.es/common/git-lfs.md index 58cea05ee..542e1668b 100644 --- a/pages.es/common/git-lfs.md +++ b/pages.es/common/git-lfs.md @@ -1,7 +1,7 @@ # git lfs > Trabaja con archivos grandes en repositorios de Git. -> Más información: . +> Más información: . - Inicializa Git LFS: diff --git a/pages.es/common/git-mktree.md b/pages.es/common/git-mktree.md new file mode 100644 index 000000000..119ded430 --- /dev/null +++ b/pages.es/common/git-mktree.md @@ -0,0 +1,24 @@ +# git mktree + +> Construye un objeto árbol usando texto formateado `ls-tree`. +> Más información: . + +- Construye un objeto árbol y verifica que el hash de cada entrada del árbol identifica un objeto existente: + +`git mktree` + +- Permite que falten objetos: + +`git mktree --missing` + +- Lee la salida terminada en NUL (carácter cero) del objeto árbol (`ls-tree -z`): + +`git mktree -z` + +- Permite la creación de múltiples objetos árbol: + +`git mktree --batch` + +- Ordena y construye un árbol a partir de `stdin` (se requiere un formato de salida de `git ls-tree` no recursivo): + +`git mktree < {{ruta/a/árbol.txt}}` diff --git a/pages.es/common/git-restore.md b/pages.es/common/git-restore.md index c447db7c4..92eadd24c 100644 --- a/pages.es/common/git-restore.md +++ b/pages.es/common/git-restore.md @@ -1,7 +1,7 @@ # git restore > Restaura los archivos del árbol de trabajo. Requiere la version 2.23+ de Git. -> Véase también `git checkout` y `git reset`. +> Vea también `git checkout` y `git reset`. > Más información: . - Restaura un archivo sin marcar a la versión de la confirmación actual (HEAD): diff --git a/pages.es/common/git-switch.md b/pages.es/common/git-switch.md index ad2dc40e2..3df43a597 100644 --- a/pages.es/common/git-switch.md +++ b/pages.es/common/git-switch.md @@ -1,7 +1,7 @@ # git switch > Alterna entre ramas Git. Requiere una versión 2.23+ de Git. -> Véase también `git checkout`. +> Vea también `git checkout`. > Más información: . - Cambia a una rama existente: diff --git a/pages.es/common/git.md b/pages.es/common/git.md index f2cf764b8..4a06034a3 100644 --- a/pages.es/common/git.md +++ b/pages.es/common/git.md @@ -1,21 +1,9 @@ # git > Sistema de control de versiones distribuido. -> Algunos subcomandos, como `commit`, `add`, `branch`, `checkout`, `push`, etc., tienen su propia documentación de uso, accessible a través de `tldr git subcomando`. +> Algunos subcomandos como `commit`, `add`, `branch`, `checkout`, `push`, etc., tienen su propia documentación de uso. > Más información: . -- Muestra la versión de Git: - -`git --version` - -- Muestra ayuda general: - -`git --help` - -- Muestra ayuda sobre un subcomando de Git (como `clone`, `add`, `push`, `log`, etc.): - -`git help {{subcomando}}` - - Ejecuta un subcomando de Git: `git {{subcomando}}` @@ -24,6 +12,18 @@ `git -C {{ruta/al/repositorio}} {{subcomando}}` -- Ejecuta un subcomando de Git con la configuración definida: +- Ejecuta un subcomando de Git con configuración personalizada: `git -c '{{config.clave}}={{valor}}' {{subcomando}}` + +- Muestra ayuda general: + +`git --help` + +- Muestra ayuda sobre un subcomando de Git (p. ej., `clone`, `add`, `push`, `log`, etc.): + +`git help {{subcomando}}` + +- Muestra la versión: + +`git --version` diff --git a/pages.es/common/gitleaks.md b/pages.es/common/gitleaks.md new file mode 100644 index 000000000..2012d47a9 --- /dev/null +++ b/pages.es/common/gitleaks.md @@ -0,0 +1,32 @@ +# gitleaks + +> Detecta secretos y claves API filtradas en repositorios Git. +> Más información: . + +- Escanea un repositorio remoto: + +`gitleaks detect --repo-url {{https://github.com/nombre_usuario/repositorio.git}}` + +- Escanea un directorio local: + +`gitleaks detect --source {{ruta/al/repositorio}}` + +- Crea un archivo JSON con los resultados del análisis: + +`gitleaks detect --source {{ruta/al/repositorio}} --report {{ruta/a/informe.json}}` + +- Utiliza un archivo de reglas personalizado: + +`gitleaks detect --source {{ruta/al/repositorio}} --config-path {{ruta/a/archivo_de_configuración.toml}}` + +- Inicia la búsqueda a partir de una confirmación específica: + +`gitleaks detect --source {{ruta/al/repositorio}} --log-opts {{--since=identificador_confirmación}}` + +- Escanea cambios no confirmados antes de una confirmación: + +`gitleaks protect --staged` + +- Muestra información detallada que indica que partes se identificaron como fugas durante el análisis: + +`gitleaks protect --staged --verbose` diff --git a/pages.es/common/gleam.md b/pages.es/common/gleam.md new file mode 100644 index 000000000..6b71aba7d --- /dev/null +++ b/pages.es/common/gleam.md @@ -0,0 +1,36 @@ +# gleam + +> El compilador, la herramienta de compilación, el gestor de paquetes y el formateador de código para Gleam, "un lenguaje amigable para construir sistemas de tipo seguro escalables". +> Más información: . + +- Crea un nuevo proyecto gleam: + +`gleam new {{nombre_del_proyecto}}` + +- Construye y ejecuta un proyecto gleam: + +`gleam run` + +- Construye el proyecto: + +`gleam build` + +- Ejecuta un proyecto para una plataforma y un tiempo de ejecución específico: + +`gleam run --target {{plataforma}} --runtime {{tiempo_de_ejecución}}` + +- Añade una dependencia hexadecimal a tu proyecto: + +`gleam add {{nombre_de_la_dependencia}}` + +- Ejecuta las pruebas del proyecto: + +`gleam test` + +- Formatea el código fuente: + +`gleam format` + +- Comprueba el tipo de proyecto: + +`gleam check` diff --git a/pages.es/common/gnmic-sub.md b/pages.es/common/gnmic-sub.md index 4308fe5c5..4c743569b 100644 --- a/pages.es/common/gnmic-sub.md +++ b/pages.es/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > Este comando es un alias de `gnmic subscribe`. > Más información: . diff --git a/pages.es/common/golangci-lint.md b/pages.es/common/golangci-lint.md index 059b17089..4caf8842b 100644 --- a/pages.es/common/golangci-lint.md +++ b/pages.es/common/golangci-lint.md @@ -1,7 +1,7 @@ # golangci-lint > Corredor de linters Go paralelizado, inteligente y rápido que se integra con los principales entornos de desarrollo integrado y soporta configuración en YAML. -> Más información: . +> Más información: . - Ejecuta linters en la carpeta actual: diff --git a/pages.es/common/grep.md b/pages.es/common/grep.md index da28bfb60..5d33d0f85 100644 --- a/pages.es/common/grep.md +++ b/pages.es/common/grep.md @@ -3,34 +3,34 @@ > Encuentra patrones en archivos usando expresiones regulares. > Más información: . -- Busca un patrón dentro de un archivo: +- Busca un patrón en un archivo: -`grep "{{patrón_de_busqueda}}" {{ruta/al/archivo}}` +`grep "{{patrón_de_búsqueda}}" {{ruta/al/archivo}}` -- Busca una cadena exacta (desactiva las expresiones regulares): +- Busca una cadena de caracteres específica (la cadena no será interpretada como una expresión regular): -`grep --fixed-strings "{{cadena_exacta}}" {{ruta/al/archivo}}` +`grep {{-F|--fixed-strings}} "{{cadena_exacta}}" {{ruta/al/archivo}}` -- Busca un patrón en todos los archivos de forma recursiva en un directorio, mostrando los números de línea de las coincidencias, ignorando los archivos binarios: +- Busca un patrón en todos los archivos de forma recursiva en un directorio, mostrando los números de línea de las coincidencias e ignorando los archivos binarios: -`grep --recursive --line-number --binary-files={{sin-parejamiento}} "{{patrón_de_búsqueda}}" {{ruta/al/directorio}}` +`grep {{-r|--recursive}} {{-n|--line-number}} --binary-files {{without-match}} "{{patrón_de_búsqueda}}" {{ruta/al/directorio}}` -- Utiliza expresiones regulares extendidas (admite `?`, `+`, `{}`, `()` y `|`), sin distinguir entre mayúsculas y minúsculas: +- Utiliza expresiones regulares extendidas (los metacaracteres `?`, `+`, `{}`, `()` y `|` no requieren de una barra inversa), sin distinguir entre mayúsculas y minúsculas: -`grep --extended-regexp --ignore-case " {{patrón_de_búsqueda}}" {{ruta/al/archivo}}` +`grep {{-E|--extended-regexp}} {{-i|--ignore-case}} "{{patrón_de_búsqueda}}" {{ruta/al/archivo}}` -- Imprime 3 líneas de contexto alrededor, antes o después de cada coincidencia: +- Imprime 3 líneas alrededor, antes o después de cada coincidencia: -`grep --{{context|before-context|after-context}}={{3}} "{{patrón_de_búsqueda}}" {{ruta/al/archivo}}` +`grep --{{context|before-context|after-context}} 3 "{{patrón_de_búsqueda}}" {{ruta/al/archivo}}` -- Imprime el nombre del archivo y el número de línea de cada coincidencia con salida en color: +- Imprime con colores el nombre del archivo y el número de línea de cada coincidencia: -`grep --with-filename --line-number --color=always "{{patrón_de_búsqueda}}" {{ruta/al/archivo}}` +`grep {{-H|--with-filename}} {{-n|--line-number}} --color=always "{{patrón_de_búsqueda}}" {{ruta/al/archivo}}` -- Busca líneas que coincidan con un patrón e imprime sólo el texto coincidente: +- Busca líneas que coincidan con un patrón e imprime solo el texto coincidente: -`grep --only-matching "{{patrón_de_búsqueda}}" {{ruta/al/archivo}}` +`grep {{-o|--only-matching}} "{{patrón_de_búsqueda}}" {{ruta/al/archivo}}` -- Busca `stdin` en las líneas que no coincidan con un patrón: +- Busca líneas en`stdin` que no coincidan con el patrón: -`cat {{ruta/al/archivo}} | grep --invert-match "{{patrón_de_busqueda}}"` +`cat {{ruta/al/archivo}} | grep {{-v|--invert-match}} "{{patrón_de_busqueda}}"` diff --git a/pages.es/common/histexpand.md b/pages.es/common/histexpand.md index e449233df..ffa878f0b 100644 --- a/pages.es/common/histexpand.md +++ b/pages.es/common/histexpand.md @@ -1,6 +1,6 @@ # history expansion -> Reutiliza y expande el historial del shell en `sh`, `bash`, `zsh`, `rbash` y `ksh`. +> Reutiliza y expande el historial del shell en `sh`, Bash, Zsh, `rbash` y `ksh`. > Más información: . - Ejecuta el comando anterior como root (`!!` se sustituye por el comando anterior): diff --git a/pages.es/common/hledger-balance.md b/pages.es/common/hledger-balance.md new file mode 100644 index 000000000..3aa7434f9 --- /dev/null +++ b/pages.es/common/hledger-balance.md @@ -0,0 +1,37 @@ +# hledger balance + +> Un informe "sumatorio" flexible y de propósito general que muestra cuentas con algún tipo de dato numérico. +> Puede tratarse de cambios de saldo por periodo, saldos finales, rendimiento presupuestario, plusvalías latentes, etc. +> Más información: . + +- Muestra el cambio de saldo en todas las cuentas de todas las contabilizaciones a lo largo de todo el tiempo: + +`hledger balance` + +- Muestra el cambio de saldo en las cuentas denominadas `*gastos*`, como un árbol, resumiendo solo los dos niveles superiores: + +`hledger balance {{gastos}} --tree --depth {{2}}` + +- Muestra los gastos de cada mes, y sus totales y medias, ordenados por total; y sus objetivos presupuestarios mensuales: + +`hledger balance {{gastos}} --monthly --row-total --average --sort-amount --budget` + +- Similar a la anterior, de forma más corta, comparando las cuentas por tipo de `Gastos`, como un árbol de dos niveles sin aplastar las cuentas aburridas: + +`hledger bal type:{{X}} -MTAS --budget -t -{{2}} --no-elide` + +- Muestra saldos finales (incluidos los de contabilizaciones anteriores a la fecha de inicio), trimestrales en 2024, en cuentas denominadas `*activos*` o `*pasivos*`: + +`hledger balance --historical --period '{{trimestral en 2024}}' {{activos}} {{pasivos}}` + +- Similar al anterior, de un modo más breve; también muestra saldos en cero, ordena por total y resume a tres niveles: + +`hledger bal -HQ date:{{2024}} type:{{AL}} -ES -{{3}}` + +- Muestra el valor de mercado de los activos de inversión en moneda base al final de cada trimestre: + +`hledger bal -HVQ {{activos:inversiones}}` + +- Muestra las ganancias/pérdidas de capital no realizadas por cambios en el precio de mercado en cada trimestre, para activos de inversión que no sean criptomonedas: + +`hledger bal --gain -Q {{activos:inversiones}} not:{{criptomoneda}}` diff --git a/pages.es/common/immich-cli.md b/pages.es/common/immich-cli.md new file mode 100644 index 000000000..ed20a08ef --- /dev/null +++ b/pages.es/common/immich-cli.md @@ -0,0 +1,29 @@ +# immich-cli + +> Immich tiene una interfaz de línea de comandos (CLI) que le permite realizar ciertas acciones desde la línea de comandos. +> Vea también: `immich-go`. +> Más información: . + +- Autentica en el servidor de Immich: + +`immich login {{url_del_servidor/api}} {{clave_del_servidor}}` + +- Sube unas imágenes: + +`immich upload {{archivo1.jpg archivo2.jpg}}` + +- Sube un directorio y sus subdirectorios: + +`immich upload --recursive {{ruta/al/directorio}}` + +- Crea un álbum basado en un directorio: + +`immich upload --album-name "{{Vacaciones de verano}}" --recursive {{ruta/al/directorio}}` + +- Omite recursos que coincidan con un patrón global: + +`immich upload --ignore {{**/Raw/** **/*.tif}} --recursive {{directorio/}}` + +- Incluye archivos ocultos: + +`immich upload --include-hidden --recursive {{ruta/al/directorio}}` diff --git a/pages.es/common/immich-go.md b/pages.es/common/immich-go.md new file mode 100644 index 000000000..996c95ac1 --- /dev/null +++ b/pages.es/common/immich-go.md @@ -0,0 +1,25 @@ +# immich-go + +> Immich-Go es una herramienta abierta diseñada para subir grandes colecciones de fotos a tu servidor Immich autoalojado. +> Véase también: `immich-cli`. +> Más información: . + +- Sube un archivo takeout de Google al servidor Immich: + +`immich-go -server={{url_del_servidor}} -key={{clave_de_servidor}} upload {{ruta/a/archivo_takeout.zip}}` + +- Importa fotos capturadas en junio del 2019, mientras se generan los álbumes automáticamente: + +`immich-go -server={{url_del_servidor}} -key={{clave_del_servidor}} upload -create-albums -google-photos -date={{2019-06}} {{ruta/a/archivo_takeout.zip}}` + +- Sube un archivo usando servidor y clave de un archivo de configuración: + +`immich-go -use-configuration={{~/.immich-go/immich-go.json}} upload {{ruta/a/archivo_takeout.zip}}` + +- Examina el contenido del servidor Immich, elimina las imágenes de menor calidad y preserva álbumes: + +`immich-go -server={{url_del_servidor}} -key={{clave_del_servidor}} duplicate -yes` + +- Elimina todos los álbumes creados con el patrón "YYYY-MM-DD": + +`immich-go -server={{url_del_servidor}} -key={{clave_del_servidor}} tool album delete {{\d{4}-\d{2}-\d{2}}}` diff --git a/pages.es/common/kill.md b/pages.es/common/kill.md index 649f43f5c..f759812d5 100644 --- a/pages.es/common/kill.md +++ b/pages.es/common/kill.md @@ -6,7 +6,7 @@ - Termina un programa usando la señal SIGTERM (terminar) por defecto: -`kill {{id_del_proceso}}` +`kill {{identificador_del_proceso}}` - Lista todas las señales disponibles (para ser utilizadas sin el prefijo `SIG`): @@ -14,24 +14,24 @@ - Termina una tarea en segundo plano: -`kill %{{id_de_tarea}}` +`kill %{{identificador_de_tarea}}` - Termina un programa usando la señal SIGHUP (hang up/colgar). Muchos programas residentes se recargarán en lugar de terminar: -`kill -{{1|HUP}} {{id_del_proceso}}` +`kill -{{1|HUP}} {{identificador_del_proceso}}` - Termina un programa usando la señal SIGINT (interrumpir). Esto es normalmente iniciado por el usuario presionando `Ctrl + C`: -`kill -{{2|INT}} {{id_del_proceso}}` +`kill -{{2|INT}} {{identificador_del_proceso}}` - Señala al sistema operativo para terminar inmediatamente un programa (el cual no tiene oportunidad de capturar la señal): -`kill -{{9|KILL}} {{id_del_proceso}}` +`kill -{{9|KILL}} {{identificador_del_proceso}}` - Señala al sistema operativo para pausar un programa hasta que la señal SIGCONT ("continuar") es recibida: -`kill -{{17|STOP}} {{id_del_proceso}}` +`kill -{{17|STOP}} {{identificador_del_proceso}}` - Envía una señal `SIGUSR1` a todos los procesos con un GID (id de grupo) dado: -`kill -{{SIGUSR1}} -{{id_de_grupo}}` +`kill -{{SIGUSR1}} -{{identificador_de_grupo}}` diff --git a/pages.es/common/ls.md b/pages.es/common/ls.md index 5d80c0f20..f991a1e53 100644 --- a/pages.es/common/ls.md +++ b/pages.es/common/ls.md @@ -15,19 +15,19 @@ `ls -F` -- Lista todos los archivos con formato largo (permisos, propietario, tamaño y fecha de modificación): +- Lista todos los archivos en formato largo (permisos, propietarios, tamaño y fecha de última modificación): `ls -la` -- Lista con formato largo y tamaño legible por humanos (KiB, MiB, GiB): +- Lista en formato largo y tamaño legible por humanos (i.e., KiB, MiB, GiB, etc.): `ls -lh` -- Lista con formato largo y tamaño en orden descendente: +- Lista recursivamente en formato largo y ordena los tamaños de mayor a menor: -`ls -lS` +`ls -lSR` -- Lista todos los archivos con formato largo, ordenado por fecha de modificación (archivos más viejos en primer lugar): +- Lista todos los archivos en formato largo y ordenados por fecha de modificación (archivos más viejos en primer lugar): `ls -ltr` diff --git a/pages.es/common/lstopo.md b/pages.es/common/lstopo.md new file mode 100644 index 000000000..cfc26e63a --- /dev/null +++ b/pages.es/common/lstopo.md @@ -0,0 +1,24 @@ +# lstopo + +> Muestra la topología de hardware del sistema. +> Más información: . + +- Muestra la topología resumida del sistema en una ventana gráfica (o imprime en consola si no se dispone de una sesión gráfica): + +`lstopo` + +- Muestra la topología completa del sistema sin resúmenes: + +`lstopo --no-factorize` + +- Muestra la topología resumida del sistema sólo con índices físicos (es decir, tal y como la ve el sistema operativo): + +`lstopo --physical` + +- Escribe la topología completa del sistema en un archivo con el formato especificado: + +`lstopo --no-factorize --output-format {{console|ascii|tex|fig|svg|pdf|ps|png|xml}} {{ruta/al/archivo}}` + +- Muestra datos en monocromo o escala de grises: + +`lstopo --palette {{none|grey}}` diff --git a/pages.es/common/mid3v2.md b/pages.es/common/mid3v2.md index f7f80cec2..3bc6938ae 100644 --- a/pages.es/common/mid3v2.md +++ b/pages.es/common/mid3v2.md @@ -18,16 +18,16 @@ - Establece información específica sobre artistas, álbumes o canciones: -`id3v2 {{--artist|--album|--song}} {{string}} {{ruta/al/archivo1.mp3 ruta/al/archivo2.mp3 ...}}` +`id3v2 {{--artist|--album|--song}}={{string}} {{ruta/al/archivo1.mp3 ruta/al/archivo2.mp3 ...}}` - Establece información específica de la imagen: -`id3v2 --picture {{filename:description:image_type:mime_type}} {{ruta/al/archivo1.mp3 ruta/al/archivo2.mp3 ...}}` +`id3v2 --picture={{filename:description:image_type:mime_type}} {{ruta/al/archivo1.mp3 ruta/al/archivo2.mp3 ...}}` - Establece información específica del año: -`id3v2 --year {{YYYY}} {{ruta/al/archivo1.mp3 ruta/al/archivo2.mp3 ...}}` +`id3v2 --year={{YYYY}} {{ruta/al/archivo1.mp3 ruta/al/archivo2.mp3 ...}}` - Establece información de fecha específica: -`id3v2 --date {{YYYY-MM-DD}} {{ruta/al/archivo1.mp3 ruta/al/archivo2.mp3 ...}}` +`id3v2 --date={{YYYY-MM-DD}} {{ruta/al/archivo1.mp3 ruta/al/archivo2.mp3 ...}}` diff --git a/pages.es/common/more.md b/pages.es/common/more.md index fc870dc13..48594aff9 100644 --- a/pages.es/common/more.md +++ b/pages.es/common/more.md @@ -1,32 +1,29 @@ # more -> Abre un archivo para lectura interactiva, permitiendo navegar y buscar. +> Interactivamente muestra el contenido un archivo, permitiendo desplazamiento y búsqueda. +> Vea también: `less`. > Más información: . - Abre un archivo: `more {{ruta/al/archivo}}` -- Abre un archivo mostrando desde una línea específica: +- Abre un archivo y muestra su contenido desde una línea específica: -`more +{{numero_linea}} {{ruta/al/archivo}}` +`more +{{número_de_línea}} {{ruta/al/archivo}}` -- Muestra la ayuda: +- Avanza a la siguiente página: -`more --help` +`` -- Avanza hacia la siguiente página: - -`` - -- Busca una cadena (presione `n` para ir a la siguiente coincidencia): +- Busca una cadena de caracteres (presione `n` para ir a la siguiente coincidencia): `/{{cadena}}` -- Salir: +- Sal del programa: `q` -- Muestra la ayuda sobre comandos interactivos: +- Muestra ayuda sobre comandos interactivos: `h` diff --git a/pages.es/common/nc.md b/pages.es/common/nc.md index dca280d2d..d94289f71 100644 --- a/pages.es/common/nc.md +++ b/pages.es/common/nc.md @@ -1,32 +1,32 @@ # nc -> Netcat es una utilidad versátil para trabajar con datos TCP o UDP. -> Más información: . +> Redirige datos de entrada o salida a un flujo de red a través de esta versátil herramienta. +> Más información: . -- Escucha en un puerto determinado e imprime cualquier dato recibido: +- Inicia un escuchador en un puerto TCP y le envía un archivo: -`nc -l {{puerto}}` +`nc -l -p {{puerto}} < {{nombre_de_archivo}}` -- Conecta a un puerto determinado: +- Conecta a un escuchador en un puerto y recibe un archivo de él: -`nc {{direccion_ip}} {{puerto}}` +`nc {{host}} {{puerto}} > {{nombre_de_archivo_por_recibir}}` -- Configura un tiempo máximo de respuesta: +- Escanea los puertos TCP abiertos en un host: -`nc -w {{tiempo_en_segundos}} {{direccion_ip}} {{puerto}}` +`nc -v -z -w {{tiempo_de_espera_en_segundos}} {{host}} {{puerto_inicial}}-{{puerto_final}}` -- Mantiene el servidor activo hasta que el cliente se desconecte: +- Inicia un escuchador en un puerto TCP y provee de acceso a tu intérprete de comandos local a la parte conectada (esto es peligroso y podría ser explotado): -`nc -k -l {{puerto}}` +`nc -l -p {{puerto}} -e {{ejecutable_del_intérprete}}` -- Mantiene el cliente activo durante un tiempo después de recibir EOF: +- Conecta a un escuchador y provee de acceso a tu intérprete de comandos local a una parte remota (esto es peligroso y podría ser explotado): -`nc -q {{tiempo_en_segundos}} {{direccion_ip}}` +`nc {{host}} {{puerto}} -e {{ejecutable_del_intérprete}}` -- Escanea puertos abiertos en un determinado host: +- Actúa como un proxy y envía información de un puerto TCP local a un host remoto: -`nc -v -z {{direccion_ip}} {{puerto1 puerto2 ...}}` +`nc -l -p {{puerto_local}} | nc {{host}} {{puerto_remoto}}` -- Actúa como un proxy y redirige los datos desde un puerto TCP local a un host remoto específico: +- Envía una petición HTTP GET: -`nc -l {{puerto_local}} | nc {{nombre_del_host}} {{puerto_remoto}}` +`echo -e "GET / HTTP/1.1\nHost: {{host}}\n\n" | nc {{host}} 80` diff --git a/pages.es/common/neo4j-admin.md b/pages.es/common/neo4j-admin.md new file mode 100644 index 000000000..43222c84d --- /dev/null +++ b/pages.es/common/neo4j-admin.md @@ -0,0 +1,32 @@ +# neo4j-admin + +> Gestiona y administra un Neo4j DBMS (Sistema de Gestión de Bases de Datos). +> Más información: . + +- Inicia el DBMS: + +`neo4j-admin server start` + +- Detén el DBMS: + +`neo4j-admin server stop` + +- Establece la contraseña inicial del usuario predeterminada `neo4j` (requisito para el primer arranque del DBMS): + +`neo4j-admin dbms set-initial-password {{nombre_base_de_datos}}` + +- Crea un archivo con una base de datos sin conexión llamado `nombre_base_de_datos.dump`: + +`neo4j-admin database dump --to-path={{ruta/al/directorio}} {{nombre_de_base_de_datos}}` + +- Carga una base de datos desde un archivo llamado `nombre_base_de_datos.dump`: + +`neo4j-admin database load --from-path={{ruta/al/directorio}} {{nombre_de_base_de_datos}} --overwrite-destination=true` + +- Carga una base de datos desde un archivo especificado a través de `stdin`: + +`neo4j-admin database load --from-stdin {{nombre_de_base_de_datos}} --overwrite-destination=true < {{ruta/a/nombre_archivo.dump}}` + +- Muestra ayuda: + +`neo4j-admin --help` diff --git a/pages.es/common/nmap.md b/pages.es/common/nmap.md index d7373643a..055bdef70 100644 --- a/pages.es/common/nmap.md +++ b/pages.es/common/nmap.md @@ -1,37 +1,37 @@ # nmap > Herramienta de exploración de redes y escáner de seguridad/puertos. -> Algunas funciones sólo se activan cuando Nmap se ejecuta con privilegios de root. -> Más información: . +> Algunas funciones (p. ej. escaneo SYN) se activan solamente cuando `nmap` es ejecutado con los permisos del superusuario. +> Más información: . -- Comprueba si una dirección IP está activa y adivina el sistema operativo del host remoto: +- Escanea los top 1000 puertos de un host remoto con varios niveles de [v]erbosidad: -`nmap -O {{ip_o_nombre_del_host}}` +`nmap -v{{1|2|3}} {{ip_o_nombre_de_host}}` -- Intenta determinar si los hosts especificados están activos (exploración ping) y cuáles son sus nombres y direcciones MAC: +- Ejecuta un barrido de ping sobre una subred o hosts específicos: -`sudo nmap -sn {{ip_o_nombre_del_host}} {{opcional_otra_dirección}}` +`nmap -T5 -sn {{192.168.0.0/24|ip_o_nombre_de_host1,ip_o_nombre_de_host2,...}}` -- Habilita también los scripts, la detección de servicios, la huella digital del SO y el traceroute: +- Activa la detección de sistemas operativos, la detección de versión, el escaneo con guiones y traceroute: -`nmap -A {{dirección_o_direcciones}}` +`sudo nmap -A {{ip_o_nombre_de_host1,ip_o_nombre_de_host2,...}}` -- Escanea una lista específica de puertos (usa '-p-' para todos los puertos desde 1 al 65535): +- Escanea una lista de puertos (invoca `nmap` con `-p-` para escanear todos los puertos desde 1 a 65535): -`nmap -p {{port1,port2,...,portN}} {{dirección_o_direcciones}}` +`nmap -p {{puerto1,puerto2,...}} {{ip_o_host1,ip_o_host2,...}}` -- Realiza la detección de servicios y versiones de los 1000 puertos principales utilizando los scripts por defecto de NSE; escribiendo los resultados ('-oN') en el fichero de salida: +- Detecta el servicio y versión de los top 1000 puertos usando los guiones NSE por defecto y escribe los resultados (`-oA`) en archivos de salida: -`nmap -sC -sV -oN {{top-1000-puertos.txt}} {{dirección_o_direcciones}}` +`nmap -sC -sV -oA {{top-1000-ports}} {{ip_o_host1,ip_o_host2,...}}` -- Escanea objetivo(s) cuidadosamente utilizando los scripts NSE "default and safe": +- Escanea objetivo(s) cuidadosamente usando los guiones NSE `default and safe`: -`nmap --script "default and safe" {{dirección_o_direcciones}}` +`nmap --script "default and safe" {{ip_o_host1,ip_o_host2,...}}` -- Escanea el servidor web que se ejecuta en los puertos estándar 80 y 443 utilizando todos los scripts de NSE 'http-*' disponibles: +- Escanea servidores web ejecutándose en los puertos estándares 80 y 443 usando todos los guiones `http-*` NSE disponibles: -`nmap --script "http-*" {{dirección_o_direcciones}} -p 80,443` +`nmap --script "http-*" {{ip_o_host1,ip_o_host2,...}} -p 80,443` -- Realiza un escaneo sigiloso muy lento ('-T0') intentando evitar la detección por parte de IDS/IPS y utiliza direcciones IP de origen con señuelo ('-D'): +- Intenta evadir los sistemas de detección y prevención de intrusos escaneando extremadamente lento (`-T0`) y usando direcciones de origen de señuelo (`-D`), paquetes [f]ragmentados, datos aleatorios y otros métodos: -`nmap -T0 -D {{decoy1_direcciónip,decoy2_direcciónip,...,decoyN_direcciónip}} {{dirección_o_direcciones}}` +`sudo nmap -T0 -D {{ip_de_señuelo1,ip_de_señuelo2,...}} --source-port {{53}} -f --data-length {{16}} -Pn {{ip_o_host}}` diff --git a/pages.es/common/pambrighten.md b/pages.es/common/pambrighten.md new file mode 100644 index 000000000..b88f37ee9 --- /dev/null +++ b/pages.es/common/pambrighten.md @@ -0,0 +1,12 @@ +# pambrighten + +> Cambia la saturación y el valor de una imagen PAM. +> Más información: . + +- Aumenta la saturación de cada píxel con un porcentaje específico: + +`pambrighten -saturation {{valor_porcentual}} {{ruta/a/imagen.pam}} > {{ruta/a/archivo_de_salida.pam}}` + +- Aumenta el valor (del espacio de color HSV) de cada píxel con un porcentaje específico: + +`pambrighten -value {{valor_porcentual}} {{ruta/a/imagen.pam}} > {{ruta/a/archivo_de_salida.pam}}` diff --git a/pages.es/common/pamedge.md b/pages.es/common/pamedge.md new file mode 100644 index 000000000..dd759794e --- /dev/null +++ b/pages.es/common/pamedge.md @@ -0,0 +1,8 @@ +# pamedge + +> Realiza la detección de bordes en una imagen Netpbm. +> Más información: . + +- Detecta bordes en una imagen Netpbm: + +`pamedge {{ruta/a/entrada.pam}} > {{ruta/a/salida.pam}}` diff --git a/pages.es/common/pamslice.md b/pages.es/common/pamslice.md new file mode 100644 index 000000000..fcca40312 --- /dev/null +++ b/pages.es/common/pamslice.md @@ -0,0 +1,20 @@ +# pamslice + +> Extrae una línea de valores de una imagen PAM. +> Más información: . + +- Imprime los valores de los píxeles de la n-ésima fila en una tabla: + +`pamslice -row {{n}} {{ruta/a/imagen.pam}}` + +- Imprime los valores de los píxeles de la n-ésima columna de una tabla: + +`pamslice -column {{n}} {{ruta/a/imagen.pam}}` + +- Considera solo el m-ésimo plano de la imagen de entrada: + +`pamslice -row {{n}} -plane {{m}} {{ruta/a/imagen.pam}}` + +- Produce la salida en un formato adecuado para la entrada a un `xmgr` para la visualización: + +`pamslice -row {{n}} -xmgr {{ruta/a/imagen.pam}}` diff --git a/pages.es/common/pamtogif.md b/pages.es/common/pamtogif.md new file mode 100644 index 000000000..de4abb157 --- /dev/null +++ b/pages.es/common/pamtogif.md @@ -0,0 +1,17 @@ +# pamtogif + +> Convierte una imagen Netpbm en una imagen GIF no animada. +> Vea también: `giftopnm`, `gifsicle`. +> Más información: . + +- Convierte una imagen Netpbm en una imagen GIF no animada: + +`pamtogif {{ruta/a/imagen.pam}} > {{ruta/a/imagen_de_salida.gif}}` + +- Marca el color especificado como transparente en el archivo GIF de salida: + +`pamtogif -transparent {{color}} {{ruta/a/imagen.pam}} > {{ruta/a/imagen_de_salida.gif}}` + +- Incluye el texto especificado como comentario en el archivo GIF de salida: + +`pamtogif -comment "{{¡Hola Mundo!}}" {{ruta/a/imagen.pam}} > {{ruta/a/imagen_de_salida.gif}}` diff --git a/pages.es/common/pamtouil.md b/pages.es/common/pamtouil.md new file mode 100644 index 000000000..8895cf24c --- /dev/null +++ b/pages.es/common/pamtouil.md @@ -0,0 +1,12 @@ +# pamtouil + +> Convierte un archivo PNM o PAM en un archivo de iconos UIL de Motif. +> Más información: . + +- Convierte un archivo PNM o PAM en un archivo de icono Motif UIL: + +`pamtouil {{ruta/a/entrada.[pnm|pam]}} > {{ruta/a/salida.uil}}` + +- Especifique una cadena de prefijo que se imprimirá en el archivo UIL de salida: + +`pamtouil -name {{nombre_uil}} {{ruta/a/entrada.[pnm|pam]}} > {{ruta/a/salida.uil}}` diff --git a/pages.es/common/par2.md b/pages.es/common/par2.md new file mode 100644 index 000000000..2b1af83b8 --- /dev/null +++ b/pages.es/common/par2.md @@ -0,0 +1,20 @@ +# par2 + +> Verificación y reparación de archivos utilizando archivos de paridad compatibles con PAR 2.0 (archivos .par2). +> Más información: . + +- Crea un archivo de paridad con un nivel de porcentaje de redundancia establecido: + +`par2 create -r{{1..100}} -- {{ruta/al/archivo}}` + +- Crea un archivo de paridad con un número determinado de archivos de volumen (además del archivo de índice): + +`par2 create -n{{1..32768}} -- {{ruta/al/archivo}}` + +- Verifica un fichero con un archivo de paridad: + +`par2 verify -- {{ruta/al/archivo.par2}}` + +- Repara un fichero con un archivo de paridad: + +`par2 repair -- {{ruta/al/archivo.par2}}` diff --git a/pages.es/common/pcapfix.md b/pages.es/common/pcapfix.md index 34f4a5f9c..7d8fd2c45 100644 --- a/pages.es/common/pcapfix.md +++ b/pages.es/common/pcapfix.md @@ -1,21 +1,21 @@ # pcapfix -> Repara archivos `pcap` y `pcapng` dañados o corruptos. +> Repara archivos PCAP y PcapNG dañados o corruptos. > Más información: . -- Repara un archivo `pcap`/`pcapng` (Nota: para los archivos `pcap`, sólo se escanean los primeros 262144 bytes de cada paquete): +- Repara un archivo PCAP/PcapNG (Nota: para los archivos PCAP, sólo se escanean los primeros 262144 bytes de cada paquete): `pcapfix {{ruta/al/archivo.pcapng}}` -- Repara un archivo `pcap` completo: +- Repara un archivo PCAP completo: `pcapfix --deep-scan {{ruta/al/archivo.pcap}}` -- Repara un archivo `pcap`/`pcapng` y escribe el archivo reparado en la ubicación especificada: +- Repara un archivo PCAP/PcapNG y escribe el archivo reparado en la ubicación especificada: `pcapfix --outfile {{ruta/al/archivo_reparado.pcap}} {{ruta/al/archivo.pcap}}` -- Repara un archivo `pcapng` y lo trata como un archivo `pcapng`, ignorando el reconocimiento automático: +- Repara un archivo PcapNG y lo trata como un archivo PcapNG, ignorando el reconocimiento automático: `pcapfix --pcapng {{ruta/al/archivo.pcapng}}` diff --git a/pages.es/common/pcdindex.md b/pages.es/common/pcdindex.md new file mode 100644 index 000000000..8f6be9377 --- /dev/null +++ b/pages.es/common/pcdindex.md @@ -0,0 +1,8 @@ +# pcdindex + +> Este comando ha sido renombrado a `pcdovtoppm`. +> Más información: . + +- Consulta la documentación del comando con su nombre actual: + +`tldr pcdovtoppm` diff --git a/pages.es/common/pcdovtoppm.md b/pages.es/common/pcdovtoppm.md new file mode 100644 index 000000000..85fb49c6b --- /dev/null +++ b/pages.es/common/pcdovtoppm.md @@ -0,0 +1,20 @@ +# pcdovtoppm + +> Crea una imagen índice para un CD de fotos basándose en su archivo de resumen. +> Más información: . + +- Crea una imagen índice PPM a partir de un archivo de vista general PCD: + +`pcdovtoppm {{ruta/al/archivo.pcd}} > {{ruta/al/archivo.ppm}}` + +- Especifica la anchura [m]áxima de la imagen de salida y el tamaño máximo de cada una de las imágenes contenidas en la salida: + +`pcdovtoppm -m {{anchura}} -s {{tamaño}} {{ruta/al/archivo.pcd}} > {{ruta/al/archivo.ppm}}` + +- Especifica el número máximo de imágenes y el número máximo de [c]olores: + +`pcdovtoppm -a {{n_imágenes}} -c {{n_colores}} {{ruta/al/archivo.pcd}} > {{ruta/al/archivo_salida.ppm}}` + +- Utiliza la [f]uente especificada para las anotaciones y pinta el fondo blanco: + +`pcdovtoppm -f {{fuente}} -w {{ruta/al/archivo.pcd}} > {{ruta/al/archivo.ppm}}` diff --git a/pages.es/common/pgmedge.md b/pages.es/common/pgmedge.md new file mode 100644 index 000000000..f4c09ec5c --- /dev/null +++ b/pages.es/common/pgmedge.md @@ -0,0 +1,8 @@ +# pgmedge + +> Este comando ha sido sustituido por `pamedge`. +> Más información: . + +- Consulta la documentación del comando actual: + +`tldr pamedge` diff --git a/pages.es/common/pgmnorm.md b/pages.es/common/pgmnorm.md new file mode 100644 index 000000000..0203b9e7e --- /dev/null +++ b/pages.es/common/pgmnorm.md @@ -0,0 +1,8 @@ +# pgmnorm + +> Este comando es reemplazado por `pnmnorm`. +> Más información: . + +- Muestra la documentación del comando actual: + +`tldr pnmnorm` diff --git a/pages.es/common/pgmslice.md b/pages.es/common/pgmslice.md new file mode 100644 index 000000000..abf280174 --- /dev/null +++ b/pages.es/common/pgmslice.md @@ -0,0 +1,8 @@ +# pgmslice + +> Este comando ha sido sustituido por `pamslice`. +> Más información: . + +- Vea documentación para el comando actual: + +`tldr pamslice` diff --git a/pages.es/common/pgmtopbm.md b/pages.es/common/pgmtopbm.md new file mode 100644 index 000000000..d5f655059 --- /dev/null +++ b/pages.es/common/pgmtopbm.md @@ -0,0 +1,8 @@ +# pgmtopbm + +> Este comando ha sido sustituido por `pamditherbw`. +> Más información: . + +- Vea documentación del comando actual: + +`tldr pamditherbw` diff --git a/pages.es/common/pi1toppm.md b/pages.es/common/pi1toppm.md new file mode 100644 index 000000000..ea3606cdd --- /dev/null +++ b/pages.es/common/pi1toppm.md @@ -0,0 +1,9 @@ +# pi1toppm + +> Convierte una imagen Atari Degas PI1 en una imagen PPM. +> Vea también: `ppmtopi1`. +> Más información: . + +- Convierte una imagen Atari Degas PI1 en una imagen PPM: + +`pi1toppm {{ruta/a/imagen_atari.pi1}} > {{ruta/a/imagen.ppm}}` diff --git a/pages.es/common/picocom.md b/pages.es/common/picocom.md index a897be622..5001c92e6 100644 --- a/pages.es/common/picocom.md +++ b/pages.es/common/picocom.md @@ -5,8 +5,8 @@ - Conecta a una consola serie con una velocidad en baudios específica: -`picocom {{/dev/ttyXYZ}} --baud {{baud_rate}}` +`picocom {{/dev/ttyXYZ}} --baud {{tasa_de_baudios}}` -- Asigna caracteres especiales (por ejemplo, `LF` a `CRLF`): +- Asigna caracteres especiales (p. ej. `LF` a `CRLF`): -`picocom {{/dev/ttyXYZ}} --imap {{lfcrlf}}}` +`picocom {{/dev/ttyXYZ}} --imap {{lfcrlf}}` diff --git a/pages.es/common/pio-init.md b/pages.es/common/pio-init.md index 30888683d..1213062a9 100644 --- a/pages.es/common/pio-init.md +++ b/pages.es/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > Este comando es un alias de `pio project`. diff --git a/pages.es/common/pnmenlarge.md b/pages.es/common/pnmenlarge.md new file mode 100644 index 000000000..059eb6959 --- /dev/null +++ b/pages.es/common/pnmenlarge.md @@ -0,0 +1,8 @@ +# pnmenlarge + +> Este comando ha sido sustituido por `pamenlarge`. +> Más información: . + +- Vea documentación del comando actual: + +`tldr pamenlarge` diff --git a/pages.es/common/pnmfile.md b/pages.es/common/pnmfile.md new file mode 100644 index 000000000..fc7064f55 --- /dev/null +++ b/pages.es/common/pnmfile.md @@ -0,0 +1,8 @@ +# pnmfile + +> Este comando ha sido sustituido por `pamfile`. +> Más información: . + +- Vea la documentación del comando actual: + +`tldr pamfile` diff --git a/pages.es/common/pnmflip.md b/pages.es/common/pnmflip.md new file mode 100644 index 000000000..15446349b --- /dev/null +++ b/pages.es/common/pnmflip.md @@ -0,0 +1,8 @@ +# pnmflip + +> Este comando ha sido sustituido por `pamflip`. +> Más información: . + +- Vea documentación del comando actual: + +`tldr pamflip` diff --git a/pages.es/common/ppmbrighten.md b/pages.es/common/ppmbrighten.md new file mode 100644 index 000000000..3d4553dc1 --- /dev/null +++ b/pages.es/common/ppmbrighten.md @@ -0,0 +1,8 @@ +# ppmbrighten + +> Este comando ha sido sustituido por `pambrighten`. +> Más información: . + +- Vea documentación del comando actual: + +`tldr pambrighten` diff --git a/pages.es/common/ppmnorm.md b/pages.es/common/ppmnorm.md new file mode 100644 index 000000000..8129d9cfa --- /dev/null +++ b/pages.es/common/ppmnorm.md @@ -0,0 +1,8 @@ +# ppmnorm + +> Este comando es reemplazado por `pnmnorm`. +> Más información: . + +- Muestra la documentación del comando actual: + +`tldr pnmnorm` diff --git a/pages.es/common/ppmtogif.md b/pages.es/common/ppmtogif.md new file mode 100644 index 000000000..a10d96a49 --- /dev/null +++ b/pages.es/common/ppmtogif.md @@ -0,0 +1,8 @@ +# ppmtogif + +> Este comando ha sido sustituido por `pamtogif`. +> Más información: . + +- Vea documentación para el comando actual: + +`tldr pamtogif` diff --git a/pages.es/common/ppmtojpeg.md b/pages.es/common/ppmtojpeg.md new file mode 100644 index 000000000..68329d112 --- /dev/null +++ b/pages.es/common/ppmtojpeg.md @@ -0,0 +1,8 @@ +# ppmtojpeg + +> Este comando ha sido sustituido por `pnmtojpeg`. +> Más información: . + +- Ve documentación del comando actual: + +`tldr pnmtojpeg` diff --git a/pages.es/common/ppmtomap.md b/pages.es/common/ppmtomap.md new file mode 100644 index 000000000..f9ace7c25 --- /dev/null +++ b/pages.es/common/ppmtomap.md @@ -0,0 +1,8 @@ +# ppmtomap + +> Este comando ha sido sustituido por `pnmcolormap`. +> Más información: . + +- Vea documentación del comando actual: + +`tldr pnmcolormap` diff --git a/pages.es/common/ppmtopi1.md b/pages.es/common/ppmtopi1.md new file mode 100644 index 000000000..3ebc023fc --- /dev/null +++ b/pages.es/common/ppmtopi1.md @@ -0,0 +1,9 @@ +# ppmtopi1 + +> Convierte una imagen PPM en una imagen Atari Degas PI1. +> Vea también: `pi1toppm`. +> Más información: . + +- Convierte una imagen PPM en una imagen Atari Degas PI1: + +`ppmtopi1 {{ruta/a/imagen.ppm}} > {{ruta/a/imagen_salida.pi1}}` diff --git a/pages.es/common/ppmtouil.md b/pages.es/common/ppmtouil.md new file mode 100644 index 000000000..d5cb711b8 --- /dev/null +++ b/pages.es/common/ppmtouil.md @@ -0,0 +1,8 @@ +# ppmtouil + +> Este comando ha sido sustituido por `pamtouil`. +> Más información: . + +- Consulte la documentación del comando actual: + +`tldr pamtouil` diff --git a/pages.es/common/pydocstyle.md b/pages.es/common/pydocstyle.md new file mode 100644 index 000000000..3b2b57844 --- /dev/null +++ b/pages.es/common/pydocstyle.md @@ -0,0 +1,32 @@ +# pydocstyle + +> Comprueba estáticamente que los scripts de Python cumplen con las convenciones de documentación de Python. +> Más información: . + +- Analiza un script de Python o todos los scripts de Python en un directorio específico: + +`pydocstyle {{archivo.py|ruta/al/directorio}}` + +- Muestra una explicación de cada error: + +`pydocstyle {{-e|--explain}} {{archivo.py|ruta/al/directorio}}` + +- Muestra información de depuración: + +`pydocstyle {{-d|--debug}} {{archivo.py|ruta/al/directorio}}` + +- Muestra el número total de errores: + +`pydocstyle --count {{archivo.py|ruta/a/directorio}}` + +- Utiliza un archivo de configuración específico: + +`pydocstyle --config {{ruta/a/archivo_config}} {{archivo.py|ruta/al/directorio}}` + +- Ignora uno o más errores: + +`pydocstyle --ignore {{D101,D2,D107,...}} {{archivo.py|ruta/al/directorio}}` + +- Busca errores de una convención específica: + +`pydocstyle --convention {{pep257|numpy|google}} {{archivo.py|ruta/a/directorio}}` diff --git a/pages.es/common/quarkus.md b/pages.es/common/quarkus.md new file mode 100644 index 000000000..e8d202a4c --- /dev/null +++ b/pages.es/common/quarkus.md @@ -0,0 +1,36 @@ +# quarkus + +> Crea proyectos Quarkus, gestiona extensiones y realiza tareas esenciales de compilación y desarrollo. +> Más información: . + +- Crea un nuevo proyecto de aplicación en un directorio nuevo: + +`quarkus create app {{nombre_del_proyecto}}` + +- Ejecuta el proyecto actual en el modo de codificación en vivo: + +`quarkus dev` + +- Ejecuta la aplicación: + +`quarkus run` + +- Ejecuta el proyecto actual en modo de prueba continua: + +`quarkus test` + +- Añade una o más extensiones al proyecto actual: + +`quarkus extension add {{nombre_extensión1 nombre_extensión2 ...}}` + +- Construye un contenedor de imagen utilizando Docker: + +`quarkus image build docker` + +- Despliega la aplicación en Kubernetes: + +`quarkus deploy kubernetes` + +- Actualiza el proyecto: + +`quarkus update` diff --git a/pages.es/common/rkdeveloptool.md b/pages.es/common/rkdeveloptool.md new file mode 100644 index 000000000..367425090 --- /dev/null +++ b/pages.es/common/rkdeveloptool.md @@ -0,0 +1,30 @@ +# rkdeveloptool + +> Flashea, vacía y gestiona el firmware de arranque en dispositivos informáticos basados en Rockchip. +> Necesitará encender el dispositivo en modo Maskrom/Bootrom antes de conectarlo a través del USB. +> Algunos subcomandos pueden requerir ser ejecutados como el superusuario. +> Más información: . + +- [l]ista todos los [d]ispositivos flash conectados basados en Rockchip: + +`rkdeveloptool ld` + +- Inicializa el dispositivo forzándolo a [d]escargar e instalar el gestor de arranque desde un archivo: + +`rkdeveloptool db {{ruta/al/bootloader.bin}}` + +- Actualiza un gestor de arranque: + +`rkdeveloptool ul {{ruta/al/bootloader.bin}}` + +- Escribe una imagen en una partición flash con formato GPT, especificando el sector de almacenamiento inicial (normalmente `0x0`, alias `0`): + +`rkdeveloptool wl {{sector_inicial}} {{ruta/a/imagen.img}}` + +- Escribe en la partición flash por su nombre amigable: + +`rkdeveloptool wlx {{nombre_partición}} {{ruta/a/imagen.img}}` + +- [r]einicia/repón el [d]ispositivo, sal del modo Maskrom/Bootrom para arrancar en la partición flash seleccionada: + +`rkdeveloptool rd` diff --git a/pages.es/common/showfigfonts.md b/pages.es/common/showfigfonts.md index c3db64690..4623c9130 100644 --- a/pages.es/common/showfigfonts.md +++ b/pages.es/common/showfigfonts.md @@ -1,7 +1,7 @@ # showfigfonts > Muestra una lista de fuentes disponibles para figlet. -> Véase también `figlet`. +> Vea también `figlet`. > Más información: . - Muestra las fuentes disponibles: diff --git a/pages.es/common/simplehttpserver.md b/pages.es/common/simplehttpserver.md new file mode 100644 index 000000000..bc108b419 --- /dev/null +++ b/pages.es/common/simplehttpserver.md @@ -0,0 +1,25 @@ +# simplehttpserver + +> Un simple servidor HTTP/S que soporta subida de ficheros, autenticación básica y reglas YAML para respuestas personalizadas. +> Una alternativa Go a `http.server` de Python. +> Más información: . + +- Inicia el servidor HTTP que sirve el directorio actual con salida verbosa (escucha en todas las interfaces y puerto 8000 por defecto): + +`simplehttpserver -verbose` + +- Inicia el servidor HTTP con autenticación básica sirviendo una ruta específica a través del puerto 80 en todas las interfaces: + +`sudo simplehttpserver -basic-auth {{nombre_de_usuario}}:{{contraseña}} -path {{/var/www/html}} -listen 0.0.0.0:80` + +- Inicia el servidor HTTP, habilitando HTTPS utilizando un certificado autofirmado con SAN personalizado en todas las interfaces: + +`sudo simplehttpserver -https -domain {{*.selfsigned.com}} -listen 0.0.0.0:443` + +- Inicia el servidor HTTP con cabeceras de respuesta personalizadas y capacidad de carga: + +`simplehttpserver -upload -header '{{X-Powered-By: Go}}' -header '{{Server: SimpleHTTPServer}}'` + +- Inicia el servidor HTTP con reglas personalizables en YAML (consulte la documentación para DSL): + +`simplehttpserver -rules {{rules.yaml}}` diff --git a/pages.es/common/tar.md b/pages.es/common/tar.md index a3e604760..709f380ef 100644 --- a/pages.es/common/tar.md +++ b/pages.es/common/tar.md @@ -4,34 +4,34 @@ > A menudo se combina con un método de compresión, como gzip o bzip2. > Más información: . -- [c]rea un archivo y lo escribe en un [f]ile: +- [c]rea un archivo y lo escribe en un [f]ichero: `tar cf {{ruta/al/objetivo.tar}} {{ruta/al/archivo1 ruta/al/archivo2 ...}}` -- [c]rea un archivo g[z]ipado y lo escribe en un [f]ile: +- [c]rea un archivo con formato g[z]ip y lo escribe en un [f]ichero: `tar czf {{ruta/al/objetivo.tar.gz}} {{ruta/al/archivo1 ruta/al/archivo2 ...}}` -- [c]rea un archivo g[z]ipado desde un directorio utilizando rutas relativas: +- [c]rea un archivo con formato g[z]ip desde un directorio utilizando rutas relativas: `tar czf {{ruta/al/objetivo.tar.gz}} --directory={{ruta/al/directorio}} .` -- E[x]trae un [f]ile (comprimido) al directorio actual [v]erbosamente: +- E[x]trae un [f]ichero (comprimido) al directorio actual [v]erbosamente: `tar xvf {{ruta/a/fuente.tar[.gz|.bz2|.xz]}}` -- E[x]trae un [f]ile (comprimido) al directorio de destino: +- E[x]trae un [f]ichero (comprimido) al directorio de destino: -`tar xf {{ruta/al/fuente.tar[.gz|.bz2|.xz]}} --directory={{ruta/al/directorio}}` +`tar xf {{ruta/al/archivo_de_entrada.tar[.gz|.bz2|.xz]}} --directory={{ruta/al/directorio}}` - Crea un archivo comprimido y lo escribe en una carpeta, utilizando la extensión del archivo para determinar automáticamente el programa de compresión: `tar caf {{ruta/al/objetivo.tar.xz}} {{ruta/al/archivo1 ruta/al/archivo2 ...}}` -- Lis[t]a el contenido de un [f]ile tar [v]erbosamente: +- Lis[t]a el contenido de un [f]ichero tar [v]erbosamente: -`tar tvf {{ruta/al/fuente.tar}}` +`tar tvf {{ruta/al/archivo_de_entrada.tar}}` -- E[x]trae ficheros que coincidan con un patrón de un [f]ile: +- E[x]trae ficheros que coincidan con un patrón de un [f]ichero: -`tar xf {{ruta/al/fuente.tar}} --wildcards "{{*.html}}"` +`tar xf {{ruta/al/archivo_de_entrada.tar}} --wildcards "{{*.html}}"` diff --git a/pages.es/common/theharvester.md b/pages.es/common/theharvester.md new file mode 100644 index 000000000..64a1cc36c --- /dev/null +++ b/pages.es/common/theharvester.md @@ -0,0 +1,24 @@ +# theHarvester + +> Una herramienta diseñada para las primeras etapas en una prueba de penetración. +> Más información: . + +- Recopila información sobre un dominio utilizando Google: + +`theHarvester --domain {{nombre_de_dominio}} --source google` + +- Recopila información sobre un dominio utilizando varias fuentes: + +`theHarvester --domain {{nombre_de_dominio}} --source {{duckduckgo,bing,crtsh}}` + +- Cambia el límite de resultados con los que trabajar: + +`theHarvester --domain {{nombre_de_dominio}} --source {{google}} --limit {{200}}` + +- Guarda el resultado en dos archivos en formato XML y HTML: + +`theHarvester --domain {{nombre_de_dominio}} --source {{google}} --file {{nombre_de_archivo_de_salida}}` + +- Muestra ayuda: + +`theHarvester --help` diff --git a/pages.es/common/tlmgr-arch.md b/pages.es/common/tlmgr-arch.md index 40f608a05..246239eba 100644 --- a/pages.es/common/tlmgr-arch.md +++ b/pages.es/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > Este comando es un alias de `tlmgr platform`. > Más información: . diff --git a/pages.es/common/toipe.md b/pages.es/common/toipe.md new file mode 100644 index 000000000..396e1c9c4 --- /dev/null +++ b/pages.es/common/toipe.md @@ -0,0 +1,25 @@ +# toipe + +> Otra prueba de tipeo, pero con sabor a cangrejo. +> Un confiable evaluador de tipeo de terminal. +> Más información: . + +- Inicia el examen de tipeo con la lista de palabras por defecto: + +`toipe` + +- Usa una lista de palabras específica: + +`toipe {{-w|--wordlist}} {{nombre_de_la_lista}}` + +- Utiliza una lista de palabras personalizada: + +`toipe {{-f|--file}} {{ruta/al/archivo}}` + +- Especifique el número de palabras de cada prueba: + +`toipe {{-n|--num}} {{número_de_palabras}}` + +- Incluya signos de puntuación: + +`toipe {{-p|--punctuation}}` diff --git a/pages.es/common/tree.md b/pages.es/common/tree.md index 482a1bb6c..5b6956373 100644 --- a/pages.es/common/tree.md +++ b/pages.es/common/tree.md @@ -1,7 +1,7 @@ # tree > Muestra los contenidos del directorio actual en forma de árbol. -> Más información: . +> Más información: . - Imprime archivos y directorios hasta `num` niveles de profundidad (donde 1 significa el directorio actual): diff --git a/pages.es/common/type.md b/pages.es/common/type.md new file mode 100644 index 000000000..e709e6568 --- /dev/null +++ b/pages.es/common/type.md @@ -0,0 +1,21 @@ +# type + +> Muestra el tipo de comando que ejecutará el intérprete de comandos. +> Nota: todos los ejemplos no son compatibles con POSIX. +> Más información: . + +- Muestra el tipo de un comando: + +`type {{comando}}` + +- Muestra todas las rutas con el ejecutable especificado (solo funciona en los intérpretes de comandos Bash/fish/Zsh): + +`type -a {{comando}}` + +- Muestra el nombre del archivo en disco que se ejecutaría (solo funciona en intérpretes de comandos Bash/fish/Zsh): + +`type -p {{comando}}` + +- Muestra el tipo de un comando específico, alias/palabra clave/función/integrado/archivo (solo funciona en intérpretes de comandos Bash/fish): + +`type -t {{comando}}` diff --git a/pages.es/common/typeinc.md b/pages.es/common/typeinc.md new file mode 100644 index 000000000..859c17cd0 --- /dev/null +++ b/pages.es/common/typeinc.md @@ -0,0 +1,21 @@ +# typeinc + +> Un programa de línea de comandos basado en `ncurses` para probar la velocidad de tecleo, escrito en Python. +> Prueba diferentes niveles de dificultad y mejora tu velocidad de tecleo. +> Más información: . + +- Entra en la prueba de mecanografía: + +`typeinc` + +- Muestra la lista de los 10 primeros clasificados por nivel de dificultad de entrada:: + +`typeinc {{-r|--ranklist}} {{nivel_de_dificultad}}` + +- Obtén palabras aleatorias en inglés presentes en nuestra lista de palabras: + +`typeinc {{-w|--words}} {{conteo_de_palabras}}` + +- Calcula el resultado hipotético en Typeinc: + +`typeinc {{-s|--score}}` diff --git a/pages.es/common/upt.md b/pages.es/common/upt.md new file mode 100644 index 000000000..a6eb9dbd1 --- /dev/null +++ b/pages.es/common/upt.md @@ -0,0 +1,38 @@ +# upt + +> Interfaz unificada para gestionar paquetes en varios sistemas operativos, tales como Windows, diversas distribuciones de Linux, macOS, FreeBSD e incluso Haiku. +> Requiere que el gestor de paquetes nativo del sistema operativo esté instalado. +> Vea también: `flatpak`, `brew`, `scoop`, `apt`, `dnf`. +> Más información: . + +- Actualiza la lista de paquetes disponibles: + +`upt update` + +- Busca un paquete: + +`upt search {{término_de_búsqueda}}` + +- Muestra información sobre un paquete: + +`upt info {{paquete}}` + +- Instala un paquete: + +`upt install {{paquete}}` + +- Elimina un paquete: + +`upt {{remove|uninstall}} {{paquete}}` + +- Actualiza todos los paquetes instalados: + +`upt upgrade` + +- Actualiza un paquete: + +`upt upgrade {{paquete}}` + +- Lista los paquetes instalados: + +`upt list` diff --git a/pages.es/common/usql.md b/pages.es/common/usql.md index 7e001a491..2ba65e4da 100644 --- a/pages.es/common/usql.md +++ b/pages.es/common/usql.md @@ -15,22 +15,18 @@ `usql --command="{{comando_sql}}"` -- Lista las bases de datos disponibles en el servidor: - -`usql --list-databases` - -- Ejecuta un comando SQL en el indicador `usql`: +- Ejecuta un comando SQL en el intérprete de comandos de `usql`: `{{prompt}}=> {{comando}}` - Muestra el esquema de la base de datos: -`{{prompt}}=> {{\d}}` +`{{prompt}}=> \d` - Exporta los resultados de la consulta a un archivo específico: -`{{prompt}}=> \g {{ruta/a/resultados.txt}}` +`{{prompt}}=> \g {{ruta/a/archivo_con_resultados}}` - Importa datos de un archivo CSV a una tabla específica: -`{{prompt}}=> \copy {{/ruta/a/datos.csv}} {{nombre_tabla}}` +`{{prompt}}=> \copy {{ruta/a/datos.csv}} {{nombre_de_tabla}}` diff --git a/pages.es/common/vcpkg.md b/pages.es/common/vcpkg.md index 3832adbc5..d1e99b6e9 100644 --- a/pages.es/common/vcpkg.md +++ b/pages.es/common/vcpkg.md @@ -2,7 +2,7 @@ > Gestor de paquetes para librerías C/C++. > Nota: los paquetes no se instalan en el sistema. Para usarlos, necesitas decirle a tu sistema de compilación (por ejemplo CMake) que use `vcpkg`. -> Más información: . +> Más información: . - Construye y añade el paquete `libcurl` al entorno de `vcpkg`: diff --git a/pages.es/common/waybar.md b/pages.es/common/waybar.md new file mode 100644 index 000000000..7b23d5b93 --- /dev/null +++ b/pages.es/common/waybar.md @@ -0,0 +1,20 @@ +# waybar + +> Barra Wayland altamente personalizable para compositores basados en Sway y Wlroots. +> Más información: . + +- Inicia `waybar` con la configuración y hoja de estilos predeterminada: + +`waybar` + +- Usa un archivo de configuración diferente: + +`waybar {{-c|--config}} {{ruta/a/archivo_de_configuración.jsonc}}` + +- Utiliza un archivo de hoja de estilo diferente: + +`waybar {{-s|--style}} {{ruta/a/hoja_de_estilo.css}}` + +- Establece el nivel de registro: + +`waybar {{-l|--log-level}} {{trace|debug|info|warning|error|critical|off}}` diff --git a/pages.es/common/waymore.md b/pages.es/common/waymore.md new file mode 100644 index 000000000..a812f1d57 --- /dev/null +++ b/pages.es/common/waymore.md @@ -0,0 +1,21 @@ +# waymore + +> Obtén las URLs de un dominio desde Wayback Machine, Common Crawl, Alien Vault OTX, URLScan y VirusTotal. +> Nota: A menos que se especifique lo contrario, los resultados se escriben en el directorio `results/` donde reside el archivo `config.yml` de waymore (por defecto en `~/.config/waymore/`). +> Más información: . + +- Busca URLs de un dominio (la salida suele estar en `~/.config/waymore/results/`): + +`waymore -i {{ejemplo.com}}` + +- Limita los resultados de la búsqueda para que solo incluyan una lista de URLs de un dominio y almacena los resultados en el archivo especificado: + +`waymore -mode U -oU {{ruta/a/ejemplo.com-urls.txt}} -i {{ejemplo.com}}` + +- Imprime solo los cuerpos de contenido de las URLs y almacena los resultados en el directorio especificado: + +`waymore -mode R -oR {{ruta/a/ejemplo.com-url-responses}} -i {{ejemplo.com}}` + +- Filtra los resultados especificando intervalos de fechas: + +`waymore -from {{YYYYMMDD|YYYMM|YYYY}} -to {{AAAAMMDD|AAAAMMD|AAAAMMD}} -i {{ejemplo.com}}` diff --git a/pages.es/common/wdiff.md b/pages.es/common/wdiff.md new file mode 100644 index 000000000..0bad5a4a0 --- /dev/null +++ b/pages.es/common/wdiff.md @@ -0,0 +1,16 @@ +# wdiff + +> Muestra las diferencias de palabras entre archivos de texto. +> Más información: . + +- Compara dos archivos: + +`wdiff {{ruta/al/archivo1}} {{ruta/al/archivo2}}` + +- Ignora mayúsculas y minúsculas al comparar: + +`wdiff --ignore-case {{ruta/al/archivo1}} {{ruta/al/archivo2}}` + +- Muestra cuantas palabras se han eliminado, insertado o sustituido: + +`wdiff --statistics {{ruta/al/archivo1}} {{ruta/al/archivo2}}` diff --git a/pages.es/common/xkill.md b/pages.es/common/xkill.md index c0e161d77..ff64b95b1 100644 --- a/pages.es/common/xkill.md +++ b/pages.es/common/xkill.md @@ -1,9 +1,17 @@ # xkill > Cierra de manera forzosa una ventana interactivamente en una sesión gráfica. -> Véase también `kill` y `killall`. +> Vea también `kill` y `killall`. > Más información: . - Muestra un cursor para cerrar forzosamente una ventana presionando con el botón izquierdo (presiona cualquier otro botón del ratón para cancelar): `xkill` + +- Muestra un cursor para seleccionar una ventana para cerrarla forzosamente al presionar cualquier botón del ratón: + +`xkill -button any` + +- Cierra forzosamente una ventana con un ID específico (use `xwininfo` para obtener información acerca de las ventanas): + +`xkill -id {{id}}` diff --git a/pages.es/common/yacc.md b/pages.es/common/yacc.md new file mode 100644 index 000000000..b9cd39a55 --- /dev/null +++ b/pages.es/common/yacc.md @@ -0,0 +1,17 @@ +# yacc + +> Genera un analizador sintáctico LALR (en C) con un archivo de especificación de gramática formal. +> Vea también: `bison`. +> Más información: . + +- Crea un fichero `y.tab.c` con el código del analizador en C y compila el fichero de gramática con todas las declaraciones constantes necesarias para los valores. El fichero `y.tab.h` con las declaraciones se crea exclusivamente con la opción `-d`: + +`yacc -d {{ruta/al/archivo_de_gramática.y}}` + +- Compila un fichero de gramática con la descripción del analizador sintáctico y un informe de conflictos generados por ambigüedades en la gramática: + +`yacc -d {{ruta/al/archivo_de_gramática.y}} -v` + +- Compila un archivo de gramática, y prefija los nombres de los archivos de salida con un prefijo personalizado en lugar de `y`: + +`yacc -d {{ruta/al/archivo_de_gramática.y}} -v -b {{prefijo}}` diff --git a/pages.es/linux/zipcloak.md b/pages.es/common/zipcloak.md similarity index 100% rename from pages.es/linux/zipcloak.md rename to pages.es/common/zipcloak.md diff --git a/pages.es/common/zsh.md b/pages.es/common/zsh.md index c54b3aa19..be8e91818 100644 --- a/pages.es/common/zsh.md +++ b/pages.es/common/zsh.md @@ -1,10 +1,10 @@ # zsh -> Z SHell, un intérprete para la línea de comandos compatible con Bash. -> Véase también `histexpand` para la expansión del historial. +> Z SHell, un intérprete de línea de comandos compatible con Bash. +> Vea también `histexpand` para la expansión del historial. > Más información: . -- Comienza una sesión interactiva en la shell: +- Comienza una sesión interactiva en el intérprete de comandos: `zsh` @@ -16,10 +16,22 @@ `zsh {{ruta/al/script.zsh}}` +- Comprueba si hay errores de sintaxis en un script sin ejecutarlo: + +`zsh --no-exec {{ruta/al/script.zsh}}` + +- Ejecuta comandos desde `stdin`: + +`{{comando}} | zsh` + - Ejecuta un script, mostrando cada comando antes de ejecutarlo: `zsh --xtrace {{ruta/al/script.zsh}}` -- Comienza una sesión interactiva en la shell en modo detallado, mostrando cada comando antes de ejecutarlo: +- Comienza una sesión interactiva en el intérprete de comandos en modo detallado, mostrando cada comando antes de ejecutarlo: `zsh --verbose` + +- Ejecuta un comando dentro de `zsh` con patrones glob desactivados: + +`noglob {{command}}` diff --git a/pages.es/freebsd/look.md b/pages.es/freebsd/look.md index e79b4e68d..67bed895f 100644 --- a/pages.es/freebsd/look.md +++ b/pages.es/freebsd/look.md @@ -10,11 +10,11 @@ - Busca caracteres alfanuméricos sin tomar en cuenta las mayúsculas o minúsculas: -`look -{{f|-ignore-case}} -{{d|-alphanum}} {{prefijo}} {{ruta/al/archivo}}` +`look {{-f|--ignore-case}} {{-d|--alphanum}} {{prefijo}} {{ruta/al/archivo}}` -- Especifica un carácter de [t]erminación de cadena (un espacio por defecto): +- Especifica un carácter de terminación de cadena (un espacio por defecto): -`look -{{t|-terminate}} {{,}}` +`look {{-t|--terminate}} {{,}}` - Busca en `/usr/share/dict/words` (se asumen `--ignore-case` y `--alphanum`): diff --git a/pages.es/linux/abbr.md b/pages.es/linux/abbr.md index 03337f96a..4d8c4428c 100644 --- a/pages.es/linux/abbr.md +++ b/pages.es/linux/abbr.md @@ -1,6 +1,6 @@ # abbr -> Administra abreviaturas para el shell fish. +> Administra abreviaturas del intérprete de comandos fish. > Las palabras definidas por el usuario se reemplazan con frases más largas después de ingresarlas. > Más información: . diff --git a/pages.es/linux/agetty.md b/pages.es/linux/agetty.md new file mode 100644 index 000000000..3b1c87f5a --- /dev/null +++ b/pages.es/linux/agetty.md @@ -0,0 +1,30 @@ +# agetty + +> Alternativa a `getty`: Abre un puerto `tty`, pide un nombre de usuario, e invoca el comando `/bin/login`. +> Normalmente es invocado por `init`. +> Nota: la tasa de baudios es la velocidad de transferencia de datos entre una terminal y un dispositivo a través de una conexión serie. +> Más información: . + +- Conecta `stdin` a un puerto (relativo a `/dev`) y especifica opcionalmente una tasa de baudios (cuyo valor predeterminado es 9600): + +`agetty {{tty}} {{115200}}` + +- Asume que `stdin` ya está conectado a una `tty` y establece un tiempo de espera para el inicio de sesión: + +`agetty {{-t|--timeout}} {{tiempo_de_espera_en_segundos}} -` + +- Asume que `tty` es de [8]-bits, sobreescribiendo la variable de entorno `TERM` establecida por `init`: + +`agetty -8 - {{variable_term}}` + +- Omite el inicio de sesión e invoca, como superusuario, otro programa de inicio de sesión en lugar de `/bin/login`: + +`agetty {{-n|--skip-login}} {{-l|--login-program}} {{programa_de_inicio_de_sesión}} {{tty}}` + +- Escribe el mensaje de inicio de sesión sin mostrar el contenido del archivo de pre-inicio de sesión (`/etc/issue` por predeterminado): + +`agetty {{-i|--noissue}} -` + +- Cambia el directorio raíz y escribe un host falso en el archivo `utmp`: + +`agetty {{-r|--chroot}} {{/ruta/a/raíz_directorio}} {{-H|--host}} {{host_falso}} -` diff --git a/pages.es/linux/apt-add-repository.md b/pages.es/linux/apt-add-repository.md index 43306e734..3d145ecea 100644 --- a/pages.es/linux/apt-add-repository.md +++ b/pages.es/linux/apt-add-repository.md @@ -1,13 +1,13 @@ # apt-add-repository -> Gestiona las definiciones del repositorio apt. +> Gestiona las definiciones del repositorio APT. > Más información: . -- Añade un nuevo repositorio apt: +- Añade un nuevo repositorio APT: `apt-add-repository {{repositorio}}` -- Elimina un repositorio apt: +- Elimina un repositorio APT: `apt-add-repository --remove {{repositorio}}` diff --git a/pages.es/linux/apt-file.md b/pages.es/linux/apt-file.md index 02eeb5893..d96e8507d 100644 --- a/pages.es/linux/apt-file.md +++ b/pages.es/linux/apt-file.md @@ -1,6 +1,6 @@ # apt-file -> Busca archivos en paquetes apt, incluyendo los que aún no fueron instalados. +> Busca archivos en paquetes APT, incluyendo los que aún no fueron instalados. > Más información: . - Actualiza los metadatos de la base de datos: diff --git a/pages.es/linux/apt-key.md b/pages.es/linux/apt-key.md index a69b56779..03a599af2 100644 --- a/pages.es/linux/apt-key.md +++ b/pages.es/linux/apt-key.md @@ -13,7 +13,7 @@ - Borra una clave del almacén de claves de confianza: -`apt-key del {{id_clave}}` +`apt-key del {{identificador_de_clave}}` - Añade un clave remota al almacén de claves de confianza: @@ -21,4 +21,4 @@ - Añade una clave de un servidor de claves con el identificador de la clave: -`apt-key adv --keyserver {{pgp.mit.edu}} --recv {{id_clave}}` +`apt-key adv --keyserver {{pgp.mit.edu}} --recv {{identificador_de_clave}}` diff --git a/pages.es/linux/blkpr.md b/pages.es/linux/blkpr.md new file mode 100644 index 000000000..d612989cb --- /dev/null +++ b/pages.es/linux/blkpr.md @@ -0,0 +1,24 @@ +# blkpr + +> Registra, reserva, libera, anticipa y borra reservas persistentes en un dispositivo de bloque que soporte "Persistent Reservations". +> Más información: . + +- Registra (comando) una nueva reserva con una clave dada en un dispositivo determinado: + +`blkpr {{-c|--command}} register {{-k|--key}} {{clave_de_reserva}} {{ruta/al/dispositivo}}` + +- Establece el tipo de reserva existente en acceso exclusivo: + +`blkpr -c reserve {{-k|--key}} {{clave_de_reserva}} {{-t|--type}} exclusive-access {{ruta/al/dispositivo}}` + +- Adelanta la reserva existente con una clave dada y la reemplaza por una nueva reserva: + +`blkpr -c preempt {{-K|--oldkey}} {{clave_antigua}} {{-k|--key}} {{nueva_clave}} {{-t|--type}} write-exclusive {{ruta/al/dispositivo}}` + +- Libera una reserva con una clave y [t]ipo dados en un dispositivo determinado: + +`blkpr -c release {{-k|--key}} {{clave_de_reserva}} {{-t|--type}} {{tipo_de_reserva}} {{ruta/al/dispositivo}}` + +- Borra todas las reservas de un dispositivo determinado: + +`blkpr -c clear {{-k|--key}} {{clave}} {{ruta/al/dispositivo}}` diff --git a/pages.es/linux/bspwm.md b/pages.es/linux/bspwm.md index df053d6c7..773540ec8 100644 --- a/pages.es/linux/bspwm.md +++ b/pages.es/linux/bspwm.md @@ -1,8 +1,9 @@ # bspwm -> Este comando es un alias de `bspc`. +> Un gestor de ventanas embaldosado basado en particionado de espacio binario. +> Vea también: `bspc`, para controlar el gestor. > Más información: . -- Muestra la documentación del comando original: +- Inicia `bspwm` (cabe recalcar que no debe haber otro gestor de ventanas al ejecutar este comando): -`tldr bspc` +`bspwm -c {{ruta/a/archivo_de_configuración}}` diff --git a/pages.es/linux/bwa.md b/pages.es/linux/bwa.md new file mode 100644 index 000000000..0e155d04b --- /dev/null +++ b/pages.es/linux/bwa.md @@ -0,0 +1,25 @@ +# bwa + +> Herramienta de alineación Burrows-Wheeler. +> Mapeador de secuencias de ADN cortas y poco divergentes frente a un gran genoma de referencia, como el genoma humano. +> Más información: . + +- Indexa el genoma de referencia: + +`bwa index {{ruta/a/referencia.fa}}` + +- Mapea las lecturas de un solo extremo (secuencias) al genoma indexado utilizando 32 subprocesos y comprime el resultado para ahorrar espacio: + +`bwa mem -t 32 {{ruta/a/referencia.fa}} {{ruta/a/lectura_solo_extremo.fq.gz}} | gzip > {{ruta/a/alineamiento_solo_extremo.sam.gz}}` + +- Mapea las lecturas del par final (secuencias) al genoma indexado usando 32 subprocesos y comprime el resultado para ahorrar espacio: + +`bwa mem -t 32 {{ruta/a/referencia.fa}} {{ruta/a/lectura_par_final_1.fq.gz}} {{ruta/a/lectura_par_final_2.fq.gz}} | gzip > {{ruta/a/alineamiento_par_final.sam.gz}}` + +- Mapea las lecturas del par final (secuencias) al genoma indexado usando 32 subprocesos con [M]arcadores divididos más cortos como secundarios para la compatibilidad del archivo SAM de salida con el software Picard y luego comprime el resultado: + +`bwa mem -M -t 32 {{ruta/a/referencia.fa}} {{ruta/a/lectura_par_final_1.fq.gz}} {{ruta/a/lectura_par_final_2.fq.gz}} | gzip > {{ruta/a/alineamiento_par_final.sam.gz}}` + +- Mapea las lecturas finales del par (secuencias) al genoma indexado usando 32 subprocesos con [C]omentarios FASTA/Q (p. ej. BC:Z:CGTAC) anexando a un resultado comprimido: + +`bwa mem -C -t 32 {{ruta/a/referencia.fa}} {{ruta/a/lectura_par_final_1.fq.gz}} {{ruta/a/lectura_par_final_2.fq.gz}} | gzip > {{ruta/a/lectura_par_final.sam.gz}}` diff --git a/pages.es/linux/cacaclock.md b/pages.es/linux/cacaclock.md new file mode 100644 index 000000000..05acc6476 --- /dev/null +++ b/pages.es/linux/cacaclock.md @@ -0,0 +1,16 @@ +# cacaclock + +> Muestra la hora actual como arte ASCII. +> Más información: . + +- Muestra la hora: + +`cacaclock` + +- Cambia la fuente: + +`cacaclock -f {{fuente}}` + +- Cambia el formato usando una especificación de formato de `strftime`: + +`cacaclock -d {{argumentos_strftime}}` diff --git a/pages.es/linux/cacademo.md b/pages.es/linux/cacademo.md new file mode 100644 index 000000000..1939314b4 --- /dev/null +++ b/pages.es/linux/cacademo.md @@ -0,0 +1,8 @@ +# cacademo + +> Muestra una animación aleatoria de arte ASCII. +> Más información: . + +- Ve una animación: + +`cacademo` diff --git a/pages.es/linux/cacafire.md b/pages.es/linux/cacafire.md new file mode 100644 index 000000000..a4f75cedf --- /dev/null +++ b/pages.es/linux/cacafire.md @@ -0,0 +1,8 @@ +# cacafire + +> Muestra un fuego animado ASCII. +> Más información: . + +- Muestra el fuego ASCII: + +`cacafire` diff --git a/pages.es/linux/cacaview.md b/pages.es/linux/cacaview.md new file mode 100644 index 000000000..7c92ad80b --- /dev/null +++ b/pages.es/linux/cacaview.md @@ -0,0 +1,8 @@ +# cacaview + +> Muestra una imagen en formato PMN. +> Más información: . + +- Muestra una imagen: + +`cacaview {{ruta/a/imagen}}` diff --git a/pages.es/linux/choom.md b/pages.es/linux/choom.md new file mode 100644 index 000000000..1079d19f3 --- /dev/null +++ b/pages.es/linux/choom.md @@ -0,0 +1,16 @@ +# choom + +> Muestra y cambia el ajuste del OOM-killer. +> Más información: . + +- Muestra la puntuación OOM-killer del proceso con un identificador específico: + +`choom -p {{pid}}` + +- Modifica la puntuación OOM-killer de un proceso específico: + +`choom -p {{pid}} -n {{-1000..+1000}}` + +- Ejecuta un comando con una puntuación OOM-killer específica: + +`choom -n {{-1000..+1000}} {{comando}} {{argumento1 argumento2 ...}}` diff --git a/pages.es/linux/compseq.md b/pages.es/linux/compseq.md new file mode 100644 index 000000000..f7ff334f0 --- /dev/null +++ b/pages.es/linux/compseq.md @@ -0,0 +1,36 @@ +# compseq + +> Calcula la composición de palabras únicas en secuencias. +> Más información: . + +- Cuenta frecuencias observadas de palabras en un archivo FASTA, proporcionando valores de parámetros interactivamente: + +`compseq {{ruta/al/archivo.fasta}}` + +- Cuenta frecuencias observadas de pares de aminoácidos en un archivo FASTA, y guarda el resultado en un archivo de texto: + +`compseq {{ruta/al/archivo_proteina.fasta}} -word 2 {{ruta/al/archivo_de_salida.comp}}` + +- Cuenta las frecuencias observadas de hexanucleótidos en un archivo FASTA, luego guarda el resultado en un archivo de texto e ignora los recuentos cero: + +`compseq {{ruta/al/archivo_de_entrada.fasta}} -word 6 {{ruta/al/archivo_de_salida.comp}} -nozero` + +- Cuenta las frecuencias observadas de codones en un marco de lectura concreto, ignorando cualquier recuento superpuesto (es decir, desplaza la ventana en longitud de palabra 3): + +`compseq -sequence {{ruta/al/archivo_de_ingreso_rna.fasta}} -word 3 {{ruta/al/archivo_de_salida.comp}} -nozero -frame {{1}}` + +- Cuenta las frecuencias observadas de codones desplazados en 3 posiciones; ignorando los recuentos superpuestos (debería informar de todos los codones excepto el primero): + +`compseq -sequence {{ruta/al/archivo_de_ingreso_rna.fasta}} -word 3 {{ruta/al/archivo_de_salida.comp}} -nozero -frame 3` + +- Cuenta tripletes de aminoácidos en un archivo FASTA y compara con una ejecución anterior de `compseq` para calcular los valores de frecuencia esperados y normalizados: + +`compseq -sequence {{ruta/al/proteoma_humano.fasta}} -word 3 {{ruta/al/archivo_salida1.comp}} -nozero -infile {{ruta/al/archivo_de_salida2.comp}}` + +- Aproxima el comando anterior sin un archivo previamente preparado, calculando las frecuencias esperadas usando las frecuencias de una sola base/residuo en la(s) secuencia(s) de entrada suministrada(s): + +`compseq -sequence {{ruta/al/proteoma_humano.fasta}} -word 3 {{ruta/al/archivo_de_salida.comp}} -nozero -calcfreq` + +- Muestra ayuda (utiliza `-help -verbose` para obtener más información sobre los calificadores asociados y generales): + +`compseq -help` diff --git a/pages.es/linux/ctop.md b/pages.es/linux/ctop.md new file mode 100644 index 000000000..0d5c25461 --- /dev/null +++ b/pages.es/linux/ctop.md @@ -0,0 +1,20 @@ +# ctop + +> Visualiza instantáneamente el rendimiento y la salud del contenedor con métricas en tiempo real sobre el uso de CPU, memoria y bloques de IO. +> Más información: . + +- Muestra sólo contenedores [a]ctivos: + +`ctop -a` + +- [r]evierte el orden de clasificación de los contenedores: + +`ctop -r` + +- [i]nvierte los colores predeterminados: + +`ctop -i` + +- Muestra ayuda: + +`ctop -h` diff --git a/pages.es/linux/dd.md b/pages.es/linux/dd.md new file mode 100644 index 000000000..d4fa28b2a --- /dev/null +++ b/pages.es/linux/dd.md @@ -0,0 +1,28 @@ +# dd + +> Convierte y copia un archivo. +> Más información: . + +- Crea una unidad USB de arranque a partir de un archivo isohybrid (como `archlinux-xxx.iso`) y muestra el progreso: + +`dd if={{ruta/al/archivo.iso}} of={{/dev/unidad_usb}} status=progress` + +- Clona una unidad a otra con un tamaño de bloque de 4 MiB y descarga las escrituras antes de que el comando termine: + +`dd bs=4M conv=fsync if={{/dev/unidad_de_origen}} of={{/dev/unidad_de_descarga}}` + +- Genera un archivo con un número específico de bytes aleatorios utilizando el controlador aleatorio del kernel: + +`dd bs={{100}} count={{1}} if=/dev/urandom of={{ruta/al/archivo_aleatorio}}` + +- Compara el rendimiento de escritura de un disco: + +`dd bs={{1M}} count={{1024}} if=/dev/zero of={{ruta/al/fichero_1GB}}` + +- Crea una copia de seguridad del sistema en un archivo IMG (puede restaurarla más tarde intercambiando `if` y `of`), y muestra el progreso: + +`dd if={{/dev/unidad_dispositivo}} of={{ruta/al/archivo.img}} status=progress` + +- Comprueba el progreso de una operación `dd` en curso (ejecute este comando desde otro intérprete de comandos): + +`kill -USR1 $(pgrep -x dd)` diff --git a/pages.es/linux/debuginfod-find.md b/pages.es/linux/debuginfod-find.md new file mode 100644 index 000000000..dc1a4d869 --- /dev/null +++ b/pages.es/linux/debuginfod-find.md @@ -0,0 +1,8 @@ +# debuginfod-find + +> Solicita datos relacionados con debuginfo. +> Más información: . + +- Solicita datos basados en `build_id`: + +`debuginfod-find -vv debuginfo {{identificador_de_build}}` diff --git a/pages.es/linux/dhcpcd.md b/pages.es/linux/dhcpcd.md new file mode 100644 index 000000000..4e6ae735b --- /dev/null +++ b/pages.es/linux/dhcpcd.md @@ -0,0 +1,12 @@ +# dhcpcd + +> Cliente DHCP. +> Más información: . + +- Libera todas las direcciones: + +`sudo dhcpcd --release` + +- Solicita nuevas direcciones al servidor DHCP: + +`sudo dhcpcd --rebind` diff --git a/pages.es/linux/dnf5.md b/pages.es/linux/dnf5.md new file mode 100644 index 000000000..6227db1db --- /dev/null +++ b/pages.es/linux/dnf5.md @@ -0,0 +1,38 @@ +# dnf5 + +> Programa de gestión de paquetes para RHEL, Fedora y CentOS (reemplaza a dnf, que a su vez reemplazó a yum). +> DNF5 es una reescritura en C++ del gestor de paquetes DNF con mejor rendimiento y menor tamaño. +> Para comandos equivalentes en otros gestores de paquetes, vea . +> Más información: . + +- Actualiza los paquetes instalados a las versiones más recientes disponibles: + +`sudo dnf5 upgrade` + +- Busca paquetes mediante palabras clave: + +`dnf5 search {{palabra_clave1 palabra_clave2 ...}}` + +- Muestra detalles sobre un paquete: + +`dnf5 info {{paquete}}` + +- Instala nuevos paquetes (Nota: usa la opción `-y` para saltar todas las confirmaciones): + +`sudo dnf5 install {{paquete1 paquete2 ...}}` + +- Elimina paquetes: + +`sudo dnf5 remove {{paquete1 paquete2 ...}}` + +- Lista paquetes instalados: + +`dnf5 list --installed` + +- Busca que paquetes proporcionan un comando determinado: + +`dnf5 provides {{comando}}` + +- Elimina o expira los datos almacenados en caché: + +`sudo dnf5 clean all` diff --git a/pages.es/linux/eu-readelf.md b/pages.es/linux/eu-readelf.md new file mode 100644 index 000000000..91a8272a0 --- /dev/null +++ b/pages.es/linux/eu-readelf.md @@ -0,0 +1,12 @@ +# eu-readelf + +> Muestra información sobre archivos ELF. +> Más información: . + +- Muestra toda la información extraíble en un archivo ELF: + +`eu-readelf --all {{ruta/al/archivo}}` + +- Muestra el contenido de todos los segmentos y secciones de NOTE, o de un segmento o sección en particular: + +`eu-readelf --notes[={{.note.ABI-tag}}] {{ruta/al/fichero}}` diff --git a/pages.es/linux/getenforce.md b/pages.es/linux/getenforce.md new file mode 100644 index 000000000..bdbc65e1b --- /dev/null +++ b/pages.es/linux/getenforce.md @@ -0,0 +1,8 @@ +# getenforce + +> Obtén el modo actual de SELinux (es decir, obligatorio, permisivo o deshabilitado). +> Más información: . + +- Muestra el modo actual de SELinux: + +`getenforce` diff --git a/pages.es/linux/hyprctl.md b/pages.es/linux/hyprctl.md new file mode 100644 index 000000000..57b05b6ab --- /dev/null +++ b/pages.es/linux/hyprctl.md @@ -0,0 +1,32 @@ +# hyprctl + +> Controla partes del compositor Hyprland Wayland. +> Más información: . + +- Recarga la configuración de Hyprland: + +`hyprctl reload` + +- Muestra el nombre de la ventana activa: + +`hyprctl activewindow` + +- Lista todos los dispositivos de entrada conectados: + +`hyprctl devices` + +- Lista todas las salidas con sus respectivas propiedades: + +`hyprctl workspaces` + +- Llama a un gestor con un argumento: + +`hyprctl dispatch exec {{aplicación}}` + +- Establece una palabra clave de configuración de forma dinámica: + +`hyprctl keyword {{palabra_clave}} {{valor}}` + +- Muestra versión: + +`hyprctl version` diff --git a/pages.es/linux/ip-route-list.md b/pages.es/linux/ip-route-list.md index b7142cc4f..95bfa1e8d 100644 --- a/pages.es/linux/ip-route-list.md +++ b/pages.es/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> Este comando es un alias de `ip-route-show`. +> Este comando es un alias de `ip route show`. - Muestra la documentación del comando original: diff --git a/pages.es/linux/iwlist.md b/pages.es/linux/iwlist.md new file mode 100644 index 000000000..39f438a2c --- /dev/null +++ b/pages.es/linux/iwlist.md @@ -0,0 +1,36 @@ +# iwlist + +> Obtén información detallada de una interfaz inalámbrica. +> Más información: . + +- Muestra la lista de puntos de acceso y células ad-hoc en alcance: + +`iwlist {{interfaz_inalámbrica}} scan` + +- Muestra las frecuencias disponibles en el dispositivo: + +`iwlist {{interfaz_inalámbrica}} frequency` + +- Lista las tasas de bits soportadas por el dispositivo: + +`iwlist {{interfaz_inalámbrica}} rate` + +- Enumera los parámetros de autenticación WPA configurados actualmente: + +`iwlist {{interfaz_inalámbrica}} auth` + +- Enumera todas las claves de cifrado WPA configuradas en el dispositivo: + +`iwlist {{interfaz_inalámbrica}} wpakeys` + +- Enumera los tamaños de clave de cifrado admitidos y todas las claves de cifrado configuradas en el dispositivo: + +`iwlist {{interfaz_inalámbrica}} keys` + +- Enumera los distintos atributos y modos de gestión de energía del dispositivo: + +`iwlist {{interfaz_inalámbrica}} power` + +- Enumera los elementos de información genéricos configurados en el dispositivo (utilizados para la compatibilidad con WPA): + +`iwlist {{interfaz_inalámbrica}} genie` diff --git a/pages.es/linux/last.md b/pages.es/linux/last.md new file mode 100644 index 000000000..074a6a82c --- /dev/null +++ b/pages.es/linux/last.md @@ -0,0 +1,37 @@ +# last + +> Lista la información de los últimos inicios de sesión de usuario. +> Vea también: `lastb`, `login`. +> Más información: . + +- Lista la información de inicio de sesión (por ejemplo, nombre de usuario, terminal, tiempo de arranque, núcleo) de todos los usuarios: + +`last` + +- Lista la información de inicio de sesión de un usuario específico: + +`last {{nombre_de_usuario}}` + +- Muestra la información de una terminal específica: + +`last {{tty1}}` + +- Lista la información actualizada (por defecto, la más reciente aparece al principio): + +`last | tac` + +- Muestra información sobre el arranque del sistema: + +`last "{{system boot}}"` + +- Lista información con un formato de [t]iempo específico: + +`last --time-format {{notime|full|iso}}` + +- Lista información desde una fecha y hora específica: + +`last --since {{-7days}}` + +- Muestra información (es decir, nombre e IP) de hosts remotos: + +`last --dns` diff --git a/pages.es/linux/mkfs.f2fs.md b/pages.es/linux/mkfs.f2fs.md new file mode 100644 index 000000000..9ae721f56 --- /dev/null +++ b/pages.es/linux/mkfs.f2fs.md @@ -0,0 +1,12 @@ +# mkfs.f2fs + +> Crea un sistema de archivos F2FS en una partición. +> Más información: . + +- Crea un sistema de archivos F2FS en la primera partición del dispositivo b (`sdb1`): + +`sudo mkfs.f2fs {{/dev/sdb1}}` + +- Crea un sistema de archivos F2FS con una etiqueta de volumen: + +`sudo mkfs.f2fs -l {{etiqueta_volumen}} {{/dev/sdb1}}` diff --git a/pages.es/linux/mount.ddi.md b/pages.es/linux/mount.ddi.md new file mode 100644 index 000000000..7b5fa6749 --- /dev/null +++ b/pages.es/linux/mount.ddi.md @@ -0,0 +1,9 @@ +# mount.ddi + +> Monta imágenes de disco reconocibles. +> Vea `tldr systemd-dissect` para otros comandos relevantes para DDIs. +> Más información: . + +- Monta una imagen con un sistema operativo: + +`mount.ddi {{ruta/a/imagen.raw}} {{/mnt/image}}` diff --git a/pages.es/linux/ntpd.md b/pages.es/linux/ntpd.md new file mode 100644 index 000000000..e4d50ab5b --- /dev/null +++ b/pages.es/linux/ntpd.md @@ -0,0 +1,16 @@ +# ntpd + +> El daemon oficial de NTP (Network Time Protocol) para sincronizar el reloj del sistema con servidores de tiempo remotos o relojes de referencia locales. +> Más información: . + +- Inicia el daemon: + +`sudo ntpd` + +- Sincroniza la hora del sistema con servidores remotos una sola vez (sale después de sincronizar): + +`sudo ntpd --quit` + +- Sincroniza una sola vez permitiendo "grandes" ajustes: + +`sudo ntpd --panicgate --quit` diff --git a/pages.es/linux/objcopy.md b/pages.es/linux/objcopy.md new file mode 100644 index 000000000..e7e148c95 --- /dev/null +++ b/pages.es/linux/objcopy.md @@ -0,0 +1,24 @@ +# objcopy + +> Copia el contenido de un archivo de objetos a otro archivo. +> Más información: . + +- Copia datos a otro archivo: + +`objcopy {{ruta/al/archivo_de_origen}} {{ruta/al/archivo_de_destino}}` + +- Traduce ficheros de un formato a otro: + +`objcopy --input-target={{formato_de_entrada}} --output-target {{formato_de_salida}} {{ruta/al/archivo_de_origen}} {{ruta/al/archivo_de_destino}}` + +- Elimina toda la información de símbolos del archivo: + +`objcopy --strip-all {{ruta/al/archivo_de_origen}} {{ruta/al/archivo_de_destino}}` + +- Elimina la información de depuración del archivo: + +`objcopy --strip-debug {{ruta/al/archivo_de_origen}} {{ruta/al/archivo_de_destino}}` + +- Copia una sección específica del archivo de origen al archivo de destino: + +`objcopy --only-section {{section}} {{ruta/al/archivo_de_origen}} {{ruta/al/archivo_de_destino}}` diff --git a/pages.es/linux/poweroff.md b/pages.es/linux/poweroff.md index 0b06e1f03..6c0dea0d0 100644 --- a/pages.es/linux/poweroff.md +++ b/pages.es/linux/poweroff.md @@ -1,7 +1,7 @@ # poweroff > Apaga la máquina. -> Más información: . +> Más información: . - Apaga la máquina: diff --git a/pages.es/linux/pw-metadata.md b/pages.es/linux/pw-metadata.md new file mode 100644 index 000000000..326723983 --- /dev/null +++ b/pages.es/linux/pw-metadata.md @@ -0,0 +1,33 @@ +# pw-metadata + +> Supervisa, establece y elimina metadatos en objetos PipeWire. +> Vea también: `pipewire`, `pw-mon`, `pw-cli`. +> Más información: . + +- Muestra metadatos en el formato por defecto: + +`pw-metadata` + +- Muestra metadatos con el identificador 0 en `settings`: + +`pw-metadata {{-n|--name}} {{settings}} {{0}}` + +- Lista todos los objetos de metadatos disponibles: + +`pw-metadata {{-l|--list}}` + +- Continua ejecutando y registrando los cambios en los metadatos: + +`pw-metadata {{-m|--monitor}}` + +- Elimina todos los metadatos: + +`pw-metadata {{-d|--delete}}` + +- Ajusta `log.level` a 1 en `settings`: + +`pw-metadata --name {{settings}} {{0}} {{log.level}} {{1}}` + +- Muestra ayuda: + +`pw-metadata --help` diff --git a/pages.es/linux/pwdx.md b/pages.es/linux/pwdx.md index 421742ee0..72c85bd5d 100644 --- a/pages.es/linux/pwdx.md +++ b/pages.es/linux/pwdx.md @@ -5,4 +5,4 @@ - Muestra el directorio de trabajo actual de un proceso: -`pwdx {{process_id}}` +`pwdx {{identificador_de_proceso}}` diff --git a/pages.es/linux/readelf.md b/pages.es/linux/readelf.md new file mode 100644 index 000000000..1c0b52cbb --- /dev/null +++ b/pages.es/linux/readelf.md @@ -0,0 +1,24 @@ +# readelf + +> Muestra información sobre archivos ELF. +> Más información: . + +- Muestra toda la información de un archivo ELF: + +`readelf -all {{ruta/al/archivo_binario}}` + +- Muestra todas las cabeceras presentes en un archivo ELF: + +`readelf --headers {{ruta/al/archivo_binario}}` + +- Muestra las entradas en la sección de la tabla de símbolos del archivo ELF, si tiene una: + +`readelf --symbols {{ruta/al/archivo_binario}}` + +- Muestra la información de la cabecera ELF: + +`readelf --file-header {{ruta/al/archivo_binario}}` + +- Muestra información de cabecera de la sección ELF: + +`readelf --section-headers {{ruta/al/archivo_binario}}` diff --git a/pages.es/linux/rpi-otp-private-key.md b/pages.es/linux/rpi-otp-private-key.md new file mode 100644 index 000000000..0c8d340a0 --- /dev/null +++ b/pages.es/linux/rpi-otp-private-key.md @@ -0,0 +1,8 @@ +# rpi-otp-private-key + +> Muestra la llave privada de la clave de un solo uso (OTP) de una Raspberry Pi. +> Más información: . + +- Lee la clave privada OTP: + +`rpi-otp-private-key` diff --git a/pages.es/linux/showkey.md b/pages.es/linux/showkey.md new file mode 100644 index 000000000..1cd24d946 --- /dev/null +++ b/pages.es/linux/showkey.md @@ -0,0 +1,24 @@ +# showkey + +> Muestra el código de las teclas pulsadas en el teclado, útil para depurar problemas relacionados con el teclado y la reasignación de teclas. +> Más información: . + +- Visualiza códigos de teclas en decimal: + +`sudo showkey` + +- Visualiza códigos de rastreo en hexadecimal: + +`sudo showkey {{-s|--scancodes}}` + +- Muestra códigos de teclas en decimal (por defecto): + +`sudo showkey {{-k|--keycodes}}` + +- Muestra los códigos en ASCII, decimal y hexadecimal: + +`sudo showkey {{-a|--ascii}}` + +- Sal del programa: + +`Ctrl + d` diff --git a/pages.es/linux/systemctl.md b/pages.es/linux/systemctl.md index 1f4381d14..0a287dfba 100644 --- a/pages.es/linux/systemctl.md +++ b/pages.es/linux/systemctl.md @@ -1,6 +1,6 @@ # systemctl -> Controla el sistema systemd y el gestor de servicios. +> Controla el gestor de sistemas y servicios systemd. > Más información: . - Muestra todos los servicios en ejecución: @@ -11,26 +11,26 @@ `systemctl --failed` -- Inicia/Para/Reinicia/Recarga un servicio: +- Inicia, para, reinicia, recarga o muestra el estado de una unidad: -`systemctl {{start|stop|restart|reload}} {{unidad}}` +`systemctl {{start|stop|restart|reload|status}} {{unidad}}` -- Muestra el estado de una unidad: +- Habilita o deshabilita una unidad para iniciarla al arrancar: -`systemctl status {{unidad}}` +`systemctl {{enable|disable}} {{unidad}}` -- Habilita/Deshabilita una unidad para que se inicie en el arranque: - -`systemctl {{enable/disable}} {{unidad}}` - -- Enmascara/Desenmascara una unidad para evitar su habilitación y activación manual: - -`systemctl {{mask|unmask}} {{unidad}}` - -- Recarga systemd, buscando unidades nuevas o modificadas: +- Reinicia systemd, lee unidades nuevas o modificadas: `systemctl daemon-reload` -- Comprueba si una unidad está habilitada: +- Checa si una unidad está activa, habilitada, o en estado fallido: -`systemctl is-enabled {{unidad}}` +`systemctl {{is-active|is-enabled|is-failed}} {{unidad}}` + +- Lista todos los servicios, sockets, unidades auto-montadas filtradas por estado en ejecución o fallido: + +`systemctl list-units --type={{service|socket|automount}} --state={{failed|running}}` + +- Muestra los contenidos y la ruta absoluta del archivo de una unidad: + +`systemctl cat {{unidad}}` diff --git a/pages.es/linux/systemd-tmpfiles.md b/pages.es/linux/systemd-tmpfiles.md new file mode 100644 index 000000000..7ed2c88ec --- /dev/null +++ b/pages.es/linux/systemd-tmpfiles.md @@ -0,0 +1,25 @@ +# systemd-tmpfiles + +> Crea, elimina y limpia archivos y directorios volátiles y temporales. +> Este comando es invocado automáticamente en el arranque por los servicios de systemd, ejecutarlo manualmente tiende a ser innecesario. +> Más información: . + +- Crea los archivos y directorios especificados en el archivo de configuración: + +`systemd-tmpfiles --create` + +- Limpia archivos y directorios con los parámetros de edad configurados: + +`systemd-tmpfiles --clean` + +- Elimina archivos y directorios según lo especificado en el archivo de configuración: + +`systemd-tmpfiles --remove` + +- Aplica operaciones en archivos de configuración específicos de usuario: + +`systemd-tmpfiles --create --user` + +- Ejecuta las líneas marcadas para el inicio del arranque: + +`systemd-tmpfiles --create --boot` diff --git a/pages.es/linux/systool.md b/pages.es/linux/systool.md new file mode 100644 index 000000000..1e7fd119a --- /dev/null +++ b/pages.es/linux/systool.md @@ -0,0 +1,17 @@ +# systool + +> Vea información de dispositivos del sistema por bus, y clases. +> Este comando es parte del paquete `sysfs`. +> Más información: . + +- Lista todos los atributos de los dispositivos de un bus (ej. `pci`, `usb`). Vea todos los buses usando `ls /sys/bus`: + +`systool -b {{bus}} -v` + +- Lista todos los atributos de una clase de dispositivos (ej. `drm`, `block`). Vea todas las clases usando `ls /sys/class`: + +`systool -c {{clase}} -v` + +- Mostrar solo los controladores de un bus (ej. `pci`, `usb`): + +`systool -b {{bus}} -D` diff --git a/pages.es/linux/top.md b/pages.es/linux/top.md index 2c4ceabce..3a15d0ee8 100644 --- a/pages.es/linux/top.md +++ b/pages.es/linux/top.md @@ -21,7 +21,7 @@ - Muestra los hilos individuales de un proceso dado: -`top -Hp {{id_proceso}}` +`top -Hp {{identificador_de_proceso}}` - Muestra solo los procesos con un(os) PID(s) dado(s), separados por comas. (Normalmente no se conoce el PID de antemano. Este ejemplo lo obtiene del nombre del proceso): diff --git a/pages.es/linux/tor.md b/pages.es/linux/tor.md new file mode 100644 index 000000000..1283d04e1 --- /dev/null +++ b/pages.es/linux/tor.md @@ -0,0 +1,32 @@ +# tor + +> Habilita la comunicación anónima a través de la red Tor. +> Más información: . + +- Conecta a la red Tor: + +`tor` + +- Vea la configuración de Tor: + +`tor --config` + +- Comprueba el estado de Tor: + +`tor --status` + +- Ejecuta como cliente: + +`tor --client` + +- Ejecuta como relé: + +`tor --relay` + +- Ejecuta como puente: + +`tor --bridge` + +- Ejecuta como servicio oculto: + +`tor --hidden-service` diff --git a/pages.es/linux/torify.md b/pages.es/linux/torify.md new file mode 100644 index 000000000..b8b99ccfb --- /dev/null +++ b/pages.es/linux/torify.md @@ -0,0 +1,33 @@ +# torify + +> Enruta el tráfico de red a través de la red Tor. +> Nota: Este comando está desfasado, y ahora es un empaquetador compatible con versiones anteriores de `torsocks`. +> Más información: . + +- Enruta el tráfico a través de Tor: + +`torify {{comando}}` + +- Activa o desactiva Tor en el intérprete de comandos: + +`torify {{on|off}}` + +- Crea un intérprete de órdenes con Tor activado: + +`torify --shell` + +- Checa si hay un intérprete de órdenes con Tor activado: + +`torify show` + +- Especifica el archivo de configuración de Tor: + +`torify -c {{archivo_de_configuración}} {{comando}}` + +- Usa un proxy Tor SOCKS específico: + +`torify -P {{proxy}} {{comando}}` + +- Redirige la salida a un archivo: + +`torify {{comando}} > {{ruta/a/archivo_de_salida}}` diff --git a/pages.es/linux/torsocks.md b/pages.es/linux/torsocks.md new file mode 100644 index 000000000..189ed3be7 --- /dev/null +++ b/pages.es/linux/torsocks.md @@ -0,0 +1,12 @@ +# torsocks + +> Utiliza cualquier aplicación a través de la red de Tor. +> Más información: . + +- Ejecuta un comando usando Tor: + +`torsocks {{comando}}` + +- Activa o desactiva Tor en este intérprete de comandos: + +`. torsocks {{on|off}}` diff --git a/pages.es/linux/tunelp.md b/pages.es/linux/tunelp.md new file mode 100644 index 000000000..e0fb9fa92 --- /dev/null +++ b/pages.es/linux/tunelp.md @@ -0,0 +1,25 @@ +# tunelp + +> Establece varios parámetros para dispositivos de puerto paralelo para la solución de problemas o para un mejor rendimiento. +> Parte de `util-linux`. +> Más información: . + +- Comprueba el e[s]tado de un dispositivo de puerto paralelo: + +`tunelp --status {{/dev/lp0}}` + +- Restablece un puerto paralelo: + +`tunelp --reset {{/dev/lp0}}` + +- Utiliza un [i]RQ dado para un dispositivo, cada uno representando una línea de interrupción: + +`tunelp -i 5 {{/dev/lp0}}` + +- Intenta imprimir varias veces un [c]arácter en la impresora antes de permanecer inactiva durante un [t]iempo determinado: + +`tunelp --chars {{veces}} --time {{tiempo_en_centisegundos}} {{/dev/lp0}}` + +- Activa o desactiva el [a]bortar por error (desactivado por defecto): + +`tunelp --abort {{on|off}}` diff --git a/pages.es/linux/turbostat.md b/pages.es/linux/turbostat.md new file mode 100644 index 000000000..713a02dba --- /dev/null +++ b/pages.es/linux/turbostat.md @@ -0,0 +1,24 @@ +# turbostat + +> Informa de la topología del procesador, frecuencia, temperatura, potencia y estadísticas de inactividad. +> Más información: . + +- Muestra las estadísticas cada cinco segundos: + +`sudo turbostat` + +- Muestra las estadísticas cada cierto número de segundos: + +`sudo turbostat -i {{n_segundos}}` + +- Muestra información sin decodificar ni imprimir la cabecera de configuración del sistema: + +`sudo turbostat --quiet` + +- Muestra información útil sobre el CPU cada segundo, sin información de cabecera: + +`sudo turbostat --quiet --interval 1 --cpu 0-{{cuenta_hilos_CPU}} --show "PkgWatt","Busy%","Core","CoreTmp","Thermal"` + +- Muestra ayuda: + +`turbostat --help` diff --git a/pages.es/linux/vnstat.md b/pages.es/linux/vnstat.md new file mode 100644 index 000000000..248585d7b --- /dev/null +++ b/pages.es/linux/vnstat.md @@ -0,0 +1,24 @@ +# vnstat + +> Monitor de tráfico de red de línea de comandos. +> Más información: . + +- Muestra un resumen de tráfico de todas las interfaces: + +`vnstat` + +- Muestra un resumen de tráfico de una interfaz de red específica: + +`vnstat -i {{interfaz_de_red}}` + +- Muestra estadísticas en vivo de una interfaz de red específica: + +`vnstat -l -i {{interfaz_de_red}}` + +- Muestra estadísticas de tráfico por hora durante las últimas 24 horas mediante un gráfico de barras: + +`vnstat -hg` + +- Mide y muestra el tráfico promedio por 30 segundos: + +`vnstat -tr {{30}}` diff --git a/pages.es/linux/vnstati.md b/pages.es/linux/vnstati.md new file mode 100644 index 000000000..765bb3315 --- /dev/null +++ b/pages.es/linux/vnstati.md @@ -0,0 +1,20 @@ +# vnstati + +> Genera imágenes PNG compatibles con vnStat. +> Más información: . + +- Genera un resumen de los últimos dos meses, días, etc: + +`vnstati --summary --iface {{interfaz_de_red}} --output {{ruta/a/salida.png}}` + +- Genera los 10 días con mayor tráfico de todos los tiempos: + +`vnstati --top 10 --iface {{interfaz_de_red}} --output {{ruta/a/salida.png}}` + +- Genera estadísticas de tráfico mensual de los últimos 12 meses: + +`vnstati --months --iface {{interfaz_de_red}} --output {{ruta/a/salida.png}}` + +- Genera estadísticas de tráfico por hora de las últimas 24 horas: + +`vnstati --hours --iface {{interfaz_de_red}} --output {{ruta/a/salida.png}}` diff --git a/pages.es/linux/waypipe.md b/pages.es/linux/waypipe.md new file mode 100644 index 000000000..a65bdd930 --- /dev/null +++ b/pages.es/linux/waypipe.md @@ -0,0 +1,12 @@ +# waypipe + +> Ejecuta remotamente aplicaciones gráficas bajo un compositor para Wayland. +> Más información: . + +- Ejecuta un programa gráfico remotamente y muestralo localmente: + +`waypipe ssh {{usuario}}@{{servidor}} {{programa}}` + +- Abre un túnel SSH para ejecutar cualquier programa de forma remota y visualizarlo localmente: + +`waypipe ssh {{usuario}}@{{servidor}}` diff --git a/pages.es/linux/ydotool.md b/pages.es/linux/ydotool.md new file mode 100644 index 000000000..958e43df4 --- /dev/null +++ b/pages.es/linux/ydotool.md @@ -0,0 +1,20 @@ +# ydotool + +> Controla las entradas de teclado y ratón mediante comandos de forma agnóstica al servidor de visualización. +> Más información: . + +- Inicia el daemon ydotool en segundo plano: + +`ydotoold` + +- Realiza un clic con el botón izquierdo: + +`ydotool click 0xC0` + +- Realiza un clic con el botón derecho: + +`ydotool click 0xC1` + +- Ingresa la combinación de teclas Alt+F4: + +`ydotool key 56:1 62:1 62:0 56:0` diff --git a/pages.es/osx/arch.md b/pages.es/osx/arch.md index be3a6e2f8..bc65757b1 100644 --- a/pages.es/osx/arch.md +++ b/pages.es/osx/arch.md @@ -1,7 +1,7 @@ # arch > Muestra el nombre de la arquitectura del sistema, o ejecuta un comando bajo una arquitectura diferente. -> Véase también: `uname`. +> Vea también: `uname`. > Más información: . - Muestra la arquitectura del sistema: diff --git a/pages.es/osx/dd.md b/pages.es/osx/dd.md index 0ddfee828..c196b4cb4 100644 --- a/pages.es/osx/dd.md +++ b/pages.es/osx/dd.md @@ -9,24 +9,20 @@ - Clona una unidad a otra unidad con un bloque de 4 MB, ignora el error y muestra el progreso: -`dd if={{/dev/dispositivo_de origen}} of={{/dev/dispositivo_de destino}} bs={{4m}} conv={{noerror}} status=progress` +`dd bs=4m conv=noerror if={{/dev/dispositivo_de origen}} of={{/dev/dispositivo_de destino}} status=progress` -- Genera un fichero de 100 bytes aleatorios utilizando el controlador aleatorio del kernel: +- Genera un archivo con un número específico de bytes aleatorios utilizando el controlador aleatorio del núcleo: -`dd if=/dev/urandom of={{ruta/al/archivo_aleatorio}} bs={{100}} count={{1}}` +`dd bs={{100}} count={{1}} if=/dev/urandom of={{ruta/al/archivo_aleatorio}}` - Compara el rendimiento de escritura de un disco: -`dd if=/dev/zero of={{ruta/para/archivo_1GB}} bs={{1024}} count={{1000000}}` +`dd bs={{1024}} count={{1000000}} if=/dev/zero of={{ruta/para/archivo_1GB}}` - Genera una copia de seguridad del sistema en un archivo IMG y muestra el progreso: -`dd if=/dev/{{dispositivo_unidad}} of={{ruta/al/archivo.img}} status=progress` +`dd if={{/dev/dispositivo_unidad}} of={{ruta/al/archivo.img}} status=progress` -- Restaura una unidad desde un archivo IMG y muestra el progreso: +- Comprueba el progreso de una operación `dd` en curso (ejecuta este comando desde otro intérprete de comandos): -`dd if={{ruta/al/archivo.img}} of={{/dev/unidad_dispositivo}} status=progress` - -- Comprueba el progreso de una operación dd en curso (ejecuta este comando desde otro shell): - -`kill -USR1 $(pgrep -x dd)` +`kill -USR1 $(pgrep ^dd)` diff --git a/pages.es/osx/diskutil-partitiondisk.md b/pages.es/osx/diskutil-partitiondisk.md new file mode 100644 index 000000000..0d6ee9876 --- /dev/null +++ b/pages.es/osx/diskutil-partitiondisk.md @@ -0,0 +1,26 @@ +# diskutil partitionDisk + +> Utilidad para gestionar particiones en discos y volúmenes. +> Parte de `diskutil`. +> APM solo es compatible con macOS, MBR está optimizado para DOS, mientras que GPT es compatible con la mayoría de los sistemas operativos modernos. +> Más información: . + +- Reformatea un volumen usando el esquema de particionado APM/MBR/GPT, sin dejar particiones en su interior (esto borrará todos los datos del volumen): + +`diskutil partitionDisk {{/dev/dispositivo_de_disco}} 0 {{APM|MBR|GPT}}` + +- Reformatea un volumen, luego crea una única partición usando un sistema de archivos específico llenando todo el espacio libre: + +`diskutil partitionDisk {{/dev/dispositivo_de_disco}} 1 {{APM|MBR|GPT}} {{partición_con_sistema_de_archivos}} {{nombre_de_partición}}` + +- Reformatea un volumen, luego crea una única partición con un sistema de archivos y tamaño específico (ej. `16G` para 16GB o `50%` para llenar la mitad del tamaño total del volumen): + +`diskutil partitionDisk {{/dev/dispositivo_de_disco}} 1 {{APM|MBR|GPT}} {{partición_con_sistema_de_archivos}} {{nombre_de_partición}} {{tamaño_de_partición}}` + +- Reformatea un volumen y crea múltiples particiones: + +`diskutil partitionDisk {{/dev/dispositivo_disco}} {{número_particiones}} {{APM|MBR|GPT}} {{partición_sistema_archivos1}} {{nombre_partición1}} {{tamaño_partición1}} {{partición_sistema_archivos2}} {{nombre_partición2}} {{tamaño_partición2}} ...` + +- Lista todos los sistemas de ficheros soportados para particionar: + +`diskutil listFilesystems` diff --git a/pages.es/osx/ping.md b/pages.es/osx/ping.md index e17f27801..14671a1d9 100644 --- a/pages.es/osx/ping.md +++ b/pages.es/osx/ping.md @@ -11,18 +11,18 @@ `ping -c {{cuenta}} "{{host}}"` -- Ping al `host`, especificando el intervalo en `segundos` entre peticiones (por defecto es 1 segundo): +- Ping al host, especificando el intervalo en segundos entre peticiones (por defecto es 1 segundo): `ping -i {{segundos}} "{{host}}"` -- Ping a `host` sin intentar buscar nombres simbólicos para las direcciones: +- Ping al host sin intentar buscar nombres simbólicos para las direcciones: `ping -n "{{host}}"` -- Ping al `host` y hace sonar la campana cuando se recibe un paquete (si tu terminal lo soporta): +- Ping al host y hace sonar la campana cuando se recibe un paquete (si tu terminal lo soporta): `ping -a "{{host}}"` -- Ping al `host` y muestra la hora en la que se ha recibido un paquete (esta opción es un añadido de Apple): +- Ping al host y muestra la hora en la que se ha recibido un paquete (esta opción es un añadido de Apple): `ping --apple-time "{{host}}"` diff --git a/pages.es/osx/shuf.md b/pages.es/osx/shuf.md index 98d2b6e54..ce4bf5d0b 100644 --- a/pages.es/osx/shuf.md +++ b/pages.es/osx/shuf.md @@ -9,7 +9,7 @@ - Sólo muestra las 5 primeras entradas del resultado: -`shuf --head-count={{5}} {{nombre_archivo}}` +`shuf --head-count=5 {{nombre_archivo}}` - Escribe el resultado en otro archivo: @@ -17,4 +17,4 @@ - Genera números aleatorios en el rango 1-10: -`shuf --input-range={{1-10}}` +`shuf --input-range=1-10` diff --git a/pages.es/osx/split.md b/pages.es/osx/split.md index e44f22524..32c8bbff1 100644 --- a/pages.es/osx/split.md +++ b/pages.es/osx/split.md @@ -5,16 +5,16 @@ - Divide un archivo, cada división tiene 10 líneas (excepto la última división): -`split -l {{10}} {{nombre_de_archivo}}` +`split -l 10 {{ruta/al/archivo}}` - Divide un fichero mediante una expresión regular. La línea que coincida será la primera línea del siguiente archivo de salida: -`split -p {{cat|^[dh]og}} {{nombre_de_archivo}}` +`split -p {{cat|^[dh]og}} {{ruta/al/archivo}}` - Divide un archivo con 512 bytes en cada división (excepto en la última; utiliza 512k para kilobytes y 512m para megabytes): -`split -b {{512}} {{nombre_de_archivo}}` +`split -b 512 {{ruta/al/archivo}}` - Divide un archivo en 5 archivos. El archivo se divide de forma que cada división tenga el mismo tamaño (excepto la última división): -`split -n {{5}} {{nombre_de_archivo}}` +`split -n 5 {{ruta/al/archivo}}` diff --git a/pages.es/osx/vpnd.md b/pages.es/osx/vpnd.md index 7e52464b7..ab1610142 100644 --- a/pages.es/osx/vpnd.md +++ b/pages.es/osx/vpnd.md @@ -1,7 +1,7 @@ # vpnd > Escucha las conexiones VPN entrantes. -> No debe invocarse manualmente. +> No debería ejecutar el programa manualmente. > Más información: . - Inicia el daemon: @@ -12,18 +12,18 @@ `vpnd -x` -- Ejecuta el daemon en primer plano e imprime los registros en el terminal: +- Ejecuta el daemon en primer plano e imprime los registros en la terminal: `vpnd -d` -- Ejecuta el daemon en primer plano, imprime los registros en el terminal y luego sale tras validar los argumentos: +- Ejecuta el daemon en primer plano, imprime los registros en la terminal y termina después de validar los argumentos: `vpnd -n` -- Imprime el resumen de uso y sale: - -`vpnd -h` - - Ejecuta el daemon para una configuración de servidor específica: -`vpnd -i {{server_id}}` +`vpnd -i {{identificador_de_servidor}}` + +- Muestra ayuda: + +`vpnd -h` diff --git a/pages.es/osx/xcrun.md b/pages.es/osx/xcrun.md index 000ea3dcc..d51a771dc 100644 --- a/pages.es/osx/xcrun.md +++ b/pages.es/osx/xcrun.md @@ -11,18 +11,18 @@ `xcrun {{herramienta}} {{argumentos}} --verbose` -- Busca una herramienta para un SDK determinado: +- Busca una herramienta para un SDK: -`xcrun --sdk {{nombre_sdk}}` +`xcrun --sdk {{nombre_de_sdk}}` -- Busca una herramienta para una cadena de herramientas determinada: +- Busca una herramienta para una cadena de herramientas: -`xcrun --toolchain {{nombre}}` - -- Muestra versión: - -`xcrun --version` +`xcrun --toolchain {{nombre_de_cadena}}` - Muestra ayuda: `xcrun --help` + +- Muestra la versión: + +`xcrun --version` diff --git a/pages.es/osx/yaa.md b/pages.es/osx/yaa.md index ffadf0abe..4dcb7d6d1 100644 --- a/pages.es/osx/yaa.md +++ b/pages.es/osx/yaa.md @@ -25,4 +25,4 @@ - Crea un archivo con un tamaño de bloque de 8 MB: -`yaa archive -b {{8m}} -d {{ruta/al/directorio}} -o {{ruta/al/archivo_de_salida.yaa}}` +`yaa archive -b 8m -d {{ruta/al/directorio}} -o {{ruta/al/archivo_de_salida.yaa}}` diff --git a/pages.es/windows/ospp.vbs.md b/pages.es/windows/ospp.vbs.md new file mode 100644 index 000000000..8a1a7aaa3 --- /dev/null +++ b/pages.es/windows/ospp.vbs.md @@ -0,0 +1,29 @@ +# ospp.vbs + +> Instala, activa y administra versiones con licencia por volumen de productos Microsoft Office. +> Nota: este comando puede anular, desactivar y/o eliminar tu volumen actual de versiones de productos Office con licencia, así que procede con cautela. +> Más información: . + +- Instala una clave de producto (Nota: sustituye a la clave existente): + +`cscript ospp.vbs /inpkey:{{clave_producto}}` + +- Desinstala una clave de producto instalada con los cinco últimos dígitos de la clave de producto: + +`cscript ospp.vbs /unpkey:{{clave_producto}}` + +- Establece un nombre de host KMS: + +`cscript ospp.vbs /sethst:{{ip|nombre_host}}` + +- Establece un puerto KMS: + +`cscript ospp.vbs /setprt:{{puerto}}` + +- Activa las claves de producto de Office instaladas: + +`cscript ospp.vbs /act` + +- Muestra la información de licencia de las claves de producto instaladas: + +`cscript ospp.vbs /dstatus` diff --git a/pages.es/windows/test-netconnection.md b/pages.es/windows/test-netconnection.md new file mode 100644 index 000000000..d18a6a610 --- /dev/null +++ b/pages.es/windows/test-netconnection.md @@ -0,0 +1,13 @@ +# Test-NetConnection + +> Muestra información de diagnóstico de una conexión. +> Este comando solo se puede utilizar a través de PowerShell. +> Más información: . + +- Prueba una conexión y muestra resultados detallados: + +`Test-NetConnection -InformationLevel Detailed` + +- Prueba una conexión a un host remoto con un número de puerto específico: + +`Test-NetConnection -ComputerName {{ip_o_nombre_del_host}} -Port {{número_de_puerto}}` diff --git a/pages.fa/android/logcat.md b/pages.fa/android/logcat.md index 07d8eeff5..ac49481df 100644 --- a/pages.fa/android/logcat.md +++ b/pages.fa/android/logcat.md @@ -17,8 +17,8 @@ - نمایش لاگ های مربوط به یک PID مشخص : -`logcat --pid={{pid}}` +`logcat --pid {{pid}}` - نمایش لاگ های پروسه های مربوط به یک بسته مشخص : -`logcat --pid=$(pidof -s {{package}})` +`logcat --pid $(pidof -s {{package}})` diff --git a/pages.fa/common/2to3.md b/pages.fa/common/2to3.md index 7939ed68c..790c5c974 100644 --- a/pages.fa/common/2to3.md +++ b/pages.fa/common/2to3.md @@ -13,11 +13,11 @@ - تبدیل قابلیت های خاص پایتون نسخه 2 به 3 : -`2to3 --write {{path/to/file.py}} --fix={{raw_input}} --fix={{print}}` +`2to3 --write {{path/to/file.py}} --fix {{raw_input}} --fix {{print}}` - تبدیل تمامی قابلیت های نسخه 2 به 3 بغیر از ویژگی های معیین شده : -`2to3 --write {{path/to/file.py}} --nofix={{has_key}} --nofix={{isinstance}}` +`2to3 --write {{path/to/file.py}} --nofix {{has_key}} --nofix {{isinstance}}` - نمایش لیست قابلیت های زبان پایتون نسخه 2 که قابلیت تبدیل به نسخه 3 را دارند : @@ -25,8 +25,8 @@ - تبدیل تمامی فایل های پایتون نسخه 2 به 3 در یک مسیر : -`2to3 --output-dir={{path/to/python3_directory}} --write-unchanged-files --nobackups {{path/to/python2_directory}}` +`2to3 --output-dir {{path/to/python3_directory}} --write-unchanged-files --nobackups {{path/to/python2_directory}}` - اجرای همزان(چند رشته ای) دستور 2 به 3 : -`2to3 --processes={{4}} --output-dir={{path/to/python3_directory}} --write --nobackups --no-diff {{path/to/python2_directory}}` +`2to3 --processes {{4}} --output-dir {{path/to/python3_directory}} --write --nobackups --no-diff {{path/to/python2_directory}}` diff --git a/pages.fa/common/aria2c.md b/pages.fa/common/aria2c.md index f1f915b42..6a10bad64 100644 --- a/pages.fa/common/aria2c.md +++ b/pages.fa/common/aria2c.md @@ -10,7 +10,7 @@ - دانلود یک فایل از لینک موردنظر با اسم خروجی دلخواه: -`aria2c --out={{path/to/file}} "{{url}}"` +`aria2c --out {{path/to/file}} "{{url}}"` - دانلود چند فایل مختلف به صورت همزمان: @@ -26,7 +26,7 @@ - دانلود با چندین اتصال مختلف: -`aria2c --split={{number_of_connections}} "{{url}}"` +`aria2c --split {{number_of_connections}} "{{url}}"` - دانلود از FTP با نام کاربری و رمزعبور: diff --git a/pages.fa/common/atuin.md b/pages.fa/common/atuin.md new file mode 100644 index 000000000..5bcf3173a --- /dev/null +++ b/pages.fa/common/atuin.md @@ -0,0 +1,29 @@ +# atuin + +> ذخیره سازی تاریخچه شل شما در یک دیتابیس قابل جستجو. +> به صورت اختیاری می توانید تاریخچه رمزنگاری شده را بین دستگاه هایتان هماهنگ کنید. +> اطلاعات بیشتر: . + +- نصب آتویین برروی شل شما: + +`eval "$(atuin init {{bash|zsh|fish}})"` + +- وارد کردن تاریخچه از فایل مربوط به تاریخچه پیشفرض شل: + +`atuin import auto` + +- جستجوی تاریخچه شل برای یک دستور خاص: + +`atuin search {{command}}` + +- ثبت نام یک حساب بر روی سرور پیشفرض با استفاده از نام کاربری و ایمیل و رمزعبور دلخواه: + +`atuin register -u {{username}} -e {{email}} -p {{password}}` + +- ورود به سرور پیشفرض: + +`atuin login -u {{username}} -p {{password}}` + +- هماهنگ کردن تاریخچه با سرور: + +`atuin sync` diff --git a/pages.fa/common/bob.md b/pages.fa/common/bob.md new file mode 100644 index 000000000..70b750674 --- /dev/null +++ b/pages.fa/common/bob.md @@ -0,0 +1,24 @@ +# bob + +> مدیریت و جابجایی بین نسخه های مختلف Neovim. +> اطلاعات بیشتر: . + +- نصب و جابجایی به نسخه خاصی از Neovim: + +`bob use {{nightly|stable|latest|version_string|commit_hash}}` + +- فهرست نسخه های نصب شده و نسخه ای که اکنون استفاده می شود: + +`bob list` + +- حذف یک نسخه خاص از Neovim: + +`bob uninstall {{nightly|stable|latest|version_string|commit_hash}}` + +- حذف Neovim و پاک کردن هر تغییری که `bob` اعمال کرده است: + +`bob erase` + +- بازگشت به نسخه شبانه قبلی: + +`bob rollback` diff --git a/pages.fa/common/cat.md b/pages.fa/common/cat.md index f1a021ea8..f97b79ace 100644 --- a/pages.fa/common/cat.md +++ b/pages.fa/common/cat.md @@ -1,7 +1,7 @@ # cat > چاپ و ترکیب کردن فایل ها. -> اطلاعات بیشتر: . +> اطلاعات بیشتر: . - چاپ محتویات فایل بر روی صفحه نمایش: diff --git a/pages.fa/common/composer.md b/pages.fa/common/composer.md index e02ee92b1..2f9711df6 100644 --- a/pages.fa/common/composer.md +++ b/pages.fa/common/composer.md @@ -1,6 +1,6 @@ # composer -> ابزاری بسته محور برای مدیریت وابستگی های پروژه های php. +> ابزاری بسته محور برای مدیریت وابستگی های پروژه های PHP. > اطلاعات بیشتر: . - ساخت یک فایل `composer.json` به صورت کنشگرا: diff --git a/pages.fa/common/curl.md b/pages.fa/common/curl.md new file mode 100644 index 000000000..64987dcb1 --- /dev/null +++ b/pages.fa/common/curl.md @@ -0,0 +1,37 @@ +# curl + +> انتقال داده از/به سرور. +> از اکثر پروتکل‌ها از جمله HTTP، FTP و POP3 پشتیبانی می‌کند. +> اطلاعات بیشتر: . + +- دانلود محتوای یک URL و ذخیره آن در یک فایل(با نام دلخواه): + +`curl {{http://example.com}} --output {{path/to/file}}` + +- دانلود یک فایل و ذخیره آن با نام فایل مشخص شده توسط URL: + +`curl --remote-name {{http://example.com/filename}}` + +- دانلود یک فایل، با دنبال کردن تغییرمسیرهای لینک(location redirects) و ادامه خودکار(از سرگیری) انتقال فایل قبلی. درصورت بروز دادن خطای سرور، خطا نمایش داده خواهد شد: + +`curl --fail --remote-name --location --continue-at - {{http://example.com/filename}}` + +- ارسال داده(فرم) رمزگذاری شده (درخواست POST از نوع application/x-www-form-urlencoded). برای خواندن از STDIN، از --data @file_name یا --data @'-' استفاده کنید: + +`curl --data {{'name=bob'}} {{http://example.com/form}}` + +- ارسال یک درخواست با استفاده از متود HTTP دلخواه و هدرهای(header) اضافی: + +`curl --header {{'X-My-Header: 123'}} --request {{PUT}} {{http://example.com}}` + +- ارسال داده به صورت JSON، با مشخص کردن content-type مناسب: + +`curl --data {{'{"name":"bob"}'}} --header {{'Content-Type: application/json'}} {{http://example.com/users/1234}}` + +- مشخص کردن یک نام کاربری و درخواست وارد کردن رمزعبور از سرور، به منظور احراز هویت: + +`curl --user {{username}} {{http://example.com}}` + +- عبور از گواهی و کلید کاربر یک منبع(رد شدن از اعتبارسنجی گواهی): + +`curl --cert {{client.pem}} --key {{key.pem}} --insecure {{https://example.com}}` diff --git a/pages.fa/common/dd.md b/pages.fa/common/dd.md index 11d007e5b..eae2a9c91 100644 --- a/pages.fa/common/dd.md +++ b/pages.fa/common/dd.md @@ -1,19 +1,19 @@ # dd > تبدیل و کپی یک فایل. -> اطلاعات بیشتر: . +> اطلاعات بیشتر: . - یک حافظه قابل حمل با قابلیت بوت شدن میسازد، برای مثال `archlinux-xxx.iso` : -`dd if={{path/to/file.iso}} of=/dev/{{usb_drive}}` +`dd if={{path/to/file.iso}} of={{/dev/usb_drive}}` - محتویات یک درایو را در مکانی دیگر با بلوک های 4 مگابایتی کپی و همچنین از خطاها صرف نظر میکند: -`dd if=/dev/{{source_drive}} of=/dev/{{dest_drive}} bs={{4194304}} conv={{noerror}}` +`dd bs=4194304 conv=noerror if={{/dev/source_drive}} of={{/dev/dest_drive}}` - یک فایل ۱۰۰ بایتی تصادفی با استفاده از درایور تصادفی هسته بسازید: -`dd if=/dev/urandom of={{path/to/random_file}} bs={{100}} count={{1}}` +`dd if=/dev/urandom of={{path/to/random_file}} bs=100 count={{1}}` - عملکرد نوشتن دیسک را بسنجید: diff --git a/pages.fa/common/diff.md b/pages.fa/common/diff.md index 9c7c74d32..f0fa654ad 100644 --- a/pages.fa/common/diff.md +++ b/pages.fa/common/diff.md @@ -1,7 +1,7 @@ # diff > مقایسه فایل(ها) و پوشه(ها). -> اطلاعات بیشتر: . +> اطلاعات بیشتر: . - مقایسه فایل ها (فهرست تغییرات فایل های قدیمی به جدید) : diff --git a/pages.fa/common/grep.md b/pages.fa/common/grep.md index 8b37cff79..3220a5c81 100644 --- a/pages.fa/common/grep.md +++ b/pages.fa/common/grep.md @@ -9,28 +9,28 @@ - جستجو یک عبارت خاص (معادل مقایسه رشته ای) : -`grep --fixed-strings "{{exact_string}}" {{path/to/file}}` +`grep {{-F|--fixed-strings}} "{{exact_string}}" {{path/to/file}}` - جستجو بازگشتی یک الگو در تمامی فایل های یک پوشه، نمایش تمامی خطوط منطبق، فایل های باینری را رد میکند: -`grep --recursive --line-number --binary-files={{without-match}} "{{search_pattern}}" {{path/to/directory}}` +`grep {{-r|--recursive}} {{-n|--line-number}} --binary-files={{without-match}} "{{search_pattern}}" {{path/to/directory}}` - استفاده از عبارات با قاعده توسعه یافته (با پشتیبانی از `?`، `+`، `{}`، `()` و `|`)، در حالت حساس به بزرگی کوچکی کاراکتر ها : -`grep --extended-regexp --ignore-case "{{search_pattern}}" {{path/to/file}}` +`grep {{-E|--extended-regexp}} {{-i|--ignore-case}} "{{search_pattern}}" {{path/to/file}}` - چاپ 3 خط از قبل و بعد محل انطباق: -`grep --{{context|before-context|after-context}}={{3}} "{{search_pattern}}" {{path/to/file}}` +`grep --{{context|before-context|after-context}} 3 "{{search_pattern}}" {{path/to/file}}` - چاپ نام فایل و شماره خط برای هر انطباق با رنگبندی : -`grep --with-filename --line-number --color=always "{{search_pattern}}" {{path/to/file}}` +`grep {{-H|--with-filename}} {{-n|--line-number}} --color=always "{{search_pattern}}" {{path/to/file}}` - جستجوی خطوط منطبق، چاپ متن منطبق : -`grep --only-matching "{{search_pattern}}" {{path/to/file}}` +`grep {{-o|--only-matching}} "{{search_pattern}}" {{path/to/file}}` - ورودی استاندارد (stdin) رو برای الگوهایی که منطبق نیستند جستجو میکند : -`cat {{path/to/file}} | grep --invert-match "{{search_pattern}}"` +`cat {{path/to/file}} | grep {{-v|--invert-match}} "{{search_pattern}}"` diff --git a/pages.fa/common/ln.md b/pages.fa/common/ln.md new file mode 100644 index 000000000..306df6361 --- /dev/null +++ b/pages.fa/common/ln.md @@ -0,0 +1,16 @@ +# ln + +> این دستور برای ایجاد ارتباط(link) به فایل ها و پوشه ها(Directories) استفاده می شود. +> اطلاعات بیشتر: . + +- ایجاد یک ارتباط نمادین (symbolic link) به یک فایل یا پوشه: + +`ln -s {{/path/to/file_or_directory}} {{path/to/symlink}}` + +- جایگزینی یک ارتباط نمادین موجود، برای اشاره به یک فایل متفاوت: + +`ln -sf {{/path/to/new_file}} {{path/to/symlink}}` + +- ایجاد یک لینک سخت (hard link) به یک فایل: + +`ln {{/path/to/file}} {{path/to/hardlink}}` diff --git a/pages.fa/common/compare.md b/pages.fa/common/magick-compare.md similarity index 62% rename from pages.fa/common/compare.md rename to pages.fa/common/magick-compare.md index 115a6857c..797abd3a9 100644 --- a/pages.fa/common/compare.md +++ b/pages.fa/common/magick-compare.md @@ -1,4 +1,4 @@ -# compare +# magick compare > ایجاد یک تصویر مقایسه ای برای مشخص کردن تفاوتهای دو عکس به صورت بصری. > بخشی از ImageMagick است. @@ -6,8 +6,8 @@ - مقایسه دو عکس: -`compare {{path/to/image1.png}} {{path/to/image2.png}} {{path/to/diff.png}}` +`magick compare {{path/to/image1.png}} {{path/to/image2.png}} {{path/to/diff.png}}` - مقایسه دو عکس با استفاده از معیار دلخواه: -`compare -verbose -metric {{PSNR}} {{path/to/image1.png}} {{path/to/image2.png}} {{path/to/diff.png}}` +`magick compare -verbose -metric {{PSNR}} {{path/to/image1.png}} {{path/to/image2.png}} {{path/to/diff.png}}` diff --git a/pages.fa/common/mkdir.md b/pages.fa/common/mkdir.md new file mode 100644 index 000000000..1108a3d2e --- /dev/null +++ b/pages.fa/common/mkdir.md @@ -0,0 +1,16 @@ +# mkdir + +> ساخت پوشه ها و تنظیم مجوز آنها. +> اطلاعات بیشتر: . + +- ساخت پوشه مشخص: + +`mkdir {{path/to/directory1 path/to/directory2 ...}}` + +- ساخت پوشه های مشخص به همراه پوشه های والد در صورت نیاز: + +`mkdir -p {{path/to/directory1 path/to/directory2 ...}}` + +- ساخت پوشه با مجوز های خاص: + +`mkdir -m {{rwxrw-r--}} {{path/to/directory1 path/to/directory2 ...}}` diff --git a/pages.fa/common/whereis.md b/pages.fa/common/whereis.md index 128f97c72..1e25fc690 100644 --- a/pages.fa/common/whereis.md +++ b/pages.fa/common/whereis.md @@ -3,7 +3,7 @@ > پیداکردن فایل اجرایی، سورس، صفحه راهنما برای یک دستور. > اطلاعات بیشتر: . -- پیداکردن فایل اجرایی، سورس و صفحه راهنما برای ssh: +- پیداکردن فایل اجرایی، سورس و صفحه راهنما برای SSH: `whereis {{ssh}}` diff --git a/pages.fa/linux/abbr.md b/pages.fa/linux/abbr.md index d3578bfd2..fa4850333 100644 --- a/pages.fa/linux/abbr.md +++ b/pages.fa/linux/abbr.md @@ -16,6 +16,6 @@ `abbr --erase {{abbreviation_name}}` -- وارد کردن یک مخفف وارد شده در یک میزبان دیگر از طریق ssh: +- وارد کردن یک مخفف وارد شده در یک میزبان دیگر از طریق SSH: `ssh {{host_name}} abbr --show | source` diff --git a/pages.fa/linux/caja.md b/pages.fa/linux/caja.md new file mode 100644 index 000000000..b41973805 --- /dev/null +++ b/pages.fa/linux/caja.md @@ -0,0 +1,24 @@ +# caja + +> مدیریت فایلها و پوشه ها در محیط دسکتاپ MATE. +> اطلاعات بیشتر: . + +- باز کردن پوشه خانگی کاربر کنونی: + +`caja` + +- بازکردن پوشه های مشخص شده در پنجره جداگانه: + +`caja {{path/to/directory1 path/to/directory2 ...}}` + +- بازکردن پوشه های مشخص شده در تب ها: + +`caja --tabs {{path/to/directory1 path/to/directory2 ...}}` + +- بازکدن یک پوشه در یک پنجره با اندازه مشخص: + +`caja --geometry={{600}}x{{400}} {{path/to/directory}}` + +- بستن همه پنجره ها: + +`caja --quit` diff --git a/pages.fa/linux/dd.md b/pages.fa/linux/dd.md new file mode 100644 index 000000000..90fbbc3dc --- /dev/null +++ b/pages.fa/linux/dd.md @@ -0,0 +1,28 @@ +# dd + +> تبدیل و کپی یک فایل. +> اطلاعات بیشتر: . + +- ساخت یک درایو USB قابل بوت از یک فایل iso (مثل `archlinux-xxx.iso`) و نمایش پیشرفت: + +`dd if={{path/to/file.iso}} of={{/dev/usb_drive}} status=progress` + +- کلون کردن یک درایو به یک درایو دیگر با اندازهٔ بلوک ۴ مگابایت و اعمال چیزهای نوشته شده پیش از خاتمهٔ دستور: + +`dd bs=4M conv=fsync if={{/dev/source_drive}} of={{/dev/dest_drive}}` + +- ایجاد یک فایل با تعداد مشخصی بایت تصادفی با استفاده از درایور random کرنل: + +`dd bs={{100}} count={{1}} if=/dev/urandom of={{path/to/random_file}}` + +- ارزیابی عملکرد نوشتن روی یک دیسک: + +`dd bs={{1M}} count={{1024}} if=/dev/zero of={{path/to/file_1GB}}` + +- ساخت یک پشتیبان از سامانه و ذخیرهٔ آن در یک فایل IMG (می‌توان بعداً با تغییر `if` به `of` آن را بازسازی کرد): + +`dd if={{/dev/drive_device}} of={{path/to/file.img}} status=progress` + +- بررسی پیشرفت یک عملکرد در حال اجرای `dd` (این دستور را از یک پوستهٔ دیگر اجرا کنید): + +`kill -USR1 $(pgrep -x dd)` diff --git a/pages.fa/linux/pacman.md b/pages.fa/linux/pacman.md new file mode 100644 index 000000000..da0a91048 --- /dev/null +++ b/pages.fa/linux/pacman.md @@ -0,0 +1,38 @@ +# pacman + +> واحد مدیریت پکیج آرچ لینوکس +> همچنین : `pacman-database`, `pacman-deptest`, `pacman-files`, `pacman-key`, `pacman-mirrors`, `pacman-query`, `pacman-remove`, `pacman-sync`, `pacman-upgrade`. +> برای دیدن دستور های معادل در سایر پکیج منیجر ها . +> اطلاعات بیشتر: . + +- همگام سازی و بروز رسانی تمام پکیج ها: + +`sudo pacman -Syu` + +- نصب پکیج جدید: + +`sudo pacman -S {{package}}` + +- حذف یک پکیج به همراه وابستگی هاش: + +`sudo pacman -Rs {{package}}` + +- جستجو در دیتابیس برای پکیج هایی که با یک فایل خاص تعارض دارند: + +`pacman -F "{{file_name}}"` + +- لیست کردن پکیج های نصب شده با نسخه آنها: + +`pacman -Q` + +- لیست کردن تنها پکیج هایی که مستقیما نصب شده اند به همراه نسخه آنها: + +`pacman -Qe` + +- لیست کردن پکیج هایی که به عنوان وابستگی نصب شده اند اما توسط هیچ پکیجی استفاده نمیشوند: + +`pacman -Qtdq` + +- خالی کردن کل کش `pacman`: + +`sudo pacman -Scc` diff --git a/pages.fr/common/2to3.md b/pages.fr/common/2to3.md index 3249664ff..74370b3e7 100644 --- a/pages.fr/common/2to3.md +++ b/pages.fr/common/2to3.md @@ -13,11 +13,11 @@ - Convertir des fonctionnalités spécifiques de Python 2 vers Python 3 : -`2to3 --write {{chemin/vers/fichier.py}} --fix={{raw_input}} --fix={{print}}` +`2to3 --write {{chemin/vers/fichier.py}} --fix {{raw_input}} --fix {{print}}` - Convertir toutes les fonctionnalités de Python 2 vers Python 3 sauf exceptions spécifiques : -`2to3 --write {{chemin/vers/fichier.py}} --nofix={{has_key}} --nofix={{isinstance}}` +`2to3 --write {{chemin/vers/fichier.py}} --nofix {{has_key}} --nofix {{isinstance}}` - Afficher une liste de toutes les fonctionnalités de language qui peuvent être converties de Python 2 vers Python 3 : @@ -25,8 +25,8 @@ - Convertir tous les fichier Python2 vers Python 3 dans un dossier : -`2to3 --output-dir={{chemin/vers/dossier_python3}} --write-unchanged-files --nobackups {{chemin/vers/dossier_python2}}` +`2to3 --output-dir {{chemin/vers/dossier_python3}} --write-unchanged-files --nobackups {{chemin/vers/dossier_python2}}` - Executer 2to3 avec plusieurs fil d'exécution : -`2to3 --processes={{4}} --output-dir={{chemin/vers/dossier_python3}} --write --nobackups --no-diff {{chemin/vers/dossier_python2}}` +`2to3 --processes {{4}} --output-dir {{chemin/vers/dossier_python3}} --write --nobackups --no-diff {{chemin/vers/dossier_python2}}` diff --git a/pages.fr/common/7zr.md b/pages.fr/common/7zr.md index bda63f5ab..0cfca2b2f 100644 --- a/pages.fr/common/7zr.md +++ b/pages.fr/common/7zr.md @@ -1,7 +1,7 @@ # 7zr > Un archiveur de fichiers avec un haut taux de compression. -> Similaire à `7z` sauf qu'il supporte que les fichiers `.7z`. +> Similaire à `7z` sauf qu'il supporte que les fichiers 7z. > Plus d'informations : . - Compresse un fichier ou un dossier : diff --git a/pages.fr/common/ack.md b/pages.fr/common/ack.md index cb8f5a3d5..a31b85e58 100644 --- a/pages.fr/common/ack.md +++ b/pages.fr/common/ack.md @@ -18,11 +18,11 @@ - Limite la recherche aux fichiers d'un certain type : -`ack --type={{ruby}} "{{motif_de_recherche}}"` +`ack --type {{ruby}} "{{motif_de_recherche}}"` - Exlcus un certain type de fichier de la recherche : -`ack --type=no{{ruby}} "{{motif_de_recherche}}"` +`ack --type no{{ruby}} "{{motif_de_recherche}}"` - Compte le nombre total de correspondances : diff --git a/pages.fr/common/adb-logcat.md b/pages.fr/common/adb-logcat.md index 5a8edb860..4aecfcccb 100644 --- a/pages.fr/common/adb-logcat.md +++ b/pages.fr/common/adb-logcat.md @@ -1,4 +1,4 @@ -# adb-logcat +# adb logcat > Jeter une log des messages systèmes. > Plus d'informations : . diff --git a/pages.fr/common/alacritty.md b/pages.fr/common/alacritty.md index 3ae7686e0..c8206b927 100644 --- a/pages.fr/common/alacritty.md +++ b/pages.fr/common/alacritty.md @@ -15,10 +15,10 @@ `alacritty -e {{commande}}` -- Utilise un autre fichier de configuration (le fichier par défault étant `$XDG_CONFIG_HOME/alacritty/alacritty.yml`) : +- Utilise un autre fichier de configuration (le fichier par défault étant `$XDG_CONFIG_HOME/alacritty/alacritty.toml`) : -`alacritty --config-file {{chemin/vers/config.yml}}` +`alacritty --config-file {{chemin/vers/config.toml}}` -- Lance avec la mise à jour en live dès que la configuration est modifiée ( peu également être activé par défaut dans `alacritty.yml`) : +- Lance avec la mise à jour en live dès que la configuration est modifiée ( peu également être activé par défaut dans `alacritty.toml`) : -`alacritty --live-config-reload --config-file {{chemin/vers/config.yml}}` +`alacritty --live-config-reload --config-file {{chemin/vers/config.toml}}` diff --git a/pages.fr/common/amass-db.md b/pages.fr/common/amass-db.md deleted file mode 100644 index 49dfe2698..000000000 --- a/pages.fr/common/amass-db.md +++ /dev/null @@ -1,20 +0,0 @@ -# amass db - -> Intéragie avec une base de données Amass. -> Plus d'informations : . - -- Liste toutes les énumérations performées pas la base de données : - -`amass db -dir {{chemin/vers/dossier_de_la_base_de_données}} -list` - -- Affiche les résultats pour un index d'énumération et un nom de domaine spécifiés : - -`amass db -dir {{chemin/vers/dossier_de_la_base_de_données}} -d {{nom_de_domaine}} -enum {{index_depuis_la liste}} -show` - -- Liste tous les sous-domaines trouvés pour un domaine inclus dans une énumération : - -`amass db -dir {{chemin/vers/dossier_de_la_base_de_données}} -d {{nom_de_domaine}} -enum {{index_depuis_la liste}} -names` - -- Affiche un sommaire des sous-domaines inclus dans une énumération : - -`amass db -dir {{chemin/vers/dossier_de_la_base_de_données}} -d {{nom_de_domaine}} -enum {{index_depuis_la liste}} -summary` diff --git a/pages.fr/common/amass-enum.md b/pages.fr/common/amass-enum.md index fa2833822..7669f5e3d 100644 --- a/pages.fr/common/amass-enum.md +++ b/pages.fr/common/amass-enum.md @@ -1,7 +1,7 @@ # amass enum > Trouve les sous-domaines d'un domaine. -> Plus d'informations : . +> Plus d'informations : . - Trouve les sous-domaines d'un domaine passivement : diff --git a/pages.fr/common/amass-intel.md b/pages.fr/common/amass-intel.md index 31df14966..c53396e14 100644 --- a/pages.fr/common/amass-intel.md +++ b/pages.fr/common/amass-intel.md @@ -1,7 +1,7 @@ # amass intel > Collecte des renseignements open source sur une organisation comme les noms de domaines racine et les ASNs. -> Plus d'informations : . +> Plus d'informations : . - Recherche les domaines racines inclus dans une plage d'adresse IP : diff --git a/pages.fr/common/amass.md b/pages.fr/common/amass.md index 129443663..7116b891f 100644 --- a/pages.fr/common/amass.md +++ b/pages.fr/common/amass.md @@ -1,20 +1,20 @@ # amass > Outil de Cartographie des Attaques de Surface et découverte de ressource. -> Certaines commandes comme `amass db` ont leur propre documentation. -> Plus d'informations : . +> Certaines commandes comme `amass intel` ont leur propre documentation. +> Plus d'informations : . - Exécute une sous-commande Amass : -`amass {{sous_commande}}` +`amass {{intel|enum}} {{options}}` - Affiche l'aide général : `amass -help` -- Affiche l'aide sur une sous-commande de Amass ( comme `intel`, `enum`, etc.) : +- Affiche l'aide sur une sous-commande de Amass : -`amass -help {{sous_commande}}` +`amass {{intel|enum}} -help` - Affiche la version : diff --git a/pages.fr/common/androguard.md b/pages.fr/common/androguard.md index 562de04da..162fd25da 100644 --- a/pages.fr/common/androguard.md +++ b/pages.fr/common/androguard.md @@ -7,7 +7,7 @@ `androguard axml {{chemin/vers/app.apk}}` -- Affiche les métadonnées de l'application (version et id d'application) : +- Affiche les métadonnées de l'application (version et ID d'application) : `androguard apkid {{chemin/vers/app.apk}}` diff --git a/pages.fr/common/aria2c.md b/pages.fr/common/aria2c.md index 60b9882ac..b5782dc2c 100644 --- a/pages.fr/common/aria2c.md +++ b/pages.fr/common/aria2c.md @@ -10,7 +10,7 @@ - Télécharge un fichier via l'url spécifié en choisissant le nom de ce dernier : -`aria2c --out={{nom_de_fichier}} "{{url}}"` +`aria2c --out {{nom_de_fichier}} "{{url}}"` - Télécharge plusieurs fichiers (différents) en parallèle : @@ -26,7 +26,7 @@ - Télécharge avec plusieurs connections : -`aria2c --split={{nombre_de_connections}} "{{url}}"` +`aria2c --split {{nombre_de_connections}} "{{url}}"` - Téléchargement FTP avec nom d'utilisateur et mot de passe : diff --git a/pages.fr/common/asciidoctor.md b/pages.fr/common/asciidoctor.md index 035cece9d..fd2c763da 100644 --- a/pages.fr/common/asciidoctor.md +++ b/pages.fr/common/asciidoctor.md @@ -9,7 +9,7 @@ - Convertis un fichier `.adoc` vers un fichier HTML et lie une feuille de style CSS : -`asciidoctor -a stylesheet={{chemin/vers/feuille_de_style.css}} {{chemin/vers/fichier.adoc}}` +`asciidoctor -a stylesheet {{chemin/vers/feuille_de_style.css}} {{chemin/vers/fichier.adoc}}` - Convertis un fichier `.adoc` vers un fichier HTML embarqué, en enlevant tout sauf le body : @@ -17,4 +17,4 @@ - Convertis un fichier `.adoc` vers un PDF en utilisant la librairie `asciidoctor-pdf` : -`asciidoctor --backend={{pdf}} --require={{asciidoctor-pdf}} {{chemin/vers/fichier.adoc}}` +`asciidoctor --backend {{pdf}} --require {{asciidoctor-pdf}} {{chemin/vers/fichier.adoc}}` diff --git a/pages.fr/common/autossh.md b/pages.fr/common/autossh.md index 7d00a535a..de80b2dc9 100644 --- a/pages.fr/common/autossh.md +++ b/pages.fr/common/autossh.md @@ -1,7 +1,7 @@ # autossh > Lance, surveille et redémarre les connections SSH. -> Reconnecte automatiquement pour garder le tunnel de transfert de port ouvert. Accepte toutes les options de `ssh`. +> Reconnecte automatiquement pour garder le tunnel de transfert de port ouvert. Accepte toutes les options de SSH. > Plus d'informations : . - Démarre une session SSH, redémarre quand le port échoue à renvoyer de la data : @@ -12,7 +12,7 @@ `autossh -M {{port_surveillé}} -L {{port_local}}:localhost:{{port_distant}} {{utilisateur}}@{{hôte}}` -- Diverge `autossh` en arrière plan avant de lancer `ssh` et n'ouvre pas de shell distant : +- Diverge `autossh` en arrière plan avant de lancer SSH et n'ouvre pas de shell distant : `autossh -f -M {{port_surveillé}} -N "{{commande_ssh}}"` @@ -24,6 +24,6 @@ `autossh -f -M 0 -N -o "ServerAliveInterval 10" -o "ServerAliveCountMax 3" -o ExitOnForwardFailure=yes -L {{port_local}}:localhost:{{port_distant}} {{utilisateur}}@{{hôte}}` -- Démarre en arrière plan, logue la sortie de déboggage d'`autossh` et la sortie verbeuse de `ssh` dans des fichiers : +- Démarre en arrière plan, logue la sortie de déboggage d'`autossh` et la sortie verbeuse de SSH dans des fichiers : `AUTOSSH_DEBUG=1 AUTOSSH_LOGFILE={{chemin/vers/fichier_logs_autossh.log}} autossh -f -M {{port_surveillé}} -v -E {{chemin/vers/fichier_logs_ssh.log}} {{commande_ssh}}` diff --git a/pages.fr/common/aws-ecr.md b/pages.fr/common/aws-ecr.md index 738898f49..5ded93cdb 100644 --- a/pages.fr/common/aws-ecr.md +++ b/pages.fr/common/aws-ecr.md @@ -3,7 +3,7 @@ > Pousse, récupère et gère les images de conteneur. > Plus d'informations : . -- Connecte docker avec le registre par défaut (le nom d'utilisateur est AWS) : +- Connecte Docker avec le registre par défaut (le nom d'utilisateur est AWS) : `aws ecr get-login-password --region {{région}} | {{docker login}} --username AWS --password-stdin {{id_de_compte_aws}}.dkr.ecr.{{région}}.amazonaws.com` diff --git a/pages.fr/common/bc.md b/pages.fr/common/bc.md index 3f1d69d43..58380c103 100644 --- a/pages.fr/common/bc.md +++ b/pages.fr/common/bc.md @@ -2,7 +2,7 @@ > Un langage de calcul de précision arbitraire. > Voir aussi : `dc`. -> Plus d'informations : . +> Plus d'informations : . - Démarre une session interactive : diff --git a/pages.fr/common/cat.md b/pages.fr/common/cat.md index 34dc5cb7f..34ae76327 100644 --- a/pages.fr/common/cat.md +++ b/pages.fr/common/cat.md @@ -1,7 +1,7 @@ # cat > Affiche et concatène le contenu d'un ou plusieurs fichiers. -> Plus d'informations : . +> Plus d'informations : . - Affiche le contenu d'un fichier sur la sortie standard : diff --git a/pages.fr/common/clamav.md b/pages.fr/common/clamav.md index 535cd4680..8590fa773 100644 --- a/pages.fr/common/clamav.md +++ b/pages.fr/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > Cette commande est un alias de `clamdscan`. > Plus d'informations : . diff --git a/pages.fr/common/clear.md b/pages.fr/common/clear.md index 339cb5986..5a8ef5dab 100644 --- a/pages.fr/common/clear.md +++ b/pages.fr/common/clear.md @@ -3,7 +3,7 @@ > Efface l'écran du terminal. > Plus d'informations : . -- Effacer l'écran (identique à la séquence Contrôle-L sur une interface bash) : +- Effacer l'écran (identique à la séquence Contrôle-L sur une interface Bash) : `clear` diff --git a/pages.fr/common/convert.md b/pages.fr/common/convert.md deleted file mode 100644 index ffd623c9f..000000000 --- a/pages.fr/common/convert.md +++ /dev/null @@ -1,32 +0,0 @@ -# convert - -> Outil de conversion d'image d'ImageMagick. -> Plus d'informations : . - -- Convertir une image JPG en PNG : - -`convert {{image.jpg}} {{image.png}}` - -- Redimensionner une image à 50% de ses dimensions d'origine : - -`convert {{image.png}} -resize 50% {{image2.png}}` - -- Redimensionner une image en conservant son ratio hauteur/largeur initial pour une taille maximum de 640x480 : - -`convert {{image.png}} -resize 640x480 {{image2.png}}` - -- Coller plusieurs images horizontallement : - -`convert {{image1.png}} {{image2.png}} {{image3.png}} +append {{image123.png}}` - -- Coller plusieurs images verticalement : - -`convert {{image1.png}} {{image2.png}} {{image3.png}} -append {{image123.png}}` - -- Créer un gif à partir d'une série d'images avec un délai de 100ms entre chaque : - -`convert {{image1.png}} {{image2.png}} {{image3.png}} -delay {{100}} {{animation.gif}}` - -- Créer une image avec un simple arrière-plan uni : - -`convert -size {{800x600}} "xc:{{#ff0000}}" {{image.png}}` diff --git a/pages.fr/common/deno.md b/pages.fr/common/deno.md index 63df51018..6c19aac10 100644 --- a/pages.fr/common/deno.md +++ b/pages.fr/common/deno.md @@ -1,7 +1,7 @@ # deno > Un environnement d’exécution sécurisé pour JavaScript et TypeScript. -> Plus d'information : . +> Plus d'informations : . - Exécute un fichier JavaScript ou TypeScript : diff --git a/pages.fr/common/diff.md b/pages.fr/common/diff.md index f204ea525..0d6c0ac45 100644 --- a/pages.fr/common/diff.md +++ b/pages.fr/common/diff.md @@ -1,7 +1,7 @@ # diff > Compare deux fichiers ou répertoires. -> Plus d'informations : . +> Plus d'informations : . - Compare deux fichiers (liste les changements pour transformer `ancien_fichier` en `nouveau_fichier`) : diff --git a/pages.fr/common/docker-build.md b/pages.fr/common/docker-build.md index 04f465e66..64b467379 100644 --- a/pages.fr/common/docker-build.md +++ b/pages.fr/common/docker-build.md @@ -1,4 +1,4 @@ -# docker-build +# docker build > Construit une image à partir d'un Dockerfile. > Plus d'informations : . @@ -15,7 +15,7 @@ `docker build --tag {{nom:etiquette}} .` -- Construit une image docker sans contexte de construction : +- Construit une image Docker sans contexte de construction : `docker build --tag {{nom:etiquette}} - < {{Dockerfile}}` diff --git a/pages.fr/common/docker-commit.md b/pages.fr/common/docker-commit.md index 8152c2cdd..08a47bbff 100644 --- a/pages.fr/common/docker-commit.md +++ b/pages.fr/common/docker-commit.md @@ -9,23 +9,23 @@ - Appliquer une instruction `CMD` du Dockerfile à l'image créée : -`docker commit --change="CMD {{commande}}" {{conteneur}} {{image}}:{{etiquette}}` +`docker commit --change "CMD {{commande}}" {{conteneur}} {{image}}:{{etiquette}}` - Appliquer une instruction `ENV` du Dockerfile à l'image créée : -`docker commit --change="ENV {{name}}={{value}}" {{conteneur}} {{image}}:{{etiquette}}` +`docker commit --change "ENV {{name}}={{value}}" {{conteneur}} {{image}}:{{etiquette}}` - Créer une image avec un auteur spécifique dans les métadonnées : -`docker commit --author="{{auteur}}" {{conteneur}} {{image}}:{{etiquette}}` +`docker commit --author "{{auteur}}" {{conteneur}} {{image}}:{{etiquette}}` - Créer une image avec un commentaire spécifique dans les métadonnées : -`docker commit --message="{{commentaire}}" {{conteneur}} {{image}}:{{etiquette}}` +`docker commit --message "{{commentaire}}" {{conteneur}} {{image}}:{{etiquette}}` - Créer une image sans mettre en pause le conteneur pendant la création : -`docker commit --pause={{false}} {{conteneur}} {{image}}:{{etiquette}}` +`docker commit --pause {{false}} {{conteneur}} {{image}}:{{etiquette}}` - Afficher l'aide : diff --git a/pages.fr/common/docker-machine.md b/pages.fr/common/docker-machine.md index ff211668d..c76846276 100644 --- a/pages.fr/common/docker-machine.md +++ b/pages.fr/common/docker-machine.md @@ -1,7 +1,7 @@ # docker-machine > Créer et gérer des machines qui exécutent Docker. -> Plus d'informations : . +> Plus d'informations : . - Lister les machines Docker actuellement en cours d'exécution : diff --git a/pages.fr/common/docker-ps.md b/pages.fr/common/docker-ps.md index bda4aeb61..ae9cc1c5b 100644 --- a/pages.fr/common/docker-ps.md +++ b/pages.fr/common/docker-ps.md @@ -17,7 +17,7 @@ - Afficher les conteneurs avec une chaine de caractère dans leur nom : -`docker ps --filter="name={{name}}"` +`docker ps --filter "name={{name}}"` - Afficher les conteneurs avec une même image comme parent : @@ -29,8 +29,8 @@ - Afficher les conteneurs avec un statut spécifique (créé, en cours d'exécution, en cours de suppresion, en pause, arrêté, mort) : -`docker ps --filter="status={{status}}"` +`docker ps --filter "status={{status}}"` - Afficher les conteneurs avec un point de montage spécifique : -`docker ps --filter="volume={{chemin/vers/le/dossier}}" --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Mounts}}"` +`docker ps --filter "volume={{chemin/vers/le/dossier}}" --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Mounts}}"` diff --git a/pages.fr/common/docker-pull.md b/pages.fr/common/docker-pull.md index d6daf5838..48dbf90fc 100644 --- a/pages.fr/common/docker-pull.md +++ b/pages.fr/common/docker-pull.md @@ -1,21 +1,21 @@ # docker pull -> Télécharge une image docker depuis le registre. +> Télécharge une image Docker depuis le registre. > Plus d'informations : . -- Télécharge une image docker spécifique : +- Télécharge une image Docker spécifique : `docker pull {{image}}:{{étiquette}}` -- Télécharge une image docker spécifique en mode silencieux : +- Télécharge une image Docker spécifique en mode silencieux : `docker pull --quiet {{image}}:{{étiquette}}` -- Télécharge toutes les étiquettes d'une image docker spécifique : +- Télécharge toutes les étiquettes d'une image Docker spécifique : `docker pull --all-tags {{image}}` -- Télécharge un image docker pour une plateforme spécifique, ex : linux/amd64 : +- Télécharge un image Docker pour une plateforme spécifique, ex : linux/amd64 : `docker pull --platform {{linux/amd64}} {{image}}:{{étiquette}}` diff --git a/pages.fr/common/docker-start.md b/pages.fr/common/docker-start.md index 6ec2cd5a8..46f236de0 100644 --- a/pages.fr/common/docker-start.md +++ b/pages.fr/common/docker-start.md @@ -7,7 +7,7 @@ `docker start` -- Lancer un conteneur docker : +- Lancer un conteneur Docker : `docker start {{conteneur}}` diff --git a/pages.fr/common/docker-system.md b/pages.fr/common/docker-system.md index 49e3cafe3..5a0534529 100644 --- a/pages.fr/common/docker-system.md +++ b/pages.fr/common/docker-system.md @@ -7,11 +7,11 @@ `docker system` -- Afficher l'utilisation du disque par docker : +- Afficher l'utilisation du disque par Docker : `docker system df` -- Afficher des informations détaillées sur l'utilisation du disque par docker : +- Afficher des informations détaillées sur l'utilisation du disque par Docker : `docker system df --verbose` @@ -21,7 +21,7 @@ - Supprimer les données non utilisées de plus d'un temps donné dans le passé : -`docker system prune --filter="until={{heures}}h{{minutes}}m"` +`docker system prune --filter "until={{heures}}h{{minutes}}m"` - Afficher les événements du démon Docker en temps réel : diff --git a/pages.fr/common/exa.md b/pages.fr/common/exa.md index 07083bfdc..e24c23eb1 100644 --- a/pages.fr/common/exa.md +++ b/pages.fr/common/exa.md @@ -1,7 +1,7 @@ # exa > Une alternative moderne à `ls` (pour lister le contenu de répertoires). -> Plus d'information : . +> Plus d'informations : . - Liste les fichiers, un par ligne : diff --git a/pages.fr/common/fossil-ci.md b/pages.fr/common/fossil-ci.md index 5a2c4111c..45b4a15ed 100644 --- a/pages.fr/common/fossil-ci.md +++ b/pages.fr/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> Cette commande est un alias de `fossil-commit`. +> Cette commande est un alias de `fossil commit`. > Plus d'informations : . - Voir la documentation de la commande originale : diff --git a/pages.fr/common/fossil-delete.md b/pages.fr/common/fossil-delete.md index 0cadac863..4eec39040 100644 --- a/pages.fr/common/fossil-delete.md +++ b/pages.fr/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > Cette commande est un alias de `fossil rm`. > Plus d'informations : . diff --git a/pages.fr/common/fossil-forget.md b/pages.fr/common/fossil-forget.md index 531ee1404..cbbf626cd 100644 --- a/pages.fr/common/fossil-forget.md +++ b/pages.fr/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > Cette commande est un alias de `fossil rm`. > Plus d'informations : . diff --git a/pages.fr/common/fossil-new.md b/pages.fr/common/fossil-new.md index ae5c7c3bb..a84fc025f 100644 --- a/pages.fr/common/fossil-new.md +++ b/pages.fr/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> Cette commande est un alias de `fossil-init`. +> Cette commande est un alias de `fossil init`. > Plus d'informations : . - Voir la documentation de la commande originale : diff --git a/pages.fr/common/gh-cs.md b/pages.fr/common/gh-cs.md index b665d4812..e1cbb7306 100644 --- a/pages.fr/common/gh-cs.md +++ b/pages.fr/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> Cette commande est un alias de `gh-codespace`. +> Cette commande est un alias de `gh codespace`. > Plus d'informations : . - Voir la documentation de la commande originale : diff --git a/pages.fr/common/git-archive.md b/pages.fr/common/git-archive.md index d8b4f1a20..a3ae4855e 100644 --- a/pages.fr/common/git-archive.md +++ b/pages.fr/common/git-archive.md @@ -7,7 +7,7 @@ `git archive --verbose HEAD` -- Crée une archive `.zip` avec le contenu de la HEAD et l'affiche sur la sortie standard : +- Crée une archive Zip avec le contenu de la HEAD et l'affiche sur la sortie standard : `git archive --verbose --format zip HEAD` diff --git a/pages.fr/common/git-init.md b/pages.fr/common/git-init.md index 8166a474e..410687498 100644 --- a/pages.fr/common/git-init.md +++ b/pages.fr/common/git-init.md @@ -7,6 +7,6 @@ `git init` -- Initialiser un référentiel barebones, adapté à une utilisation distante via ssh : +- Initialiser un référentiel barebones, adapté à une utilisation distante via SSH : `git init --bare` diff --git a/pages.fr/common/git-instaweb.md b/pages.fr/common/git-instaweb.md index 421fc6217..59de158ef 100644 --- a/pages.fr/common/git-instaweb.md +++ b/pages.fr/common/git-instaweb.md @@ -15,7 +15,7 @@ `git instaweb --start --port {{1234}}` -- Utiliser un daemon http spécifique : +- Utiliser un daemon HTTP spécifique : `git instaweb --start --httpd {{lighttpd|apache2|mongoose|plackup|webrick}}` diff --git a/pages.fr/common/git-lfs.md b/pages.fr/common/git-lfs.md index 342328a66..4bd745113 100644 --- a/pages.fr/common/git-lfs.md +++ b/pages.fr/common/git-lfs.md @@ -1,7 +1,7 @@ # git lfs > Travailler dans un registre Git avec des fichiers volumineux. -> Plus d'informations : . +> Plus d'informations : . - Initialise le Git LFS : diff --git a/pages.fr/common/gnmic-sub.md b/pages.fr/common/gnmic-sub.md index b15a9c19e..ddacbe06f 100644 --- a/pages.fr/common/gnmic-sub.md +++ b/pages.fr/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > Cette commande est un alias de `gnmic subscribe`. > Plus d'informations : . diff --git a/pages.fr/common/grep.md b/pages.fr/common/grep.md index c4deec34b..744bf1a16 100644 --- a/pages.fr/common/grep.md +++ b/pages.fr/common/grep.md @@ -10,23 +10,23 @@ - Recherche en ignorant la casse : -`grep --fixed-strings "{{chaîne_recherchée}}" {{chemin/vers/fichier}}` +`grep {{-F|--fixed-strings}} "{{chaîne_recherchée}}" {{chemin/vers/fichier}}` - Recherche récursivement (en ignorant les fichiers non-texte) dans le dossier courant une chaîne de caractères précise : -`grep --recursive --line-number "{{chaîne_recherchée}}" .` +`grep {{-r|--recursive}} {{-n|--line-number}} "{{chaîne_recherchée}}" .` - Utilise des expressions régulières étendues (supporte `?`, `+`, `{}`, `()` et `|`) : -`grep --extended-regexp {{expression_régulière}} {{chemin/vers/fichier}}` +`grep {{-E|--extended-regexp}} {{-i|--ignore-case}} {{expression_régulière}} {{chemin/vers/fichier}}` - Affiche 3 lignes de [C]ontexte, avant ([B]efore), ou [A]près chaque concordance : -`grep --{{context|before-context|after-context}}={{3}} "{{chaîne_recherchée}}" {{chemin/vers/fichier}}` +`grep --{{context|before-context|after-context}} 3 "{{chaîne_recherchée}}" {{chemin/vers/fichier}}` - Affiche le nom du fichier avec la ligne correspondante pour chaque concordance : -`grep --with-filename --line-number "{{chaîne_recherchée}}" {{chemin/vers/fichier}}` +`grep {{-H|--with-filename}} {{-n|--line-number}} --color=always "{{chaîne_recherchée}}" {{chemin/vers/fichier}}` - Utilise l'entrée standard au lieu d'un fichier : diff --git a/pages.fr/common/jq.md b/pages.fr/common/jq.md index 6268d3c6b..6fcdd0d0d 100644 --- a/pages.fr/common/jq.md +++ b/pages.fr/common/jq.md @@ -1,7 +1,7 @@ # jq > Un processeur JSON en ligne de commande qui utilise un langage dédié (DSL). -> Plus d'informations : . +> Plus d'informations : . - Exécute une expression spécifique (affiche une sortie JSON coloré et formaté) : diff --git a/pages.fr/common/magick-convert.md b/pages.fr/common/magick-convert.md new file mode 100644 index 000000000..06dd30372 --- /dev/null +++ b/pages.fr/common/magick-convert.md @@ -0,0 +1,32 @@ +# magick convert + +> Outil de conversion d'image d'ImageMagick. +> Plus d'informations : . + +- Convertir une image JPEG en PNG : + +`magick convert {{image.jpg}} {{image.png}}` + +- Redimensionner une image à 50% de ses dimensions d'origine : + +`magick convert {{image.png}} -resize 50% {{image2.png}}` + +- Redimensionner une image en conservant son ratio hauteur/largeur initial pour une taille maximum de 640x480 : + +`magick convert {{image.png}} -resize 640x480 {{image2.png}}` + +- Coller plusieurs images horizontallement : + +`magick convert {{image1.png}} {{image2.png}} {{image3.png}} +append {{image123.png}}` + +- Coller plusieurs images verticalement : + +`magick convert {{image1.png}} {{image2.png}} {{image3.png}} -append {{image123.png}}` + +- Créer un gif à partir d'une série d'images avec un délai de 100ms entre chaque : + +`magick convert {{image1.png}} {{image2.png}} {{image3.png}} -delay {{100}} {{animation.gif}}` + +- Créer une image avec un simple arrière-plan uni : + +`magick convert -size {{800x600}} "xc:{{#ff0000}}" {{image.png}}` diff --git a/pages.fr/common/pio-init.md b/pages.fr/common/pio-init.md index 13443f2e1..1481f8aad 100644 --- a/pages.fr/common/pio-init.md +++ b/pages.fr/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > Cette commande est un alias de `pio project`. diff --git a/pages.fr/common/r.md b/pages.fr/common/r.md index 9b25a5348..31dcb2114 100644 --- a/pages.fr/common/r.md +++ b/pages.fr/common/r.md @@ -1,4 +1,4 @@ -# r +# R > Interpréteur pour le langage R. > Plus d'informations : . diff --git a/pages.fr/common/rsync.md b/pages.fr/common/rsync.md index 0cfcf0a1e..4f2c81e54 100644 --- a/pages.fr/common/rsync.md +++ b/pages.fr/common/rsync.md @@ -10,24 +10,24 @@ - Utilise le mode archive (copier récursivement les répertoires, copier les liens symboliques sans résolution et conserver les autorisations, la propriété et les délais de modification) : -`rsync --archive {{chemin/vers/origine}} {{chemin/vers/destination}}` +`rsync {{-a|--archive}} {{chemin/vers/origine}} {{chemin/vers/destination}}` - Transférer le contenu d'un dossier : -`rsync --recursive {{chemin/vers/origine}} {{chemin/vers/destination}}` +`rsync {{-r|--recursive}} {{chemin/vers/origine}} {{chemin/vers/destination}}` - Transférer le contenu d'un dossier (mais pas le dossier lui-même) : -`rsync --recursive {{chemin/vers/origine}}/ {{chemin/vers/destination}}` +`rsync {{-r|--recursive}} {{chemin/vers/origine}}/ {{chemin/vers/destination}}` - Utiliser le mode archive, résolvant les liens symboliques et ignorant les fichiers déjà transférés sauf si plus récents : -`rsync --archive --update --copy-links {{chemin/vers/origine}} {{chemin/vers/destination}}` +`rsync {{-auL|--archive --update --copy-links}} {{chemin/vers/origine}} {{chemin/vers/destination}}` - Transférer un fichier vers un hôte distant exécutant `rsyncd` et supprimez les fichiers sur la destination qui n'existent pas sur l'hôte distant : -`rsync --recursive --delete rsync://{{hote_distant}}:{{chemin/vers/origine}} {{chemin/vers/destination}}` +`rsync {{-r|--recursive}} --delete rsync://{{hote_distant}}:{{chemin/vers/origine}} {{chemin/vers/destination}}` - Transférer un fichier par SSH et afficher l'avancement global du transfert : -`rsync -rsh 'ssh -p {{port}}' --info=progress2 {{hote_distant}}:{{chemin/vers/origine}} {{chemin/vers/destination}}` +`rsync {{-e|--rsh}} 'ssh -p {{port}}' --info=progress2 {{hote_distant}}:{{chemin/vers/origine}} {{chemin/vers/destination}}` diff --git a/pages.fr/common/sudo.md b/pages.fr/common/sudo.md index 22c741642..f480d4095 100644 --- a/pages.fr/common/sudo.md +++ b/pages.fr/common/sudo.md @@ -15,7 +15,7 @@ `sudo --user={{utilisateur}} --group={{groupe}} {{id -a}}` -- Répéte la dernière commande préfixée de `sudo` (uniquement dans `bash`, `zsh`, etc.) : +- Répéte la dernière commande préfixée de `sudo` (uniquement dans Bash, Zsh, etc.) : `sudo !!` diff --git a/pages.fr/common/tlmgr-arch.md b/pages.fr/common/tlmgr-arch.md index 831142308..d94746ca6 100644 --- a/pages.fr/common/tlmgr-arch.md +++ b/pages.fr/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > Cette commande est un alias de `tlmgr platform`. > Plus d'informations : . diff --git a/pages.fr/common/zsh.md b/pages.fr/common/zsh.md index a70d80d3a..59b7a2a68 100644 --- a/pages.fr/common/zsh.md +++ b/pages.fr/common/zsh.md @@ -24,6 +24,6 @@ `zsh --verbose` -- Exécute une commande spécifique dans `zsh` sans motifs génériques d'expansion des noms de fichier : +- Exécute une commande spécifique dans Zsh sans motifs génériques d'expansion des noms de fichier : `noglob "{{command}}"` diff --git a/pages.fr/linux/abbr.md b/pages.fr/linux/abbr.md index 8bc7f75a3..c204e44b1 100644 --- a/pages.fr/linux/abbr.md +++ b/pages.fr/linux/abbr.md @@ -1,6 +1,6 @@ # abbr -> Gère les abréviations pour le shell Fish. +> Gère les abréviations pour le shell fish. > Les mots définis par l'utilisateur sont remplacés par des phrases plus longues après leur saisie. > Plus d'informations : . diff --git a/pages.fr/linux/apt-add-repository.md b/pages.fr/linux/apt-add-repository.md index a342f25a3..dd4175bb4 100644 --- a/pages.fr/linux/apt-add-repository.md +++ b/pages.fr/linux/apt-add-repository.md @@ -1,6 +1,6 @@ # apt-add-repository -> Gère la définition des dépôts apt. +> Gère la définition des dépôts APT. > Plus d'informations : . - Ajout d'un nouveau dépôt : diff --git a/pages.fr/linux/apt-file.md b/pages.fr/linux/apt-file.md index 7f6eded03..b0b4c6bad 100644 --- a/pages.fr/linux/apt-file.md +++ b/pages.fr/linux/apt-file.md @@ -1,6 +1,6 @@ # apt-file -> Recherche de fichiers dans les paquets apt, y compris ceux qui ne sont pas encore installés. +> Recherche de fichiers dans les paquets APT, y compris ceux qui ne sont pas encore installés. > Plus d'informations : . - Mise à jour la base de données des métadonnées : diff --git a/pages.fr/linux/ip.md b/pages.fr/linux/ip.md index 6efd08ad1..72c1a0543 100644 --- a/pages.fr/linux/ip.md +++ b/pages.fr/linux/ip.md @@ -2,7 +2,7 @@ > Affiche / manipule l'adressage, le routage, les interfaces et périphériques réseau, les règles de routage et les tunnels. > Certaines commandes comme `ip address` ont leur propre documentation. -> Plus d'informations : . +> Plus d'informations : . - Liste les interfaces avec des infos détaillées : diff --git a/pages.fr/sunos/prstat.md b/pages.fr/sunos/prstat.md index 9d4712caf..6a4937668 100644 --- a/pages.fr/sunos/prstat.md +++ b/pages.fr/sunos/prstat.md @@ -21,4 +21,4 @@ - Imprimez une liste des 5 meilleurs processeurs utilisant des processus chaque seconde : -`prstat -c -n {{5}} -s cpu {{1}}` +`prstat -c -n 5 -s cpu 1` diff --git a/pages.hi/android/logcat.md b/pages.hi/android/logcat.md index 2d7d1cc5a..97fc98d3a 100644 --- a/pages.hi/android/logcat.md +++ b/pages.hi/android/logcat.md @@ -17,8 +17,8 @@ - किसी विशिष्ट पीआईडी के लिए लॉग प्रदर्शित करें: -`logcat --pid={{पीआईडी}}` +`logcat --pid {{पीआईडी}}` - किसी विशिष्ट पैकेज की प्रक्रिया के लिए लॉग प्रदर्शित करें: -`logcat --pid=$(pidof -s {{पैकेज}})` +`logcat --pid $(pidof -s {{पैकेज}})` diff --git a/pages.hi/common/cat.md b/pages.hi/common/cat.md index 60d8f8772..68effe794 100644 --- a/pages.hi/common/cat.md +++ b/pages.hi/common/cat.md @@ -1,7 +1,7 @@ # cat > फ़ाइलों को प्रिंट और संक्षिप्त करें। -> अधिक जानकारी: । +> अधिक जानकारी: । - मानक आउटपुट में फ़ाइल की सामग्री प्रिंट करें: diff --git a/pages.hi/common/clamav.md b/pages.hi/common/clamav.md index def162f46..8258ab68b 100644 --- a/pages.hi/common/clamav.md +++ b/pages.hi/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > यह आदेश `clamdscan` का उपनाम है। > अधिक जानकारी: । diff --git a/pages.hi/common/fossil-ci.md b/pages.hi/common/fossil-ci.md index 9e001fcbd..2e4c5232f 100644 --- a/pages.hi/common/fossil-ci.md +++ b/pages.hi/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> यह आदेश `fossil-commit` का उपनाम है। +> यह आदेश `fossil commit`.का उपनाम है। > अधिक जानकारी: । - मूल आदेश के लिए दस्तावेज़ देखें: diff --git a/pages.hi/common/fossil-delete.md b/pages.hi/common/fossil-delete.md index 1e5a66af8..18331feec 100644 --- a/pages.hi/common/fossil-delete.md +++ b/pages.hi/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > यह आदेश `fossil rm` का उपनाम है। > अधिक जानकारी: । diff --git a/pages.hi/common/fossil-forget.md b/pages.hi/common/fossil-forget.md index 0bd17315c..50be3cf62 100644 --- a/pages.hi/common/fossil-forget.md +++ b/pages.hi/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > यह आदेश `fossil rm` का उपनाम है। > अधिक जानकारी: । diff --git a/pages.hi/common/fossil-new.md b/pages.hi/common/fossil-new.md index 4c67b0d05..2449fc622 100644 --- a/pages.hi/common/fossil-new.md +++ b/pages.hi/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> यह आदेश `fossil-init` का उपनाम है। +> यह आदेश `fossil init`.का उपनाम है। > अधिक जानकारी: । - मूल आदेश के लिए दस्तावेज़ देखें: diff --git a/pages.hi/common/gh-cs.md b/pages.hi/common/gh-cs.md index 042953bad..2e1c9e2a7 100644 --- a/pages.hi/common/gh-cs.md +++ b/pages.hi/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> यह आदेश `gh-codespace` का उपनाम है। +> यह आदेश `gh codespace`.का उपनाम है। > अधिक जानकारी: । - मूल आदेश के लिए दस्तावेज़ देखें: diff --git a/pages.hi/common/gnmic-sub.md b/pages.hi/common/gnmic-sub.md index 8fc61a857..4f682d024 100644 --- a/pages.hi/common/gnmic-sub.md +++ b/pages.hi/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > यह आदेश `gnmic subscribe` का उपनाम है। > अधिक जानकारी: । diff --git a/pages.hi/common/compare.md b/pages.hi/common/magick-compare.md similarity index 64% rename from pages.hi/common/compare.md rename to pages.hi/common/magick-compare.md index 157da4b78..42bff02b0 100644 --- a/pages.hi/common/compare.md +++ b/pages.hi/common/magick-compare.md @@ -1,12 +1,12 @@ -# compare +# magick compare > 2 छवियों के बीच अंतर देखें। > अधिक जानकारी: । - 2 छवियों की तुलना करें: -`compare {{छवि1.png}} {{छवि2.png}} {{अंतर.png}}` +`magick compare {{छवि1.png}} {{छवि2.png}} {{अंतर.png}}` - कस्टम मीट्रिक का उपयोग करके 2 छवियों की तुलना करें: -`compare -verbose -metric {{PSNR}} {{छवि1.png}} {{छवि2.png}} {{अंतर.png}}` +`magick compare -verbose -metric {{PSNR}} {{छवि1.png}} {{छवि2.png}} {{अंतर.png}}` diff --git a/pages.hi/common/pio-init.md b/pages.hi/common/pio-init.md index 65f494b66..39a5127ed 100644 --- a/pages.hi/common/pio-init.md +++ b/pages.hi/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > यह आदेश `pio project` का उपनाम है। diff --git a/pages.hi/common/tlmgr-arch.md b/pages.hi/common/tlmgr-arch.md index afd72e425..065704cc4 100644 --- a/pages.hi/common/tlmgr-arch.md +++ b/pages.hi/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > यह आदेश `tlmgr platform` का उपनाम है। > अधिक जानकारी: । diff --git a/pages.hi/linux/ip-route-list.md b/pages.hi/linux/ip-route-list.md index 0cb821a68..6a7313311 100644 --- a/pages.hi/linux/ip-route-list.md +++ b/pages.hi/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> यह आदेश `ip-route-show` का उपनाम है। +> यह आदेश `ip route show`.का उपनाम है। - मूल आदेश के लिए दस्तावेज़ देखें: diff --git a/pages.id/android/logcat.md b/pages.id/android/logcat.md index b5e7c6d5d..9645a9766 100644 --- a/pages.id/android/logcat.md +++ b/pages.id/android/logcat.md @@ -17,8 +17,8 @@ - Tampilkan log untuk nomor induk (PID) program yang sedang dijalankan: -`logcat --pid={{pid}}` +`logcat --pid {{pid}}` - Tampilkan log untuk (kemasan) aplikasi yang sedang dijalankan: -`logcat --pid=$(pidof -s {{nama_kemasan_aplikasi}})` +`logcat --pid $(pidof -s {{nama_kemasan_aplikasi}})` diff --git a/pages.id/common/!.md b/pages.id/common/!.md index cf9763244..5a4e38c6f 100644 --- a/pages.id/common/!.md +++ b/pages.id/common/!.md @@ -1,4 +1,4 @@ -# Tanda seru +# Exclamation mark > Digunakan pada Bash sebagai pengganti perintah yang sebelumnya dieksekusikan. > Informasi lebih lanjut: . @@ -19,6 +19,10 @@ `!{{awalan_perintah}}` -- Gunakan argumen/opsi perintah yang sama dengan perintah sebelumnya: +- Gunakan susunan argumen/opsi perintah yang sama dengan perintah sebelumnya: `{{perintah}} !*` + +- Gunakan argumen/opsi perintah terakhir dari perintah sebelumnya: + +`{{perintah}} !$` diff --git a/pages.id/common/2to3.md b/pages.id/common/2to3.md index 44343e20b..76003d3f0 100644 --- a/pages.id/common/2to3.md +++ b/pages.id/common/2to3.md @@ -13,11 +13,11 @@ - Mengkonversikan fitur bahasa pemrograman Python 2 tertentu menuju Python 3: -`2to3 --write {{jalan/menuju/file.py}} --fix={{raw_input}} --fix={{print}}` +`2to3 --write {{jalan/menuju/file.py}} --fix {{raw_input}} --fix {{print}}` - Mengkonversikan seluruh fitur Python 2 menjadi Python 3, kecuali fitur-fitur tertentu: -`2to3 --write {{jalan/menuju/file.py}} --nofix={{has_key}} --nofix={{isinstance}}` +`2to3 --write {{jalan/menuju/file.py}} --nofix {{has_key}} --nofix {{isinstance}}` - Menampilkan daftar fitur-fitur bahasa pemrograman yang dapat dikonversikan dari Python 2 menuju Python 3: @@ -25,8 +25,8 @@ - Mengkonversikan seluruh file Python 2 menuju Python 3 di dalam sebuah direktori: -`2to3 --output-dir={{jalan/menuju/direktori_python3}} --write-unchanged-files --nobackups {{jalan/menuju/direktori_python2}}` +`2to3 --output-dir {{jalan/menuju/direktori_python3}} --write-unchanged-files --nobackups {{jalan/menuju/direktori_python2}}` - Menjalankan program ini dengan lebih dari satu thread: -`2to3 --processes={{4}} --output-dir={{jalan/menuju/direktori_python3}} --write --nobackups --no-diff {{jalan/menuju/direktori_python2}}` +`2to3 --processes {{4}} --output-dir {{jalan/menuju/direktori_python3}} --write --nobackups --no-diff {{jalan/menuju/direktori_python2}}` diff --git a/pages.id/common/7zr.md b/pages.id/common/7zr.md index 58151dcc7..bd3418b2a 100644 --- a/pages.id/common/7zr.md +++ b/pages.id/common/7zr.md @@ -1,7 +1,7 @@ # 7zr > Pengarsip file dengan rasio kompresi yang tinggi. -> Serupa dengan `7z` namun mendukung format file arsip `.7z` saja. +> Serupa dengan `7z` namun mendukung format file arsip 7z saja. > Informasi lebih lanjut: . - T[a]mbahkan sebuah file atau direktori ke dalam arsip baru atau saat ini: diff --git a/pages.id/common/^.md b/pages.id/common/^.md new file mode 100644 index 000000000..185ed22d9 --- /dev/null +++ b/pages.id/common/^.md @@ -0,0 +1,17 @@ +# Caret + +> Digunakan pada Bash untuk menggantikan string pada perintah sebelumnya dan menjalankan perintah yang telah diubahnya. +> Setara dengan `!!:s^string1^string2`. +> Informasi lebih lanjut: . + +- Jalankan perintah sebelumnya dengan menggantikan `string1` dengan `string2`: + +`^{{string1}}^{{string2}}` + +- Hapus `string1` dari perintah sebelumnya: + +`^{{string1}}^` + +- Gantikan `string1` dengan `string2` pada perintah sebelumnya, kemudian tambahkan `string3` pada akhir: + +`^{{string1}}^{{string2}}^{{string3}}` diff --git a/pages.id/common/ack.md b/pages.id/common/ack.md index a80e0c3db..907311bbd 100644 --- a/pages.id/common/ack.md +++ b/pages.id/common/ack.md @@ -18,11 +18,11 @@ - Hanya cari file dengan tipe tertentu (seperti `ruby` untuk mencari file `.rb`,`.erb`, `.rake`, `Rakefile` dan sebagainya): -`ack --type={{ruby}} "{{pola_pencarian}}"` +`ack --type {{ruby}} "{{pola_pencarian}}"` - Jangan cari file dengan tipe tertentu: -`ack --type=no{{ruby}} "{{pola_pencarian}}"` +`ack --type no{{ruby}} "{{pola_pencarian}}"` - Hitung total teks/string yang ditemukan: diff --git a/pages.id/common/adb-logcat.md b/pages.id/common/adb-logcat.md index be97591d2..8c8ba943a 100644 --- a/pages.id/common/adb-logcat.md +++ b/pages.id/common/adb-logcat.md @@ -1,4 +1,4 @@ -# adb-logcat +# adb logcat > Dapatkan dan simpan log sistem pada perangkat Android. > Informasi lebih lanjut: . diff --git a/pages.id/common/airodump-ng.md b/pages.id/common/airodump-ng.md index 3702dd7b7..ee619cb0c 100644 --- a/pages.id/common/airodump-ng.md +++ b/pages.id/common/airodump-ng.md @@ -4,10 +4,18 @@ > Bagian dari paket perangkat lunak jaringan Aircrack-ng. > Informasi lebih lanjut: . -- Tangkap para paket dan tampilkan informasi jaringan nirkabel tertentu: +- Tangkap para paket dan tampilkan daftar jaringan nirkabel dalam frekuensi 2.4GHz: `sudo airodump-ng {{interface}}` +- Tangkap para paket dan tampilkan daftar jaringan nirkabel dalam frekuensi 5GHz: + +`sudo airodump-ng {{interface}} --band a` + +- Tangkap para paket dan tampilkan daftar jaringan nirkabel, baik dalam frekuensi 2.4GHz maupun 5GHz: + +`sudo airodump-ng {{interface}} --band abg` + - Tangkap para paket dan tampilkan informasi jaringan nirkabel berdasarkan alamat MAC dan kanal jaringan, kemudian simpan hasil ke dalam suatu file: `sudo airodump-ng --channel {{channel}} --write {{jalan/menuju/file}} --bssid {{alamat_mac}} {{interface}}` diff --git a/pages.id/common/alacritty.md b/pages.id/common/alacritty.md index 8e3c375f7..046b9b9ee 100644 --- a/pages.id/common/alacritty.md +++ b/pages.id/common/alacritty.md @@ -15,10 +15,10 @@ `alacritty -e {{perintah}}` -- Menentukan berkas konfigurasi alternatif (nilai default `$XDG_CONFIG_HOME/alacritty/alacritty.yml`): +- Menentukan berkas konfigurasi alternatif (nilai default `$XDG_CONFIG_HOME/alacritty/alacritty.toml`): -`alacritty --config-file {{alamat/ke/konfigurasi.yml}}` +`alacritty --config-file {{alamat/ke/konfigurasi.toml}}` -- Menjalankan dengan mengaktifkan pemuatan ulang konfigurasi secara langsung/otomatis (dapat juga diaktifkan secara default di `alacritty.yml`): +- Menjalankan dengan mengaktifkan pemuatan ulang konfigurasi secara langsung/otomatis (dapat juga diaktifkan secara default di `alacritty.toml`): -`alacritty --live-config-reload --config-file {{alamat/ke/konfigurasi.yml}}` +`alacritty --live-config-reload --config-file {{alamat/ke/konfigurasi.toml}}` diff --git a/pages.id/common/amass-enum.md b/pages.id/common/amass-enum.md new file mode 100644 index 000000000..a3f63f30a --- /dev/null +++ b/pages.id/common/amass-enum.md @@ -0,0 +1,28 @@ +# amass enum + +> Cari seluruh subdomain dari suatu domain internet. +> Informasi lebih lanjut: . + +- Cari para subdomain dari suatu [d]omain (secara pasif): + +`amass enum -d {{nama_domain}}` + +- Cari para subdomain dari [d]omain dengan memeriksa apakah subdomain tersebut dapat ditemukan: + +`amass enum -active -d {{nama_domain}} -p {{80,443,8080}}` + +- Lakukan pencarian terhadap para sub[d]omain secara paksa (brute force): + +`amass enum -brute -d {{nama_domain}}` + +- Simpan hasil pencarian ke dalam suatu berkas teks: + +`amass enum -o {{berkas_output}} -d {{nama_domain}}` + +- Simpan hasil luaran (output) terminal menuju suatu berkas dan informasi tambahan ke dalam direktori tertentu: + +`amass enum -o {{berkas_output}} -dir {{jalan/menuju/direktori}} -d {{nama_domain}}` + +- Tampilkan daftar sumber pencarian data: + +`amass enum -list` diff --git a/pages.id/common/amass-intel.md b/pages.id/common/amass-intel.md new file mode 100644 index 000000000..03132e35c --- /dev/null +++ b/pages.id/common/amass-intel.md @@ -0,0 +1,32 @@ +# amass intel + +> Kumpulkan data pendukung pengintaian bersumber terbuka (OSI) terhadap suatu organisasi, seperti domain pangkal dan informasi Nomor Sistem Otonom (ASN). +> Informasi lebih lanjut: . + +- Cari para domain pangkal yang berkaitan dengan rentang alamat ([addr]ess) IP: + +`amass intel -addr {{192.168.0.1-254}}` + +- Gunakan metode pengintaian secara aktif: + +`amass intel -active -addr {{192.168.0.1-254}}` + +- Cari para domain pangkal yang berkaitan dengan suatu [d]omain: + +`amass intel -whois -d {{nama_domain}}` + +- Cari para pihak ASN yang berkaitan dengan suatu [org]anisasi: + +`amass intel -org {{nama_organisasi}}` + +- Cari daftar domain yang dipegang oleh suatu pihak Nomor Sistem Otonom (ASN) berdasarkan nomornya: + +`amass intel -asn {{nomor_asn}}` + +- Simpan hasil pencarian ke dalam suatu berkas teks: + +`amass intel -o {{berkas_output}} -whois -d {{nama_domain}}` + +- Tampilkan daftar sumber pencarian data: + +`amass intel -list` diff --git a/pages.id/common/amass.md b/pages.id/common/amass.md new file mode 100644 index 000000000..4d67a3760 --- /dev/null +++ b/pages.id/common/amass.md @@ -0,0 +1,21 @@ +# amass + +> Alat Pemetaan Permukaan Serangan dan Penemuan Aset yang mendalam. +> Beberapa subperintah seperti `amass intel` mempunyai dokumentasi terpisah. +> Informasi lebih lanjut: . + +- Jalankan suatu subperintah Amass: + +`amass {{intel|enum}} {{opsi}}` + +- Tampilkan informasi bantuan umum: + +`amass -help` + +- Tampilkan informasi bantuan untuk subperintah Amass: + +`amass {{intel|enum}} -help` + +- Tampilkan informasi versi: + +`amass -version` diff --git a/pages.id/common/androguard.md b/pages.id/common/androguard.md new file mode 100644 index 000000000..d5abeb430 --- /dev/null +++ b/pages.id/common/androguard.md @@ -0,0 +1,16 @@ +# androguard + +> Lakukan rekayasa terbalik terhadap suatu aplikasi Android. Program ini ditulis dalam bahasa pemrograman Python. +> Informasi lebih lanjut: . + +- Tampilkan manifes aplikasi Android: + +`androguard axml {{jalan/menuju/aplikasi.apk}}` + +- Tampilkan metadata aplikasi (versi dan ID aplikasi): + +`androguard apkid {{jalan/menuju/aplikasi.apk}}` + +- Bongkar kode-kode program Java dari suatu aplikasi: + +`androguard decompile {{jalan/menuju/aplikasi.apk}} --output {{jalan/menuju/direktori}}` diff --git a/pages.id/common/ani-cli.md b/pages.id/common/ani-cli.md new file mode 100644 index 000000000..779dc5acb --- /dev/null +++ b/pages.id/common/ani-cli.md @@ -0,0 +1,28 @@ +# ani-cli + +> Program baris perintah (CLI) untuk menelusuri dan menonton film anime. +> Informasi lebih lanjut: . + +- Cari anime dengan nama: + +`ani-cli "{{nama_anime}}"` + +- Unduh ([d]ownload) suatu episode: + +`ani-cli -d "{{nama_anime}}"` + +- Gunakan [v]LC untuk memutar film: + +`ani-cli -v "{{nama_anime}}"` + +- Tonton satu [e]pisode: + +`ani-cli -e {{nomor_episode}} "{{nama_anime}}"` + +- Lanjut ([c]ontinue) menonton anime dari riwayat: + +`ani-cli -c` + +- Mutakhirkan ([U]pdate) program `ani-cli`: + +`ani-cli -U` diff --git a/pages.id/common/anki.md b/pages.id/common/anki.md new file mode 100644 index 000000000..7823a432c --- /dev/null +++ b/pages.id/common/anki.md @@ -0,0 +1,20 @@ +# anki + +> Program manajemen flashcard (kartu pintar) yang kuat dan cerdas. +> Informasi lebih lanjut: . + +- Jalankan program GUI: + +`anki` + +- Gunakan [p]rofil tertentu untuk mengakses flashcard: + +`anki -p {{nama_profil}}` + +- Gunakan suatu bahasa ([l]anguage): + +`anki -l {{bahasa}}` + +- Gunakan direktori non-default untuk memuat data flashcard (tersimpan secara default dalam `~/Anki`): + +`anki -b {{jalan/menuju/direktori}}` diff --git a/pages.id/common/ansible-doc.md b/pages.id/common/ansible-doc.md new file mode 100644 index 000000000..b73864068 --- /dev/null +++ b/pages.id/common/ansible-doc.md @@ -0,0 +1,29 @@ +# ansible-doc + +> Tampilkan informasi mengenai modul-modul (action plugins) yang terpasang dalam pustaka pemasangan Ansible. +> Tampilkan informasi singkat mengenai daftar plugin beserta deskripsi singkatnya. +> Informasi lebih lanjut: . + +- Tampilkan daftar modul/plugin yang tersedia: + +`ansible-doc --list` + +- Tampilkan daftar modul/plugin berdasarkan jenisnya: + +`ansible-doc --type {{become|cache|callback|cliconf|connection|...}} --list` + +- Tampilkan informasi mengenai suatu modul/plugin: + +`ansible-doc {{nama_plugin}}` + +- Tampilkan informasi mengenai suatu modul/plugin berdasarkan jenis spesifiknya: + +`ansible-doc --type {{become|cache|callback|cliconf|connection|...}} {{nama_plugin}}` + +- Lihat contoh cara penggunaan (dalam playbook) bagi suatu modul/plugin: + +`ansible-doc --snippet {{nama_plugin}}` + +- Tampilkan informasi mengenai suatu plugin/modul dalam format JSON: + +`ansible-doc --json {{nama_plugin}}` diff --git a/pages.id/common/ansible-galaxy.md b/pages.id/common/ansible-galaxy.md new file mode 100644 index 000000000..c0c7b8b8a --- /dev/null +++ b/pages.id/common/ansible-galaxy.md @@ -0,0 +1,32 @@ +# ansible-galaxy + +> Buat dan atur peran pengguna (role) Ansible. +> Informasi lebih lanjut: . + +- Pasang sebuah peran kepada suatu pengguna: + +`ansible-galaxy install {{username}}.{{nama_peran}}` + +- Buang peran dari suatu pengguna: + +`ansible-galaxy remove {{username}}.{{nama_peran}}` + +- Tampilkan daftar peran yang tersedia: + +`ansible-galaxy list` + +- Cari peran berdasarkan nama: + +`ansible-galaxy search {{nama_peran}}` + +- Terbitkan sebuah peran baru: + +`ansible-galaxy init {{nama_peran}}` + +- Dapatkan informasi mengenai peran sebuah pengguna: + +`ansible-galaxy role info {{username}}.{{nama_peran}}` + +- Dapatkan informasi mengenai suatu koleksi: + +`ansible-galaxy collection info {{username}}.{{nama_koleksi}}` diff --git a/pages.id/common/ansible-inventory.md b/pages.id/common/ansible-inventory.md new file mode 100644 index 000000000..595ba0037 --- /dev/null +++ b/pages.id/common/ansible-inventory.md @@ -0,0 +1,21 @@ +# ansible-inventory + +> Tampilkan dan simpan informasi suatu inventaris Ansible (inventory). +> Lihat juga: `ansible`. +> Informasi lebih lanjut: . + +- Tampilkan informasi inventaris default: + +`ansible-inventory --list` + +- Tampilkan suatu inventaris kustom: + +`ansible-inventory --list --inventory {{jalan/menuju/berkas_atau_skrip_atau_direktori}}` + +- Tampilkan informasi inventaris default dalam format YAML: + +`ansible-inventory --list --yaml` + +- Simpan informasi inventaris default ke dalam suatu berkas teks: + +`ansible-inventory --list --output {{jalan/menuju/berkas}}` diff --git a/pages.id/common/ansible-playbook.md b/pages.id/common/ansible-playbook.md new file mode 100644 index 000000000..4b5446620 --- /dev/null +++ b/pages.id/common/ansible-playbook.md @@ -0,0 +1,32 @@ +# ansible-playbook + +> Jalankan kumpulan tugas yang didefinisikan di dalam buku aturan main (playbook), kepada para mesin secara jarak jauh melalui SSH. +> Informasi lebih lanjut: . + +- Jalankan kumpulan tugas yang didefinisikan dalam buku aturan main (playbook): + +`ansible-playbook {{playbook}}` + +- Jalankan kumpulan tugas playbook dengan [i]nventaris mesin secara kustom: + +`ansible-playbook {{playbook}} -i {{berkas_inventaris}}` + +- Jalankan kumpulan tugas playbook dengan variabel [e]kstra sebagaimana didefinisikan dalam barisan perintah (command-line): + +`ansible-playbook {{playbook}} -e "{{variabel1}}={{nilai1}} {{variabel2}}={{nilai2}}"` + +- Jalankan kumpulan tugas playbook dengan variabel [e]kstra sebagaimana didefinisikan di dalam suatu berkas JSON: + +`ansible-playbook {{playbook}} -e "@{{daftar_variabel.json}}"` + +- Jalankan kumpulan tugas playbook dengan konfigurasi tag tertentu: + +`ansible-playbook {{playbook}} --tags {{tag1,tag2}}` + +- Jalankan kumpulan tugas playbook, dimulai dari nama tugas spesifik: + +`ansible-playbook {{playbook}} --start-at {{nama_tugas}}` + +- Jalankan kumpulan tugas playbook tanpa melakukan perubahan sebenarnya (dry-run): + +`ansible-playbook {{playbook}} --check --diff` diff --git a/pages.id/common/ansible-pull.md b/pages.id/common/ansible-pull.md new file mode 100644 index 000000000..bad86ea55 --- /dev/null +++ b/pages.id/common/ansible-pull.md @@ -0,0 +1,20 @@ +# ansible-pull + +> Tarik buku-buku aturan main (playbook) dari suatu repositori sistem manajemen versi (VCS), dan jalankan tugas-tugasnya bagi host lokal. +> Informasi lebih lanjut: . + +- Tarik suatu playbook dari repositori VCS, kemudian jalankan aturan default dari playbook local.yml: + +`ansible-pull -U {{url_repositori}}` + +- Tarik suatu playbook dari repositori VCS, kemudian jalankan aturan playbook dengan nama tertentu: + +`ansible-pull -U {{url_repositori}} {{playbook}}` + +- Tarik suatu playbook dari [C]abang tertentu pada repositori VCS, kemudian jalankan aturan playbook dengan nama tertentu: + +`ansible-pull -U {{url_repositori}} -C {{cabang}} {{playbook}}` + +- Tarik suatu playbook dari repositori VCS, kemudian definisikan daftar perangkat/host dari suatu berkas (hosts), kemudian jalankan aturan playbook dengan nama tertentu: + +`ansible-pull -U {{url_repositori}} -i {{berkas_hosts}} {{playbook}}` diff --git a/pages.id/common/ansible-vault.md b/pages.id/common/ansible-vault.md new file mode 100644 index 000000000..b647a1856 --- /dev/null +++ b/pages.id/common/ansible-vault.md @@ -0,0 +1,28 @@ +# ansible-vault + +> Enkripsi dan dekripsi nilai, struktur data, dan file dalam proyek Ansible. +> Informasi lebih lanjut: . + +- Buat suatu berkas brankas terenkripsi baru dengan permintaan kata sandi: + +`ansible-vault create {{nama_berkas_brankas}}` + +- Buat file brankas terenkripsi baru menggunakan berkas kunci (kata sandi) brankas untuk mengenkripsinya: + +`ansible-vault create --vault-password-file {{nama_berkas_kata_sandi}} {{nama_berkas_brankas}}` + +- Enkripsi file yang ada menggunakan berkas kata sandi opsional: + +`ansible-vault encrypt --vault-password-file {{nama_berkas_kata_sandi}} {{nama_berkas_brankas}}` + +- Enkripsi suatu teks string menggunakan format string terenkripsi standar Ansible, dan menampilkan petunjuk secara interaktif: + +`ansible-vault encrypt_string` + +- Lihat isi suatu brankas yang terenkripsi, menggunakan berkas kata sandi untuk mendekripsikannya: + +`ansible-vault view --vault-password-file {{nama_berkas_kata_sandi}} {{nama_berkas_brankas}}` + +- Ganti kunci (kata sandi) pada brankas terenkripsi dengan mendefinisikan berkas kata sandi baru: + +`ansible-vault rekey --vault-password-file {{nama_berkas_kata_sandi_lama}} --new-vault-password-file {{nama_berkas_kata_sandi_baru}} {{nama_berkas_brankas}}` diff --git a/pages.id/common/ansible.md b/pages.id/common/ansible.md new file mode 100644 index 000000000..5985ab17f --- /dev/null +++ b/pages.id/common/ansible.md @@ -0,0 +1,33 @@ +# ansible + +> Atur grup perangkat komputer yang secara jarak jauh melalui SSH. (Gunakan berkas `/etc/ansible/hosts` untuk menambahkan grup atau host baru). +> Beberapa subperintah seperti `ansible galaxy` memiliki dokumentasi terpisah. +> Informasi lebih lanjut: . + +- Tampilkan daftar host yang tergabung dalam suatu grup: + +`ansible {{grup}} --list-hosts` + +- Uji koneksi (ping) kepada grup perangkat tertentu dengan menggunakan [m]odul ping: + +`ansible {{grup}} -m ping` + +- Tampilkan informasi faktual tentang suatu grup perangkat dengan menggunakan [m]odul setup: + +`ansible {{grup}} -m setup` + +- Jalankan perintah pada suatu kelompok perangkat melalui [m]odul command dengan kumpulan [a]rgumen: + +`ansible {{grup}} -m command -a '{{perintah_saya}}'` + +- Jalankan perintah dengan hak akses administratif: + +`ansible {{grup}} --become --ask-become-pass -m command -a '{{perintah_saya}}'` + +- Jalankan perintah menggunakan berkas [i]nventaris tertentu: + +`ansible {{grup}} -i {{file_inventaris}} -m command -a '{{perintah_saya}}'` + +- Tampilkan daftar grup dalam sebuah inventaris: + +`ansible localhost -m debug -a '{{var=groups.keys()}}'` diff --git a/pages.id/common/ansiweather.md b/pages.id/common/ansiweather.md new file mode 100644 index 000000000..43060fcc3 --- /dev/null +++ b/pages.id/common/ansiweather.md @@ -0,0 +1,16 @@ +# ansiweather + +> Tampilkan kondisi cuaca saat ini ke dalam terminal. +> Informasi lebih lanjut: . + +- Tampilkan ramalan cuaca ([f]orecast) selama tujuh hari ke depan bagi suatu [l]okasi, dengan satuan [u]nit ukur metrik: + +`ansiweather -u metric -f 7 -l {{Rzeszow,PL}}` + +- Tampilkan ramalan cuaca ([F]orecast) selama lima hari ke depan bagi lokasi saat ini, dengan tampilan [s]imbol serta informasi waktu matahari terbit dan terbenam ([d]aylight): + +`ansiweather -F -s true -d true` + +- Tampilkan informasi kecepatan angin ([w]ind) dan kelembapan udara ([h]umidity) bagi waktu dan lokasi saat ini: + +`ansiweather -w true -h true` diff --git a/pages.id/common/ant.md b/pages.id/common/ant.md new file mode 100644 index 000000000..447538551 --- /dev/null +++ b/pages.id/common/ant.md @@ -0,0 +1,24 @@ +# ant + +> Apache Ant: bangun dan atur proyek pengembangan piranti lunak berbasis Java. +> Informasi lebih lanjut: . + +- Bangun suatu proyek Java dengan pengaturan yang didefinisikan dalam `build.xml` (lokasi default): + +`ant` + +- Bangun proyek menggunakan berkas/[f]ile pengaturan selain `build.xml`: + +`ant -f {{buildfile.xml}}` + +- Tampilkan informasi mengenai daftar target pembangunan piranti lunak yang memungkinkan bagi proyek ini: + +`ant -p` + +- Tampilkan informasi pendukung awakutu ([d]ebugging): + +`ant -d` + +- Jalankan pembangunan bagi seluruh target pembangunan yang tidak bergantung kepada target-target yang gagal dibangun: + +`ant -k` diff --git a/pages.id/common/antibody.md b/pages.id/common/antibody.md new file mode 100644 index 000000000..1e593db0e --- /dev/null +++ b/pages.id/common/antibody.md @@ -0,0 +1,16 @@ +# antibody + +> Program manajemen plugin syel "si paling cepat". +> Informasi lebih lanjut: . + +- Gabungkan semua plugin untuk dimuat dalam syel secara statis: + +`antibody bundle < {{~/.zsh_plugins.txt}} > {{~/.zsh_plugins.sh}}` + +- Mutakhirkan seluruh bundel: + +`antibody update` + +- Tampilkan seluruh plugin yang terpasang: + +`antibody list` diff --git a/pages.id/common/anytopnm.md b/pages.id/common/anytopnm.md new file mode 100644 index 000000000..f52de229d --- /dev/null +++ b/pages.id/common/anytopnm.md @@ -0,0 +1,12 @@ +# anytopnm + +> Ubah format gambar apapun menuju format gambar umum. +> Informasi lebih lanjut: . + +- Ubah suatu gambar dari format apapun menuju format PBM, PGM, atau PPM: + +`anytopnm {{jalan/menuju/input}} > {{jalan/menuju/output.pnm}}` + +- Tampilkan informasi versi: + +`anytopnm -version` diff --git a/pages.id/common/apg.md b/pages.id/common/apg.md new file mode 100644 index 000000000..66942186e --- /dev/null +++ b/pages.id/common/apg.md @@ -0,0 +1,24 @@ +# apg + +> Buat kata sandi secara acak dan kompleks. +> Informasi lebih lanjut: . + +- Buat sebuah kata sandi secara acak (panjang default bagi kata sandi adalah 8): + +`apg` + +- Buat sebuah kata sandi dengan minimum 1 simbol (S), 1 nomor (N), 1 huruf kapital (C), dan 1 huruf kecil (L): + +`apg -M SNCL` + +- Buat kata sandi dengan panjang 16 karakter: + +`apg -m {{16}}` + +- Buat kata sandi dengan panjang ma[x]imum 16 karakter: + +`apg -x {{16}}` + +- Buat sebuah kata sandi yang tidak mengandung kata yang terkandung di dalam suatu berkas kamus: + +`apg -r {{jalan/menuju/berkas_kamus}}` diff --git a/pages.id/common/apkleaks.md b/pages.id/common/apkleaks.md new file mode 100644 index 000000000..f4a500bb5 --- /dev/null +++ b/pages.id/common/apkleaks.md @@ -0,0 +1,17 @@ +# apkleaks + +> Pindai berkas APK (aplikasi Android) untuk mencari URI, alur pemanggilan (endpoint), dan konfigurasi rahasia. +> Catatan: APKLeaks menggunakan `jadx` untuk membongkar kode aplikasi Android. +> Informasi lebih lanjut: . + +- Pindai berkas ([f]ile) APK untuk mencari daftar endpoint dan kode konfigurasi rahasia: + +`apkleaks --file {{jalan/menuju/berkas.apk}}` + +- Pindai dan simpan luaran ([o]utput) ke dalam suatu berkas: + +`apkleaks --file {{jalan/menuju/berkas.apk}} --output {{jalan/menuju/berkas_output.txt}}` + +- Berikan [a]rgumen perintah tambahan untuk `jadx`: + +`apkleaks --file {{jalan/menuju/berkas.apk}} --args "{{--threads-count 5 --deobf}}"` diff --git a/pages.id/common/apm.md b/pages.id/common/apm.md new file mode 100644 index 000000000..d3481fa10 --- /dev/null +++ b/pages.id/common/apm.md @@ -0,0 +1,17 @@ +# apm + +> Manajer paket untuk aplikasi pengolah teks Atom. +> Lihat juga: `atom`. +> Informasi lebih lanjut: . + +- Pasang suatu paket dari atau tema dari : + +`apm install {{nama_paket}}` + +- Hapus pemasangan suatu paket atau tema: + +`apm remove {{nama_paket}}` + +- Mutakhirkan paket atau tema menuju versi terbaru: + +`apm upgrade {{nama_paket}}` diff --git a/pages.id/common/apropos.md b/pages.id/common/apropos.md new file mode 100644 index 000000000..1eb25e3f1 --- /dev/null +++ b/pages.id/common/apropos.md @@ -0,0 +1,16 @@ +# apropos + +> Lakukan pencarian nama dan deskripsi perintah dalam buku panduan program baris perintah (`manpages`). +> Informasi lebih lanjut: . + +- Cari daftar dokumentasi perintah yang mengandung kata dengan format kata kunci ekspresi reguler (regex): + +`apropos {{ekspresi_reguler}}` + +- Jangan pangkas tampilan teks hasil pencarian menurut panjang jendela terminal: + +`apropos -l {{ekspresi_reguler}}` + +- Cari daftar dokumentasi perintah yang mengandung seluruh ([a]ll) kriteria kata dalam bentuk ekspresi reguler (regex): + +`apropos {{ekspresi_reguler_1}} -a {{ekspresi_reguler_2}} -a {{ekspresi_reguler_3}}` diff --git a/pages.id/common/ar.md b/pages.id/common/ar.md new file mode 100644 index 000000000..dae8ea44b --- /dev/null +++ b/pages.id/common/ar.md @@ -0,0 +1,25 @@ +# ar + +> Buat, olah, dan ekstrak berkas dalam format arsip Unix. Biasanya dimanfaatkan untuk pustaka statis (`.a`) dan paket piranti lunak Debian (`.deb`). +> Lihat juga: `tar`. +> Informasi lebih lanjut: . + +- E[x]trak seluruh berkas dalam suatu arsip: + +`ar x {{jalan/menuju/berkas.a}}` + +- Lihat daf[t]ar isi dari suatu arsip: + +`ar t {{jalan/menuju/berkas.ar}}` + +- Gantikan ([r]eplace) atau tambahkan suatu berkas ke dalam arsip: + +`ar r {{jalan/menuju/berkas.deb}} {{jalan/menuju/debian-binary jalan/menuju/control.tar.gz jalan/menuju/data.tar.xz ...}}` + +- Ma[s]ukkan suatu berkas objek (setara dengan penggunaan `ranlib`): + +`ar s {{jalan/menuju/berkas.a}}` + +- Buat suatu arsip berisikan kumpulan berkas tertentu, dan suatu berkas daftar indeks para objek: + +`ar rs {{jalan/menuju/berkas.a}} {{jalan/menuju/berkas1.o jalan/menuju/berkas2.o ...}}` diff --git a/pages.id/common/arc.md b/pages.id/common/arc.md new file mode 100644 index 000000000..19f2b36f5 --- /dev/null +++ b/pages.id/common/arc.md @@ -0,0 +1,20 @@ +# arc + +> Arcanist: program CLI untuk Phabricator. +> Informasi lebih lanjut: . + +- Kirim semua perubahan untuk ditinjau melalui alat Differential: + +`arc diff` + +- Tampilkan daftar revisi yang masih menunggu persetujuan (pending): + +`arc list` + +- Mutakhirkan pesan-pesan Git seusai peninjauan: + +`arc amend` + +- Simpan (land/push) perubahan yang disetujui menuju repositori Git: + +`arc land` diff --git a/pages.id/common/arch.md b/pages.id/common/arch.md new file mode 100644 index 000000000..85ab222fb --- /dev/null +++ b/pages.id/common/arch.md @@ -0,0 +1,9 @@ +# arch + +> Tampilkan nama arsitektur sistem saat ini. +> Lihat juga: `uname`. +> Informasi lebih lanjut: . + +- Tampilkan informasi arsitektur sistem saat ini: + +`arch` diff --git a/pages.id/common/archwiki-rs.md b/pages.id/common/archwiki-rs.md new file mode 100644 index 000000000..4f8a2d027 --- /dev/null +++ b/pages.id/common/archwiki-rs.md @@ -0,0 +1,20 @@ +# archwiki-rs + +> Baca, cari, dan unduh artikel dari situs ArchWiki. +> Informasi lebih lanjut: . + +- Baca suatu artikel dari situs ArchWiki: + +`archwiki-rs read-page {{judul_artikel}}` + +- Baca suatu artikel dari ArchWiki dengan format tertentu: + +`archwiki-rs read-page {{judul_artikel}} --format {{plain-text|markdown|html}}` + +- Cari artikel dalam ArchWiki yang mengandung teks tertentu: + +`archwiki-rs search "{{teks_yang_dicari}}" --text-search` + +- Unduh seluruh artikel dari situs ArchWiki ke dalam suatu direktori: + +`archwiki-rs local-wiki {{/jalan/menuju/wiki_lokal}} --format {{plain-text|markdown|html}}` diff --git a/pages.id/common/arduino-builder.md b/pages.id/common/arduino-builder.md new file mode 100644 index 000000000..a95d813f0 --- /dev/null +++ b/pages.id/common/arduino-builder.md @@ -0,0 +1,25 @@ +# arduino-builder + +> Bangun program dari kode sumber piranti lunak (sketsa) Arduino. +> PERINGATAN DEPREKASI: Alat ini sedang dihapus demi penggunaan perintah `arduino` yang baru. +> Informasi lebih lanjut: . + +- Bangun program dari suatu berkas (sketsa) kode sumber piranti lunak: + +`arduino-builder -compile {{jalan/menuju/sketsa.ino}}` + +- Tentukan tingkat penampilan informasi awakutu (nilai bawaan: 5): + +`arduino-builder -debug-level {{1..10}}` + +- Tentukan direktori untuk menampung hasil pembangunan: + +`arduino-builder -build-path {{jalan/menuju/direktori_hasil_pembangunan}}` + +- Gunakan konfigurasi yang didefinisikan di dalam suatu berkas, daripada mendefinisikan parameter perintah seperti `-hardware` dan `-tools` berulang kali: + +`arduino-builder -build-options-file {{jalan/menuju/build.options.json}}` + +- Gunakan mode verbose, tampilkan proses pembangunan secara rinci: + +`arduino-builder -verbose {{true}}` diff --git a/pages.id/common/arduino.md b/pages.id/common/arduino.md new file mode 100644 index 000000000..98956b64d --- /dev/null +++ b/pages.id/common/arduino.md @@ -0,0 +1,36 @@ +# arduino + +> Arduino Studio - Sebuah alat pengembangan piranti lunak (IDE) bagi platform Arduino. +> Informasi lebih lanjut: . + +- Bangun piranti lunak dari suatu berkas (sketsa) kode sumber: + +`arduino --verify {{jalan/menuju/berkas.ino}}` + +- Bangun dan pasang piranti lunak menuju perangkat Arduino: + +`arduino --upload {{jalan/menuju/berkas.ino}}` + +- Bangun dan pasang piranti lunak menuju suatu perangkat Arduino Nano dengan prosesor Atmega328p yang terhubung dalam port `/dev/ttyACM0`: + +`arduino --board {{arduino:avr:nano:cpu=atmega328p}} --port {{/dev/ttyACM0}} --upload {{jalan/menuju/berkas.ino}}` + +- Atur `nilai` untuk suatu jenis preferensi/konfigurasi berdasarkan `nama` atau kata kunci: + +`arduino --pref {{nama}}={{nilai}}` + +- Bangun piranti lunak, kemudian simpan menuju suatu direktori hasil pembangunan, dan gunakan kembali hasil-hasil sebelumnya di dalam direktori tersebut: + +`arduino --pref build.path={{jalan/menuju/direktori_hasil_pembangunan}} --verify {{jalan/menuju/bekas.ino}}` + +- Simpan segala perubahan pada preferensi/konfigurasi menuju berkas `preferences.txt`: + +`arduino --save-prefs` + +- Pasang piranti pendukung pengembangan untuk perangkat Arduino berbasis SAM (seperti Arduino Due): + +`arduino --install-boards "{{arduino:sam}}"` + +- Pasang pustaka piranti lunak (library) untuk Bridge dan Servo: + +`arduino --install-library "{{Bridge:1.0.0,Servo:1.2.0}}"` diff --git a/pages.id/common/argocd-app.md b/pages.id/common/argocd-app.md new file mode 100644 index 000000000..65288f4af --- /dev/null +++ b/pages.id/common/argocd-app.md @@ -0,0 +1,36 @@ +# argocd app + +> Program baris perintah untuk mengatur aplikasi bersama Argo CD. +> Informasi lebih lanjut: . + +- Dapatkan daftar aplikasi yang diatur bersama Argo CD: + +`argocd app list --output {{json|yaml|wide}}` + +- Lihat informasi mengenai suatu aplikasi: + +`argocd app get {{nama_aplikasi}} --output {{json|yaml|wide}}` + +- Sebarkan (deploy) aplikasi secara internal (ke dalam klaster yang sama dengan yang dijalankan Argo CD): + +`argocd app create {{nama_aplikasi}} --repo {{alamat_url_repositori_dalam_git}} --path {{jalan/menuju/repo}} --dest-server https://kubernetes.default.svc --dest-namespace {{ns}}` + +- Hapus suatu aplikasi: + +`argocd app delete {{nama_aplikasi}}` + +- Aktifkan fitur sinkronisasi otomatis dalam suatu aplikasi: + +`argocd app set {{nama_aplikasi}} --sync-policy auto --auto-prune --self-heal` + +- Pratinjau hasil proses sinkronisasi aplikasi tanpa berdampak kepada klaster yang berjalan (dry-run): + +`argocd app sync {{nama_aplikasi}} --dry-run --prune` + +- Tampilkan riwayat penyebaran (deployment) aplikasi: + +`argocd app history {{nama_aplikasi}} --output {{wide|id}}` + +- Batalkan penyebaran dengan memuat (rollback) versi hasil sebaran sebelumnya (dan menghapus sumber daya baru yang tak diduga), berdasarkan nomor induk (ID) riwayat: + +`argocd app rollback {{nama_aplikasi}} {{id_riwayat}} --prune` diff --git a/pages.id/common/argocd.md b/pages.id/common/argocd.md new file mode 100644 index 000000000..294e9b7de --- /dev/null +++ b/pages.id/common/argocd.md @@ -0,0 +1,13 @@ +# argocd + +> Program baris perintah untuk mengatur suatu peladen (server) Argo CD. +> Beberapa subperintah seperti `argocd app` memiliki dokumentasi terpisah. +> Informasi lebih lanjut: . + +- Masuk (login) ke dalam suatu peladen Argo CD: + +`argocd login --insecure --username {{nama_pengguna}} --password {{kata_sandi}} {{peladen_argocd:port}}` + +- Dapatkan daftar aplikasi: + +`argocd app list` diff --git a/pages.id/common/argon2.md b/pages.id/common/argon2.md new file mode 100644 index 000000000..6fd610956 --- /dev/null +++ b/pages.id/common/argon2.md @@ -0,0 +1,20 @@ +# argon2 + +> Hitung kode hash menggunakan algoritma kriptografi Argon2. +> Informasi lebih lanjut: . + +- Hitung kode hash dari suatu kata kunci (password) dengan suatu kata garam (salt) menggunakan parameter kriptografi bawaan: + +`echo "{{kata_sandi}}" | argon2 "{{kata_garam}}"` + +- Hitung kode hash dengan algoritma tertentu: + +`echo "{{kata_sandi}}" | argon2 "{{kata_garam}}" -{{d|i|id}}` + +- Jangan tampilkan informasi tambahan selain hasil kode hash: + +`echo "{{kata_sandi}}" | argon2 "{{kata_garam}}" -e` + +- Hitung kode hash dengan konfigurasi wak[t]u, pemanfaatan [m]emori (RAM), dan [p]aralelisme pada pemrosesan kriptografi secara tertentu: + +`echo "{{kata_sandi}}" | argon2 "{{kata_garam}}" -t {{5}} -m {{20}} -p {{7}}` diff --git a/pages.id/common/aria2.md b/pages.id/common/aria2.md new file mode 100644 index 000000000..d5c9d902f --- /dev/null +++ b/pages.id/common/aria2.md @@ -0,0 +1,7 @@ +# aria2 + +> Perintah ini merupakan alias dari `aria2c`. + +- Tampilkan dokumentasi untuk perintah asli: + +`tldr aria2c` diff --git a/pages.id/common/aria2c.md b/pages.id/common/aria2c.md index eb8cf7cd7..4a2b2fa12 100644 --- a/pages.id/common/aria2c.md +++ b/pages.id/common/aria2c.md @@ -10,7 +10,7 @@ - Unduh file yang ditunjuk oleh URI yang ditentukan dengan nama keluaran yang ditentukan: -`aria2c --out={{nama_file}} "{{url}}"` +`aria2c --out {{nama_file}} "{{url}}"` - Unduh beberapa file (berbeda) secara paralel: @@ -26,7 +26,7 @@ - Unduh dengan banyak koneksi: -`aria2c --split={{jumlah_koneksi}} "{{url}}"` +`aria2c --split {{jumlah_koneksi}} "{{url}}"` - Unduhan FTP dengan nama pengguna dan kata sandi: diff --git a/pages.id/common/arp-scan.md b/pages.id/common/arp-scan.md new file mode 100644 index 000000000..3627d0e56 --- /dev/null +++ b/pages.id/common/arp-scan.md @@ -0,0 +1,20 @@ +# arp-scan + +> Kirim paket ARP menuju kumpulan alamat IP atau host untuk memindai suatu jaringan komputer lokal. +> Informasi lebih lanjut: . + +- Pindai jaringan lokal yang terhubung saat ini: + +`arp-scan --localnet` + +- Pindai suatu alamat IP dengan pengaturan bitmask khusus: + +`arp-scan {{192.168.1.1}}/{{24}}` + +- Pindai suatu jaringan IP menggunakan rentang alamat tertentu: + +`arp-scan {{172.0.0.0}}-{{127.0.0.31}}` + +- Pindai suatu jaringan IP menggunakan net mask khusus: + +`arp-scan {{10.0.0.0}}:{{255.255.255.0}}` diff --git a/pages.id/common/arp.md b/pages.id/common/arp.md new file mode 100644 index 000000000..0220ed7a3 --- /dev/null +++ b/pages.id/common/arp.md @@ -0,0 +1,16 @@ +# arp + +> Tampilkan dan manipulasi cache informasi ARP pada sistem operasi Anda. +> Informasi lebih lanjut: . + +- Tampilkan informasi tabel ARP yang dikenali sistem operasi Anda saat ini: + +`arp -a` + +- Hapus suatu entri dari tabel ARP sistem: + +`arp -d {{alamat}}` + +- Ma[s]ukkan suatu entri baru ke dalam tabel ARP sistem: + +`arp -s {{alamat_ip}} {{alamat_mac}}` diff --git a/pages.id/common/arping.md b/pages.id/common/arping.md new file mode 100644 index 000000000..48246f35d --- /dev/null +++ b/pages.id/common/arping.md @@ -0,0 +1,29 @@ +# arping + +> Cari dan selidiki para host jaringan melalui protokol ARP. +> Bermanfaat untuk mencari alamat MAC dalam jaringan. +> Informasi lebih lanjut: . + +- Ping suatu host dengan megirimkan paket permintaan ARP: + +`arping {{alamat_ip_host}}` + +- Ping suatu host melalui antarmuka jaringan tertentu (contoh: `eth0`): + +`arping -I {{antarmuka_jaringan}} {{alamat_ip_host}}` + +- Ping suatu host dan hentikan jika sang host mulai membalasnya: + +`arping -f {{alamat_ip_host}}` + +- Ping suatu host untuk jumlah kesempatan tertentu: + +`arping -c {{jumlah_kesempatan}} {{alamat_ip_host}}` + +- Sebarluaskan paket permintaan ARP kepada host apapun untuk membantu memutakhirkan informasi ARP dalam host tetangga: + +`arping -U {{alamat_ip_untuk_disebarluaskan}}` + +- [D]eteksi adanya alamat IP duplikat dalam jaringan ini dengan mengirimkan permintaan ARP dengan jangka waktu habis (timeout) sebanyak 3 detik: + +`arping -D -w {{3}} {{alamat_ip_untuk_diperiksa}}` diff --git a/pages.id/common/bat.md b/pages.id/common/bat.md index a98643003..b405b0088 100644 --- a/pages.id/common/bat.md +++ b/pages.id/common/bat.md @@ -4,26 +4,34 @@ > Klon dari `cat` dengan sintaks berwarna dan integrasi Git. > Informasi lebih lanjut: . -- Mencetak konten berkas ke keluaran standar: +- Cetak rapi konten berkas ke `stdout`: -`bat {{berkas}}` +`bat {{jalan/menuju/berkas1 jalan/menuju/berkas2 ...}}` -- Menggabungkan konten beberapa berkas ke berkas tujuan: +- Gabungkan konten beberapa berkas ke berkas tujuan: -`bat {{berkas1}} {{berkas2}} > {{berkas_tujuan}}` +`bat {{jalan/menuju/berkas1 jalan/menuju/berkas2 ...}} > {{jalan/menuju/berkas_tujuan}}` -- Menambahkan konten beberapa berkas ke berkas tujuan: +- Hapus dekorasi dan matikan fitur tampilan halaman (paging) (opsi `--style plain` dapat digantikan dengan `-p`, atau nyalakan kedua opsi dengan `-pp`): -`bat {{berkas1}} {{berkas2}} >> {{berkas_tujuan}}` +`bat --style plain --pager never {{jalan/menuju/berkas}}` + +- Sorot baris tertentu dengan warna latar belakang yang berbeda: + +`bat {{--highlight-line|-H}} {{10|5:10|:10|10:|10:+5}} {{jalan/menuju/berkas}}` + +- Tunjukkan segala karakter yang tak tercetak seperti spasi, tab, atau indikator baris baru: + +`bat {{--show-all|-A}} {{jalan/menuju/berkas}}` - Memberi nomor pada setiap baris keluaran: -`bat --number {{berkas}}` +`bat {{--number|-n}} {{berkas}}` - Mencetak konten JSON dengan sintaks berwarna: -`bat --language json {{jalan/menuju/berkas.json}}` +`bat {{--language|-l}} json {{jalan/menuju/berkas.json}}` - Menampilkan semua bahasa yang didukung: -`bat --list-languages` +`bat {{--list-languages|-L}}` diff --git a/pages.id/common/brew-autoremove.md b/pages.id/common/brew-autoremove.md new file mode 100644 index 000000000..31bacf269 --- /dev/null +++ b/pages.id/common/brew-autoremove.md @@ -0,0 +1,12 @@ +# brew autoremove + +> Hapus formula-formula yang tak digunakan dan sebelumnya dibutuhkan untuk memasang formula lain. +> Informasi lebih lanjut: . + +- Hapus semua formula yang tak digunakan kembali: + +`brew autoremove` + +- Tampilkan daftar formula yang dapat dihapus tanpa melakukannya (dry-run): + +`brew autoremove --dry-run` diff --git a/pages.id/common/brew-bundle.md b/pages.id/common/brew-bundle.md new file mode 100644 index 000000000..a194e4429 --- /dev/null +++ b/pages.id/common/brew-bundle.md @@ -0,0 +1,28 @@ +# brew bundle + +> Pembungkus untuk Homebrew, Homebrew Cask, dan App Store untuk macOS. +> Informasi lebih lanjut: . + +- Pasang seluruh paket menurut data Brewfile pada direktori saat ini: + +`brew bundle` + +- Pasang seluruh paket menurut data Brewfile pada lokasi tertentu: + +`brew bundle --file {{jalan/menuju/berkas}}` + +- Buat suatu berkas Brewfile berisikan daftar seluruh paket yang terpasang saat ini: + +`brew bundle dump` + +- Hapus seluruh formula yang tidak didefinisikan atau dibutuhkan pada formula dalam berkas Brewfile: + +`brew bundle cleanup --force` + +- Cari tahu apakah terdapat formula yang perlu dipasang atau dimutakhirkan dalam berkas Brewfile: + +`brew bundle check` + +- Tampilkan seluruh entri dalam berkas Brewfile: + +`brew bundle list --all` diff --git a/pages.id/common/brew-install.md b/pages.id/common/brew-install.md new file mode 100644 index 000000000..531c35fc7 --- /dev/null +++ b/pages.id/common/brew-install.md @@ -0,0 +1,16 @@ +# brew install + +> Pasang suatu formula atau cask pada Homebrew. +> Informasi lebih lanjut: . + +- Pasang suatu formula/cask: + +`brew install {{formula|cask}}` + +- Bangun dan pasang suatu formula dari kode sumber (seluruh formula yang dibutuhkan tetap akan diunduh sebagai berkas jadian / bottle): + +`brew install --build-from-source {{formula}}` + +- Unduh manifest dan tampilkan daftar formula/cask yang akan dipasang tanpa melakukannya (dry-run): + +`brew install --dry-run {{formula|cask}}` diff --git a/pages.id/common/brew.md b/pages.id/common/brew.md new file mode 100644 index 000000000..088c4cbaa --- /dev/null +++ b/pages.id/common/brew.md @@ -0,0 +1,37 @@ +# brew + +> Homebrew - suatu manajer paket bagi macOS dan Linux. +> Beberapa subperintah seperti `install` mempunyai dokumentasi terpisah. +> Informasi lebih lanjut: . + +- Pasang versi terkini oleh suatu formula atau cask (gunakan `--devel` untuk memasang versi pengembangan): + +`brew install {{formula}}` + +- Tampilkan daftar formula dan cask yang terpasang: + +`brew list` + +- Mutakhirkan suatu formula atau cask (jika nama tidak disediakan, semua formula dan cask terpasang akan dimutakhirkan): + +`brew upgrade {{formula}}` + +- Dapatkan program Homebrew versi terkini dan semua formula dan cask yang tersedia dari repositori paket Homebrew: + +`brew update` + +- Tampilkan daftar formula dan cask yang memiliki versi lebih baru dari yang terpasang: + +`brew outdated` + +- Cari formula (paket biasa) serta cask (berkas aplikasi `.app` bagi macOS): + +`brew search {{teks}}` + +- Tampilkan informasi mengenai suatu formula atau cask (versi, lokasi pemasangan, formula/cask tambahan yang dibutuhkan, dll.): + +`brew info {{formula}}` + +- Cek kondisi pemasangan Homebrew saat ini untuk mendeteksi kemungkinan galat atau masalah: + +`brew doctor` diff --git a/pages.id/common/calligraflow.md b/pages.id/common/calligraflow.md new file mode 100644 index 000000000..5d085c136 --- /dev/null +++ b/pages.id/common/calligraflow.md @@ -0,0 +1,17 @@ +# calligraflow + +> Aplikasi pengolah flowchart dan diagram, bagian dari Calligra. +> Lihat juga: `calligrastage`, `calligrawords`, `calligrasheets`. +> Informasi lebih lanjut: . + +- Buka aplikasi pengolah flowchart dan diagram: + +`calligraflow` + +- Buka suatu berkas: + +`calligraflow {{jalan/menuju/berkas}}` + +- Tampilkan informasi bantuan atau versi aplikasi: + +`calligraflow --{{help|version}}` diff --git a/pages.id/common/calligrasheets.md b/pages.id/common/calligrasheets.md new file mode 100644 index 000000000..ca11029e1 --- /dev/null +++ b/pages.id/common/calligrasheets.md @@ -0,0 +1,17 @@ +# calligrasheets + +> Aplikasi pengolah lembar kerja (spreadsheet), bagian dari Calligra. +> Lihat juga: `calligraflow`, `calligrastage`, `calligrawords`. +> Informasi lebih lanjut: . + +- Buka aplikasi pengolah lembar kerja (spreadsheet): + +`calligrasheets` + +- Buka suatu berkas: + +`calligrasheets {{jalan/menuju/berkas}}` + +- Tampilkan informasi bantuan atau versi aplikasi: + +`calligrasheets --{{help|version}}` diff --git a/pages.id/common/calligrastage.md b/pages.id/common/calligrastage.md new file mode 100644 index 000000000..680a78497 --- /dev/null +++ b/pages.id/common/calligrastage.md @@ -0,0 +1,17 @@ +# calligrastage + +> Aplikasi presentasi, bagian dari Calligra. +> Lihat juga: `calligraflow`, `calligrawords`, `calligrasheets`. +> Informasi lebih lanjut: . + +- Buka aplikasi presentasi: + +`calligrastage` + +- Buka suatu berkas: + +`calligrastage {{jalan/menuju/berkas}}` + +- Tampilkan informasi bantuan atau versi aplikasi: + +`calligrastage --{{help|version}}` diff --git a/pages.id/common/calligrawords.md b/pages.id/common/calligrawords.md new file mode 100644 index 000000000..f47127726 --- /dev/null +++ b/pages.id/common/calligrawords.md @@ -0,0 +1,17 @@ +# calligrawords + +> Aplikasi pengolah dokumen teks, bagian dari Calligra. +> Lihat juga: `calligraflow`, `calligrastage`, `calligrasheets`. +> Informasi lebih lanjut: . + +- Buka aplikasi pengolah dokumen teks: + +`calligrawords` + +- Buka suatu berkas: + +`calligrawords {{jalan/menuju/berkas}}` + +- Tampilkan informasi bantuan atau versi aplikasi: + +`calligrawords --{{help|version}}` diff --git a/pages.id/common/cat.md b/pages.id/common/cat.md index 9269109a9..343507cde 100644 --- a/pages.id/common/cat.md +++ b/pages.id/common/cat.md @@ -1,7 +1,7 @@ # cat > Cetak dan menggabungkan berkas. -> Informasi lebih lanjut: . +> Informasi lebih lanjut: . - Cetak konten berkas menuju `stdout`: diff --git a/pages.id/common/cp.md b/pages.id/common/cp.md index 74c827fbe..735869db2 100644 --- a/pages.id/common/cp.md +++ b/pages.id/common/cp.md @@ -1,28 +1,36 @@ # cp -> Membuat salinan file dan direktori. +> Salin berkas dan direktori. > Informasi lebih lanjut: . -- Membuat salinan file ke lokasi lain: +- Salin berkas ke lokasi lain: -`cp {{jalan/menuju/file_sumber.ext}} {{jalan/menuju/file_tujuan.ext}}` +`cp {{jalan/menuju/berkas_sumber.ext}} {{jalan/menuju/berkas_tujuan.ext}}` -- Menyalin file ke direktori lain, dengan nama yang sama: +- Salin berkas ke direktori lain, dengan nama yang sama: -`cp {{jalan/menuju/file_sumber.ext}} {{jalan/menuju/direktori_tujuan}}` +`cp {{jalan/menuju/berkas_sumber.ext}} {{jalan/menuju/direktori_tujuan}}` -- Menyalin sebuah direktori secara beserta isinya ke lokasi lain (jika tujuan sudah ada, direktori tersebut disalin ke dalamnya): +- Salin sebuah direktori secara rekursif beserta isinya ke lokasi lain (jika tujuan sudah ada, direktori tersebut disalin ke dalamnya): `cp -R {{jalan/menuju/direktori_sumber}} {{jalan/menuju/direktori_tujuan}}` -- Menyalin sebuah direktori secara beserta isinya, dalam mode `verbose` (menampilkan file-file ketika disalin): +- Salin sebuah direktori secara rekursif beserta isinya, dengan menampilkan berkas-berkas ketika disalin (mode verbose): `cp -vR {{jalan/menuju/direktori_sumber}} {{jalan/menuju/direktori_tujuan}}` -- Menyalin file-file teks ke lokasi lain, dalam mode interaktif (menampilkan pertanyaan sebelum menimpa): +- Salin lebih dari satu berkas menuju suatu direktori: + +`cp -t {{path/to/direktori_tujuan}} {{jalan/menuju/berkas1 jalan/menuju/berkas2 ...}}` + +- Salin berkas-berkas teks ke lokasi lain, dalam mode interaktif (menampilkan pertanyaan sebelum menimpa): `cp -i {{*.txt}} {{jalan/menuju/direktori_tujuan}}` -- Melepaskan tautan simbolis sebelum menyalin: +- Salin tautan simbolis sebelum menyalin: `cp -L {{tautan}} {{jalan/menuju/direktori_tujuan}}` + +- Gunakan argumen pertama sebagai direktori tujuan (berguna untuk perintah seperti `xargs ... | cp -t `): + +`cp -t {{path/to/direktori_tujuan}} {{jalan/menuju/berkas_atau_direktori1 jalan/menuju/berkas_atau_direktori2 ...}}` diff --git a/pages.id/common/docker-build.md b/pages.id/common/docker-build.md index a764229c8..d36520f92 100644 --- a/pages.id/common/docker-build.md +++ b/pages.id/common/docker-build.md @@ -3,19 +3,19 @@ > Bangun sebuah image dari Dockerfile. > Informasi lebih lanjut: . -- Bangun sebuah image docker meggunakan Dockerfile dalam direktori saat ini: +- Bangun sebuah image Docker meggunakan Dockerfile dalam direktori saat ini: `docker build .` -- Bangun sebuah docker image dari Dockerfile dengan menggunakan URL yang spesifik: +- Bangun sebuah Docker image dari Dockerfile dengan menggunakan URL yang spesifik: `docker build {{github.com/creack/docker-firefox}}` -- Bangun sebuah docker image dengan tag tertentu: +- Bangun sebuah Docker image dengan tag tertentu: `docker build --tag {{nama:tag}} .` -- Bangun sebuah docker image tanpa konteks pembangunan: +- Bangun sebuah Docker image tanpa konteks pembangunan: `docker build --tag {{nama:tag}} - < {{Dockerfile}}` @@ -23,10 +23,10 @@ `docker build --no-cache --tag {{nama:tag}} .` -- Bangun sebuah docker image dengan Dockerfile tertentu: +- Bangun sebuah Docker image dengan Dockerfile tertentu: `docker build --file {{Dockerfile}} .` -- Bangun sebuah docker image dengan variabel lingkungan tertentu: +- Bangun sebuah Docker image dengan variabel lingkungan tertentu: `docker build --build-arg {{HTTP_PROXY=http://10.20.30.2:1234}} --build-arg {{FTP_PROXY=http://40.50.60.5:4567}} .` diff --git a/pages.id/common/docker-ps.md b/pages.id/common/docker-ps.md index 2817738eb..74a32a273 100644 --- a/pages.id/common/docker-ps.md +++ b/pages.id/common/docker-ps.md @@ -29,8 +29,8 @@ - Pilah kontainer berdasarkan status (created, running, removing, paused, exited, dan dead): -`docker ps --filter="status={{status}}"` +`docker ps --filter "status={{status}}"` - Pilah kontainer yang mengaitkan suatu volume tertentu atau memiliki volume yang terpasang pada jalur tertentu: -`docker ps --filter="volume={{jalan/menuju/direktori}}" --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Mounts}}"` +`docker ps --filter "volume={{jalan/menuju/direktori}}" --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Mounts}}"` diff --git a/pages.id/common/docker.md b/pages.id/common/docker.md index 3c08453ed..053bd011d 100644 --- a/pages.id/common/docker.md +++ b/pages.id/common/docker.md @@ -4,7 +4,7 @@ > Kami mempunyai dokumentasi terpisah untuk menggunakan subperintah seperti `docker run`. > Informasi lebih lanjut: . -- Tampilkan semua daftar kontainer docker (yang sedang berjalan dan berhenti): +- Tampilkan semua daftar kontainer Docker (yang sedang berjalan dan berhenti): `docker ps --all` @@ -16,7 +16,7 @@ `docker {{start|stop}} {{nama_kontainer}}` -- Tarik citra dari registri docker: +- Tarik citra dari registri Docker: `docker pull {{citra}}` diff --git a/pages.id/common/fossil-ci.md b/pages.id/common/fossil-ci.md index fea9db41e..af008c133 100644 --- a/pages.id/common/fossil-ci.md +++ b/pages.id/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> Perintah ini merupakan alias dari `fossil-commit`. +> Perintah ini merupakan alias dari `fossil commit`. > Informasi lebih lanjut: . - Tampilkan dokumentasi untuk perintah asli: diff --git a/pages.id/common/fossil-delete.md b/pages.id/common/fossil-delete.md index 2c30ee675..463fd6a92 100644 --- a/pages.id/common/fossil-delete.md +++ b/pages.id/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > Perintah ini merupakan alias dari `fossil rm`. > Informasi lebih lanjut: . diff --git a/pages.id/common/fossil-forget.md b/pages.id/common/fossil-forget.md index b01114ff7..89e794cb8 100644 --- a/pages.id/common/fossil-forget.md +++ b/pages.id/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > Perintah ini merupakan alias dari `fossil rm`. > Informasi lebih lanjut: . diff --git a/pages.id/common/fossil-new.md b/pages.id/common/fossil-new.md index 45fddb162..2f7d029cb 100644 --- a/pages.id/common/fossil-new.md +++ b/pages.id/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> Perintah ini merupakan alias dari `fossil-init`. +> Perintah ini merupakan alias dari `fossil init`. > Informasi lebih lanjut: . - Tampilkan dokumentasi untuk perintah asli: diff --git a/pages.id/common/gh-cs.md b/pages.id/common/gh-cs.md index 5b333d9a1..cee01d00f 100644 --- a/pages.id/common/gh-cs.md +++ b/pages.id/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> Perintah ini merupakan alias dari `gh-codespace`. +> Perintah ini merupakan alias dari `gh codespace`. > Informasi lebih lanjut: . - Tampilkan dokumentasi untuk perintah asli: diff --git a/pages.id/common/git-clear-soft.md b/pages.id/common/git-clear-soft.md new file mode 100644 index 000000000..3424dc71e --- /dev/null +++ b/pages.id/common/git-clear-soft.md @@ -0,0 +1,9 @@ +# git clear-soft + +> Hapus direktori kerja Git tidak termasuk file di `.gitignore`, seolah-olah baru saja dikloning dengan cabang saat ini. +> Bagian dari `git-extras`. +> Informasi lebih lanjut: . + +- Reset semua file yang terlacak dan hapus semua file yang tidak terlacak: + +`git clear-soft` diff --git a/pages.id/common/git-coauthor.md b/pages.id/common/git-coauthor.md new file mode 100644 index 000000000..57a8c7260 --- /dev/null +++ b/pages.id/common/git-coauthor.md @@ -0,0 +1,9 @@ +# git coauthor + +> Tambahkan penulis komit baru dalam komit terkini. Perintah ini menulis ulang riwayat perubahan pada Git, karena itu opsi `--force` akan dibutuhkan saat melakukan pendorongan perubahan (push) di lain waktu. +> Bagian dari `git extras`. +> Informasi lebih lanjut: . + +- Tambahkan penulis baru terkadap komit Git terakhir: + +`git coauthor {{nama}} {{nama@example.com}}` diff --git a/pages.id/common/git-cola.md b/pages.id/common/git-cola.md new file mode 100644 index 000000000..8351e6188 --- /dev/null +++ b/pages.id/common/git-cola.md @@ -0,0 +1,24 @@ +# git cola + +> Tampilan antarmuka grafis (GUI) untuk Git yang kuat, apik, dan intuitif. +> Informasi lebih lanjut: . + +- Jalankan program GUI: + +`git cola` + +- Jalankan GUI pada mode perubahan (amend): + +`git cola --amend` + +- Jalankan dengan meminta program menanyakan repositori Git yang akan dilihat. Jika tidak didefinisikan, maka program ini akan melihat direktori saat ini: + +`git cola --prompt` + +- Jalankan dengan membuka repositori Git dengan alamat yang ditentukan: + +`git cola --repo {{jalan/menuju/repositori-git}}` + +- Terapkan filter jalur ke dalam widget status: + +`git cola --status-filter {{filter}}` diff --git a/pages.id/common/git-column.md b/pages.id/common/git-column.md new file mode 100644 index 000000000..34f5f5305 --- /dev/null +++ b/pages.id/common/git-column.md @@ -0,0 +1,16 @@ +# git column + +> Tampilkan data dalam bentuk kolom. +> Informasi lebih lanjut: . + +- Tampilkan `stdin` dalam bentuk beberapa kolom: + +`ls | git column --mode={{column}}` + +- Tampilkan `stdin` sebagai beberapa kolom dengan lebar maksimum sebesar `100`: + +`ls | git column --mode=column --width={{100}}` + +- Tampilkan `stdin` sebagai beberapa kolom dengan padding maksimum sebesar `30`: + +`ls | git column --mode=column --padding={{30}}` diff --git a/pages.id/common/git-commit-graph.md b/pages.id/common/git-commit-graph.md new file mode 100644 index 000000000..fcd1a57f8 --- /dev/null +++ b/pages.id/common/git-commit-graph.md @@ -0,0 +1,16 @@ +# git commit-graph + +> Tulis dan verifikasi file grafik komit Git. +> Informasi lebih lanjut: . + +- Tulis file grafik komit untuk komit yang dikemas di dalam direktori `.git` pada lokal repositori: + +`git commit-graph write` + +- Tulis file grafik komit yang berisi semua komit yang dapat dijangkau: + +`git show-ref --hash | git commit-graph write --stdin-commits` + +- Tulis file grafik komit yang berisi semua komit dalam file grafik komit saat ini beserta yang dapat dijangkau dari `HEAD`: + +`git rev-parse {{HEAD}} | git commit-graph write --stdin-commits --append` diff --git a/pages.id/common/git-commit-tree.md b/pages.id/common/git-commit-tree.md new file mode 100644 index 000000000..3fb03cc79 --- /dev/null +++ b/pages.id/common/git-commit-tree.md @@ -0,0 +1,21 @@ +# git commit-tree + +> Alat untuk membuat objek komit secara tingkat rendah (low-level). +> Lihat juga: `git commit`. +> Informasi lebih lanjut: . + +- Buat objek komit baru dengan pesan tertentu: + +`git commit-tree {{tree}} -m "{{pesan}}"` + +- Buat objek komit dengan pesan yang disimpan dalam suatu berkas (gunakan `-` untuk membaca dari `stdin`): + +`git commit-tree {{tree}} -F {{jalan/menuju/berkas}}` + +- Buat sebuah objek komit yang ditandatangani oleh kunci enkripsi GPG: + +`git commit-tree {{tree}} -m "{{pesan}}" --gpg-sign` + +- Buat sebuah objek komit dengan komit induk tertentu: + +`git commit-tree {{tree}} -m "{{message}}" -p {{kode_hash_sha_atas_komit_induk}}` diff --git a/pages.id/common/git-commits-since.md b/pages.id/common/git-commits-since.md new file mode 100644 index 000000000..c7167c102 --- /dev/null +++ b/pages.id/common/git-commits-since.md @@ -0,0 +1,21 @@ +# git commits-since + +> Tampilkan daftar komit sejak waktu atau tanggal tertentu. +> Bagian dari `git-extras`. +> Informasi lebih lanjut: . + +- Tampilkan daftar komit yang dibentuk sejak kemarin (yesterday): + +`git commits-since {{yesterday}}` + +- Tampilkan daftar komit yang dibentuk sejak minggu lalu (last week): + +`git commits-since {{last week}}` + +- Tampilkan daftar komit yang dibentuk sejak bulan lalu (last month): + +`git commits-since {{last month}}` + +- Tampilkan daftar komit yang dibentuk sejak kemarin (yesterday), pada pukul 2 siang (2pm): + +`git commits-since {{yesterday 2pm}}` diff --git a/pages.id/common/git-config.md b/pages.id/common/git-config.md new file mode 100644 index 000000000..45f2b08aa --- /dev/null +++ b/pages.id/common/git-config.md @@ -0,0 +1,37 @@ +# git config + +> Ubah pengaturan Git untuk repositori-repositori tertentu. +> Konfigurasi ini dapat diatur hanya untuk repositori saat ini (lokal/local) atau untuk pengguna sistem operasi saat ini (global). +> Informasi lebih lanjut: . + +- Tampilkan hanya daftar pengaturan Git untuk repositori saat ini (sebagaimana tersimpan dalam `.git/config` dalam pangkal direktori repositori): + +`git config --list --local` + +- Tampilkan hanya daftar pengaturan Git untuk pengguna saat ini (sebagaimana tersimpan dalam `~/.gitconfig` sebagai default, atau bila ada, `$XDG_CONFIG_HOME/git/config`): + +`git config --list --global` + +- Tampilkan hanya daftar pengaturan Git untuk keseluruhan sistem operasi (sebagaimana tersimpan dalam `/etc/gitconfig`), dan tampilkan lokasi berkas tersebut: + +`git config --list --system --show-origin` + +- Tampilkan nilai atas entri konfigurasi saat ini (contoh: `alias.unstage`): + +`git config alias.unstage` + +- Simpan baru atau ubah nilai entri konfigurasi tertentu secara global (untuk pengguna saat ini): + +`git config --global alias.unstage "reset HEAD --"` + +- Hapus atau kembalikan nilai dari entri konfigurasi tersebut menuju nilai default (bila ada): + +`git config --global --unset alias.unstage` + +- Sunting konfigurasi Git pada repositori saat ini dengan aplikasi pengolah teks default: + +`git config --edit` + +- Sunting konfigurasi Git pada pengguna saat ini dengan aplikasi pengolah teks default: + +`git config --global --edit` diff --git a/pages.id/common/git-contrib.md b/pages.id/common/git-contrib.md new file mode 100644 index 000000000..59a5ae469 --- /dev/null +++ b/pages.id/common/git-contrib.md @@ -0,0 +1,9 @@ +# git contrib + +> Tampilkan daftar komit yang ditulis oleh penulis tertentu. +> Bagian dari `git extras`. +> Informasi lebih lanjut: . + +- Tampilkan daftar seluruh komit, beserta kode hash dan pesan, dari suatu penulis: + +`git contrib {{penulis}}` diff --git a/pages.id/common/git-count-objects.md b/pages.id/common/git-count-objects.md new file mode 100644 index 000000000..b419034a6 --- /dev/null +++ b/pages.id/common/git-count-objects.md @@ -0,0 +1,20 @@ +# git count-objects + +> Hitung jumlah objek komit yang telah dibuka beserta pemakaian ruang penyimpanan dalam direktori repositori saat ini. +> Informasi lebih lanjut: . + +- Hitung jumlah seluruh objek dan pemakaian ruang penyimpanan: + +`git count-objects` + +- Hitung jumlah seluruh objek dan pemakaian ruang penyimpanan, dalam format satuan yang lebih ramah dibaca manusia: + +`git count-objects --human-readable` + +- Tampilkan informasi perhitungan secara lebih mendalam: + +`git count-objects --verbose` + +- Tampilkan informasi perhitungan secara lebih mendalam, menggunakan format satuan yang lebih ramah dibaca manusia: + +`git count-objects --human-readable --verbose` diff --git a/pages.id/common/gnmic-sub.md b/pages.id/common/gnmic-sub.md index a46ada700..cd37671c5 100644 --- a/pages.id/common/gnmic-sub.md +++ b/pages.id/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > Perintah ini merupakan alias dari `gnmic subscribe`. > Informasi lebih lanjut: . diff --git a/pages.id/common/history.md b/pages.id/common/history.md index 467ccddba..9987c9fd8 100644 --- a/pages.id/common/history.md +++ b/pages.id/common/history.md @@ -7,15 +7,15 @@ `history` -- Tampilkan 20 perintah-perintah terakhir (di `zsh` perintah ini menampilkan semua perintah-perintah sejak dari baris ke-20): +- Tampilkan 20 perintah-perintah terakhir (di Zsh perintah ini menampilkan semua perintah-perintah sejak dari baris ke-20): `history {{20}}` -- Hapus sejarah perintah-perintah (hanya untuk sesi shell `bash` saat ini): +- Hapus sejarah perintah-perintah (hanya untuk sesi shell Bash saat ini): `history -c` -- Tulis ulang file sejarah dengan sejarah sesi shell `bash` saat ini (seringkali dikombinasikan dengan `history -c` untuk menghapus sejarah): +- Tulis ulang file sejarah dengan sejarah sesi shell Bash saat ini (seringkali dikombinasikan dengan `history -c` untuk menghapus sejarah): `history -w` diff --git a/pages.id/common/open.fish.md b/pages.id/common/open.fish.md index 805aeaa36..2e7d67976 100644 --- a/pages.id/common/open.fish.md +++ b/pages.id/common/open.fish.md @@ -1,7 +1,7 @@ # open > Buka file, direktori, dan alamat URI dengan aplikasi-aplikasi default yang dapat membukanya. -> Perintah ini tersedia melalui `fish` dalam sistem operasi yang tidak menawarkan perintah `open` secara bawaan (seperti Haiku dan macOS). +> Perintah ini tersedia melalui fish dalam sistem operasi yang tidak menawarkan perintah `open` secara bawaan (seperti Haiku dan macOS). > Informasi lebih lanjut: . - Buka sebuah file di dalam aplikasi default: diff --git a/pages.id/common/open.md b/pages.id/common/open.md index 647601fb6..0ff9189f1 100644 --- a/pages.id/common/open.md +++ b/pages.id/common/open.md @@ -6,6 +6,6 @@ `tldr open -p osx` -- Lihat dokumentasi perintah `open` yang disediakan dalam `fish`: +- Lihat dokumentasi perintah `open` yang disediakan dalam fish: `tldr open.fish` diff --git a/pages.id/common/pio-init.md b/pages.id/common/pio-init.md index 76561a15f..3a62b5329 100644 --- a/pages.id/common/pio-init.md +++ b/pages.id/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > Perintah ini merupakan alias dari `pio project`. diff --git a/pages.id/common/rsync.md b/pages.id/common/rsync.md index 79e95b748..4e3672b5d 100644 --- a/pages.id/common/rsync.md +++ b/pages.id/common/rsync.md @@ -14,24 +14,24 @@ - Transfer file dalam mode [a]rsip (untuk menyimpan atribut-atribut) dan terkompres (_[z]ipped_) secara _[v]erbose_ dan progresnya dapat dibaca orang (_[h]uman-readable [P]rogress_): -`rsync -azvhP {{lokasi/ke/file_lokal}} {{remote_host}}:{{lokasi/ke/remote_directory}}` +`rsync {{-zvhP|--compress --verbose --human-readable --partial --progress}} {{lokasi/ke/file_lokal}} {{remote_host}}:{{lokasi/ke/remote_directory}}` - Transfer direktori dan semua isiny dari remote ke lokal: -`rsync -r {{remote_host}}:{{lokasi/ke/remote_directory}} {{lokasi/ke/direktori_lokal}}` +`rsync {{-r|--recursive}} {{remote_host}}:{{lokasi/ke/remote_directory}} {{lokasi/ke/direktori_lokal}}` - Transfer isi direktori (namun bukan direktori itu sendiri) dari remote ke lokal: -`rsync -r {{remote_host}}:{{lokasi/ke/remote_directory}}/ {{lokasi/ke/direktori_lokal}}` +`rsync {{-r|--recursive}} {{remote_host}}:{{lokasi/ke/remote_directory}}/ {{lokasi/ke/direktori_lokal}}` - Transfer direktori secara [r]ecursif, dalam [a]rsip (untuk menyimpan atribut-atribut), menyelesaikan _soft[l]inks_ yang terkandung di sana, dan mengabaikan file-file yang sudah ditransfer kecuali jika file itu lebih baru (_[u]nless newer_): -`rsync -rauL {{remote_host}}:{{lokasi/ke/remote_file}} {{lokasi/ke/direktori_lokal}}` +`rsync {{-auL|--archive --update --copy-links}} {{remote_host}}:{{lokasi/ke/remote_file}} {{lokasi/ke/direktori_lokal}}` - Transfer file melalui SSH dan hapus file-file lokal yang tidak ada di _remote host_: -`rsync -e ssh --delete {{remote_host}}:{{lokasi/ke/remote_file}} {{lokasi/ke/file_lokal}}` +`rsync {{-e|--rsh}} ssh --delete {{remote_host}}:{{lokasi/ke/remote_file}} {{lokasi/ke/file_lokal}}` - Transfer file melalui SSH dengan menggunakan port yang yang berbeda dari bawaan dan tampilkan progres global: -`rsync -e 'ssh -p {{port}}' --info=progress2 {{remote_host}}:{{lokasi/ke/remote_file}} {{lokasi/ke/file_lokal}}` +`rsync {{-e|--rsh}} 'ssh -p {{port}}' --info=progress2 {{remote_host}}:{{lokasi/ke/remote_file}} {{lokasi/ke/file_lokal}}` diff --git a/pages.id/common/split.md b/pages.id/common/split.md index 8cbc7572b..f41c5d7f0 100644 --- a/pages.id/common/split.md +++ b/pages.id/common/split.md @@ -5,16 +5,16 @@ - Memisahkan sebuah file, tiap bagian memiliki 10 baris (kecuali di bagian terakhir): -`split -l {{10}} {{nama_file}}` +`split -l 10 {{jalan/menuju/berkas}}` - Memisahkan sebuah file menjadi 5 file. Dibagi sehingga masing-masing bagian memiliki ukuran yang sama (kecuali di bagian terakhir): -`split -n {{5}} {{nama_file}}` +`split -n 5 {{jalan/menuju/berkas}}` - Memisahkan sebuah file dengan ukuran 512 byte masing-masing bagiannya (kecuali di bagian terakhir; gunakan 512k untuk kilobyte dan 512m untuk megabytes): -`split -b {{512}} {{nama_file}}` +`split -b 512 {{jalan/menuju/berkas}}` - Memisahkan sebuah file dengan ukuran paling banyak 512 byte masing-masing bagiannya tanpa memotong baris: -`split -C {{512}} {{nama_file}}` +`split -C 512 {{jalan/menuju/berkas}}` diff --git a/pages.id/common/tlmgr-arch.md b/pages.id/common/tlmgr-arch.md index ef2558ccc..522064cd9 100644 --- a/pages.id/common/tlmgr-arch.md +++ b/pages.id/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > Perintah ini merupakan alias dari `tlmgr platform`. > Informasi lebih lanjut: . diff --git a/pages.id/linux/a2ensite.md b/pages.id/linux/a2ensite.md new file mode 100644 index 000000000..65d967dc0 --- /dev/null +++ b/pages.id/linux/a2ensite.md @@ -0,0 +1,12 @@ +# a2ensite + +> Izinkan sebuah host maya (virtual host) Apache pada OS berbasis Debian. +> Informasi lebih lanjut: . + +- Izinkan sebuah host maya: + +`sudo a2ensite {{host_maya}}` + +- Jangan tampilkan pesan informatif: + +`sudo a2ensite --quiet {{host_maya}}` diff --git a/pages.id/linux/acpi.md b/pages.id/linux/acpi.md new file mode 100644 index 000000000..7e9c57118 --- /dev/null +++ b/pages.id/linux/acpi.md @@ -0,0 +1,28 @@ +# acpi + +> Tampilkan status baterai atau informasi suhu. +> Informasi lebih lanjut: . + +- Tampilkan informasi baterai: + +`acpi` + +- Tampilkan informasi suhu: + +`acpi -t` + +- Tampilkan informasi perangkat pendingin: + +`acpi -c` + +- Tampilkan informasi suhu dalam Fahrenheit: + +`acpi -tf` + +- Tampilkan semua informasi: + +`acpi -V` + +- Ekstrak informasi dari `/proc` daripada `/sys`: + +`acpi -p` diff --git a/pages.id/linux/adduser.md b/pages.id/linux/adduser.md new file mode 100644 index 000000000..b09586b3a --- /dev/null +++ b/pages.id/linux/adduser.md @@ -0,0 +1,24 @@ +# adduser + +> Utilitas penambahan pengguna. +> Informasi lebih lanjut: . + +- Buat seorang pengguna baru dengan sebuah direktori pangkal/home bawaan dan mendesak pengguna untuk mengatur sebuah kata sandi: + +`adduser {{nama_pengguna}}` + +- Buat seorang pengguna baru tanpa sebuah direktori pangkal/home: + +`adduser --no-create-home {{nama_pengguna}}` + +- Buat seorang pengguna baru dengan sebuah direktori pangkal/home di jalur yang telah dispesifikasikan: + +`adduser --home {{jalur/ke/home}} {{nama_pengguna}}` + +- Buat seorang pengguna baru dengan shell yang telah dispesifikasikan sebagai shell login: + +`adduser --shell {{jalur/ke/shell}} {{nama_pengguna}}` + +- Buat seorang pengguna baru yang masuk ke grup pengguna yang dispesifikasikan: + +`adduser --ingroup {{grup}} {{nama_pengguna}}` diff --git a/pages.id/linux/apt-file.md b/pages.id/linux/apt-file.md new file mode 100644 index 000000000..e0a25844a --- /dev/null +++ b/pages.id/linux/apt-file.md @@ -0,0 +1,20 @@ +# apt-file + +> Cari kumpulan berkas di dalam paket `apt`, termasuk yang belum dipasang. +> Informasi lebih lanjut: . + +- Perbarui basis data metadata: + +`sudo apt update` + +- Cari paket yang berisi nama atau lokasi berkas tertentu: + +`apt-file {{search|find}} {{sebagian_nama_jalan/menuju/berkas}}` + +- Tampilkan daftar konten dari sebuah paket: + +`apt-file {{show|list}} {{paket}}` + +- Cari paket yang sesuai dengan `ekspresi_reguler`: + +`apt-file {{search|find}} --regexp {{ekspresi_reguler}}` diff --git a/pages.id/linux/ip-route-list.md b/pages.id/linux/ip-route-list.md index 8309fff03..ea8dfff04 100644 --- a/pages.id/linux/ip-route-list.md +++ b/pages.id/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> Perintah ini merupakan alias dari `ip-route-show`. +> Perintah ini merupakan alias dari `ip route show`. - Tampilkan dokumentasi untuk perintah asli: diff --git a/pages.id/linux/poweroff.md b/pages.id/linux/poweroff.md index 9e85347d5..2cdea3a21 100644 --- a/pages.id/linux/poweroff.md +++ b/pages.id/linux/poweroff.md @@ -1,7 +1,7 @@ # poweroff > Matikan sistem. -> Informasi lebih lanjut: . +> Informasi lebih lanjut: . - Matikan sistem: diff --git a/pages.id/osx/arch.md b/pages.id/osx/arch.md new file mode 100644 index 000000000..d0b18ebe9 --- /dev/null +++ b/pages.id/osx/arch.md @@ -0,0 +1,17 @@ +# arch + +> Tampilkan nama arsitektur sistem saat ini, atau jalankan suatu perintah menggunakan arsitektur yang berbeda. +> Lihat juga: `uname`. +> Informasi lebih lanjut: . + +- Tampilkan informasi arsitektur sistem saat ini: + +`arch` + +- Jalankan suatu perintah menggunakan arsitektur x86_64: + +`arch -x86_64 "{{command}}"` + +- Jalankan suatu perintah menggunakan arsitektur arm: + +`arch -arm64 "{{command}}"` diff --git a/pages.id/osx/date.md b/pages.id/osx/date.md index dbd5c7846..79b3743b5 100644 --- a/pages.id/osx/date.md +++ b/pages.id/osx/date.md @@ -17,4 +17,4 @@ - Menampilkan tanggal tertentu (diwakili sebagai _Unix timestamp_) menggunakan format bawaan: -`date -r 1473305798` +`date -r {{1473305798}}` diff --git a/pages.id/osx/shuf.md b/pages.id/osx/shuf.md index 71d705825..b80e3a11d 100644 --- a/pages.id/osx/shuf.md +++ b/pages.id/osx/shuf.md @@ -9,7 +9,7 @@ - Hanya mengoutputkan 5 entri dari hasil: -`shuf --head-count={{5}} {{nama_file}}` +`shuf --head-count=5 {{nama_file}}` - Menuliskan output ke file lain: @@ -17,4 +17,4 @@ - Men-generate angka acak dari 1-10: -`shuf --input-range={{1-10}}` +`shuf --input-range=1-10` diff --git a/pages.id/sunos/devfsadm.md b/pages.id/sunos/devfsadm.md new file mode 100644 index 000000000..58eea65ff --- /dev/null +++ b/pages.id/sunos/devfsadm.md @@ -0,0 +1,16 @@ +# devfsadm + +> Perintah administrasi untuk `/dev`. Kelola namespace `/dev`. +> Informasi lebih lanjut: . + +- Pindai piringan baru: + +`devfsadm -c disk` + +- Bersihkan semua tautan /dev yang beruntai dan memindai perangkat baru: + +`devfsadm -C -v` + +- Dry-run - luaran yang akan dirubah tapi tanpa membuat modifikasi: + +`devfsadm -C -v -n` diff --git a/pages.id/sunos/dmesg.md b/pages.id/sunos/dmesg.md new file mode 100644 index 000000000..ba3c5019a --- /dev/null +++ b/pages.id/sunos/dmesg.md @@ -0,0 +1,16 @@ +# dmesg + +> Tulis pesan kernel ke `stdout`. +> Informasi lebih lanjut: . + +- Tampilkan pesan kernel: + +`dmesg` + +- Tampilkan berapa memori fisik yang tersedia di sistem ini: + +`dmesg | grep -i memory` + +- Tampilkan pesan kernel 1 halaman dalam 1 waktu: + +`dmesg | less` diff --git a/pages.id/sunos/prctl.md b/pages.id/sunos/prctl.md new file mode 100644 index 000000000..0a349f1e7 --- /dev/null +++ b/pages.id/sunos/prctl.md @@ -0,0 +1,16 @@ +# prctl + +> Ambil atau atur sumber daya dari proses, tugas dan projek yang berjalan. +> Informasi lebih lanjut: . + +- Periksa batas dan perizinan proses: + +`prctl {{pid}}` + +- Periksa batas dan perizinan proses dalam format yang dapat diurai mesin: + +`prctl -P {{pid}}` + +- Ambil batas spesifik dari sebuah proses yang berjalan: + +`prctl -n process.max-file-descriptor {{pid}}` diff --git a/pages.id/sunos/prstat.md b/pages.id/sunos/prstat.md new file mode 100644 index 000000000..30adbb461 --- /dev/null +++ b/pages.id/sunos/prstat.md @@ -0,0 +1,24 @@ +# prstat + +> Laporkan statistik proses aktif. +> Informasi lebih lanjut: . + +- Periksa semua proses dan laporan statistik yang diurutkan berdasarkan tingkat penggunaan CPU: + +`prstat` + +- Periksa semua proses dan laporan statistik yang disortir berdasarkan penggunaan memori: + +`prstat -s rss` + +- Laporkan ringkasan total penggunaan untuk tiap user: + +`prstat -t` + +- Laporkan informasi pengukuran proses microstate: + +`prstat -m` + +- Cetak daftar penggunaan CPU 5 proses teratas tiap 1 detik: + +`prstat -c -n 5 -s cpu 1` diff --git a/pages.id/sunos/snoop.md b/pages.id/sunos/snoop.md new file mode 100644 index 000000000..7248b3d40 --- /dev/null +++ b/pages.id/sunos/snoop.md @@ -0,0 +1,25 @@ +# snoop + +> Pengendus paket jaringan. +> Perintah setara tcpdump untuk SunOS. +> Informasi lebih lanjut: . + +- Tangkap paket pada antarmuka jaringan tertentu: + +`snoop -d {{e1000g0}}` + +- Simpan paket yang tertangkap pada sebuah berkas dari pada menampilkannya: + +`snoop -o {{jalan/menuju/berkas}}` + +- Tampilkan rangkuman lapisan protokol paket-paket dari sebuah berkas dengan rinci: + +`snoop -V -i {{jalur/ke/berkas}}` + +- Tangkap paket jaringan yang datang dari sebuah nama host dan pergi ke port yang ditentukan: + +`snoop to port {{port}} from host {{nama_host}}` + +- Tangkap dan tampilkan sebuah hex-dump dari pertukaran paket jaringan di antara 2 alamat IP: + +`snoop -x0 -p4 {{ip1}} {{ip2}}` diff --git a/pages.id/sunos/svcadm.md b/pages.id/sunos/svcadm.md new file mode 100644 index 000000000..162eef1c7 --- /dev/null +++ b/pages.id/sunos/svcadm.md @@ -0,0 +1,24 @@ +# svcadm + +> Instansi untuk manipulasi hak akses layanan. +> Informasi lebih lanjut: . + +- Izinkan sebuah servis yang ada dalam basis data servis: + +`svcadm enable {{nama_servis}}` + +- Larang servis: + +`svcadm disable {{nama servis}}` + +- Jalankan ulang sebuah servis yang berjalan: + +`svcadm restart {{nama servis}}` + +- Perintahkan servis untuk baca ulang berkas konfigurasi: + +`svcadm refresh {{nama servis}}` + +- Bersihkan sebuah servis dari kondisi perawatan dan perintahkan untuk berjalan: + +`svcadm clear {{nama servis}}` diff --git a/pages.id/sunos/svccfg.md b/pages.id/sunos/svccfg.md new file mode 100644 index 000000000..35652ecb2 --- /dev/null +++ b/pages.id/sunos/svccfg.md @@ -0,0 +1,16 @@ +# svccfg + +> Impor, ekspor, dan modifikasi konfigurasi servis. +> Informasi lebih lanjut: . + +- Validasi berkas konfigurasi: + +`svccfg validate {{jalan/menuju/berkas_smf.xml}}` + +- Ekspor konfigurasi servis kedalam sebuah berkas: + +`svccfg export {{nama_servis}} > {{jalur/ke/berkas_smf.xml}}` + +- Impor/perbarui konfigurasi servis dari berkas: + +`svccfg import {{jalan/menuju/berkas_smf.xml}}` diff --git a/pages.id/sunos/svcs.md b/pages.id/sunos/svcs.md new file mode 100644 index 000000000..d2c89923a --- /dev/null +++ b/pages.id/sunos/svcs.md @@ -0,0 +1,24 @@ +# svcs + +> Ambil atau atur sumber daya dari proses, tugas dan projek yang berjalan. +> Informasi lebih lanjut: . + +- Daftar semua servis yang berjalan: + +`svcs` + +- Daftar servis-servis yang tidak berjalan: + +`svcs -vx` + +- Daftar informasi tentang sebuah servis: + +`svcs apache` + +- Tampilkan lokasi dari berkas catatan servis: + +`svcs -L apache` + +- Display end of a service log file: + +`tail $(svcs -L apache)` diff --git a/pages.id/sunos/truss.md b/pages.id/sunos/truss.md new file mode 100644 index 000000000..c666663d6 --- /dev/null +++ b/pages.id/sunos/truss.md @@ -0,0 +1,25 @@ +# truss + +> Alat pemecah masalah untuk menelusuri panggilan sistem. +> Perintah setara strace untuk SunOS. +> Informasi lebih lanjut: . + +- Telusuri sebuah program dengan mengeksekusinya dan mengawasi semua proses turunan: + +`truss -f {{program}}` + +- Mulai menelusuri sebuah proses tertentu berdasarkan PID-nya: + +`truss -p {{pid}}` + +- Mulai menelusuri sebuah program dengan mengeksekusinya, tampilkan argumen-argumen dan variabel-variabel lingkungan: + +`truss -a -e {{program}}` + +- Menghitung waktu, panggilan, dan error untuk setiap panggilan sistem dan laporkan sebuah ringkasan saat keluar program: + +`truss -c -p {{pid}}` + +- Telusuri proses berdasarkan keluaran dari panggilan sistem: + +`truss -p {{pid}} -t {{nama_panggilan_sistem}}` diff --git a/pages.id/windows/whoami.md b/pages.id/windows/whoami.md index 0d49e9ab6..1aa986970 100644 --- a/pages.id/windows/whoami.md +++ b/pages.id/windows/whoami.md @@ -19,6 +19,6 @@ `whoami /upn` -- Menampilkan id logon dari pengguna saat ini: +- Menampilkan ID logon dari pengguna saat ini: `whoami /logonid` diff --git a/pages.it/common/ack.md b/pages.it/common/ack.md index dcc7f5047..dca4bd6ca 100644 --- a/pages.it/common/ack.md +++ b/pages.it/common/ack.md @@ -18,11 +18,11 @@ - Limita la ricerca ai file di un tipo specifico: -`ack --type={{ruby}} "{{pattern_di_ricerca}}"` +`ack --type {{ruby}} "{{pattern_di_ricerca}}"` - Non cercare nei file di un tipo specifico: -`ack --type=no{{ruby}} "{{pattern_di_ricerca}}"` +`ack --type no{{ruby}} "{{pattern_di_ricerca}}"` - Conta il numero totale di corrispondenze trovate: diff --git a/pages.it/common/alacritty.md b/pages.it/common/alacritty.md index 9649e583b..67a439199 100644 --- a/pages.it/common/alacritty.md +++ b/pages.it/common/alacritty.md @@ -15,10 +15,10 @@ `alacritty -e {{comando}}` -- Specifica un file di configurazione alternativo (predefinito a `$XDG_CONFIG_HOME/alacritty/alacritty.yml`): +- Specifica un file di configurazione alternativo (predefinito a `$XDG_CONFIG_HOME/alacritty/alacritty.toml`): -`alacritty --config-file {{percorso/di/config.yml}}` +`alacritty --config-file {{percorso/di/config.toml}}` -- Esegui con ricaricamento configurazione live (può anche essere acceso in `alacritty.yml`): +- Esegui con ricaricamento configurazione live (può anche essere acceso in `alacritty.toml`): -`alacritty --live-config-reload --config-file {{percorsi/al/config.yml}}` +`alacritty --live-config-reload --config-file {{percorsi/al/config.toml}}` diff --git a/pages.it/common/autossh.md b/pages.it/common/autossh.md index 7316d91ca..0e00ae4ca 100644 --- a/pages.it/common/autossh.md +++ b/pages.it/common/autossh.md @@ -1,18 +1,18 @@ # autossh > Esegue, monitora e riavvia connessioni SSH. -> Si riconnette automaticamente per tenere attivi tunnel di port forwarding. Accetta tutte le flag di ssh. +> Si riconnette automaticamente per tenere attivi tunnel di port forwarding. Accetta tutte le flag di SSH. > Maggiori informazioni: . - Apri una sessione SSH, riavviandola quando una porta monitorata smette di rispondere: `autossh -M {{porta_monitorata}} "{{comando_ssh}}"` -- Apri una sessione ssh che forwarda una porta locale verso una remota, riavviandola se necessario: +- Apri una sessione SSH che forwarda una porta locale verso una remota, riavviandola se necessario: `autossh -M {{porta_monitorata}} -L {{porta_locale}}:localhost:{{porta_remota}} {{utente}}@{{host}}` -- Forka prima di eseguire il comando ssh (si avvia in background) e non aprire una shell remota: +- Forka prima di eseguire il comando SSH (si avvia in background) e non aprire una shell remota: `autossh -f -M {{porta_monitorata}} -N "{{comando_ssh}}"` diff --git a/pages.it/common/bash.md b/pages.it/common/bash.md index 33a0e6287..a56fbaa7a 100644 --- a/pages.it/common/bash.md +++ b/pages.it/common/bash.md @@ -24,6 +24,6 @@ `bash -s` -- Stampa informazioni sulla versione di bash (usa `echo $BASH_VERSION` per mostrare solo la versione): +- Stampa informazioni sulla versione di Bash (usa `echo $BASH_VERSION` per mostrare solo la versione): `bash --version` diff --git a/pages.it/common/bc.md b/pages.it/common/bc.md index 619cae61e..35654ca9e 100644 --- a/pages.it/common/bc.md +++ b/pages.it/common/bc.md @@ -1,7 +1,7 @@ # bc > Calcolatore. -> Maggiori informazioni: . +> Maggiori informazioni: . - Esegui in modalità interattiva utilizzando la libreria math della standard library: diff --git a/pages.it/common/cabal.md b/pages.it/common/cabal.md index 2d72a3296..37cff90d9 100644 --- a/pages.it/common/cabal.md +++ b/pages.it/common/cabal.md @@ -2,7 +2,7 @@ > Interfaccia da linea di comando per l'infrastruttura di compilazione di Haskell (Cabal). > Gestisce progetti Haskell e pacchetti Cabal dal repository di pacchetti Hackage. -> Maggiori informazioni: . +> Maggiori informazioni: . - Cerca ed elenca pacchetti da Hackage: diff --git a/pages.it/common/cat.md b/pages.it/common/cat.md index 473d35a9d..115ccf62a 100644 --- a/pages.it/common/cat.md +++ b/pages.it/common/cat.md @@ -1,7 +1,7 @@ # cat > Stampa e concatena file. -> Maggiori informazioni: . +> Maggiori informazioni: . - Stampa i contenuti di un file su standard output: diff --git a/pages.it/common/clamav.md b/pages.it/common/clamav.md index 8b05ce25a..83955383c 100644 --- a/pages.it/common/clamav.md +++ b/pages.it/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > Questo comando è un alias per `clamdscan`. > Maggiori informazioni: . diff --git a/pages.it/common/clear.md b/pages.it/common/clear.md index 0ee4c6cc8..2b8e79fac 100644 --- a/pages.it/common/clear.md +++ b/pages.it/common/clear.md @@ -3,6 +3,6 @@ > Pulisce lo schermo del terminale. > Maggiori informazioni: . -- Pulisci lo schermo (equivalente a Control+L se si utilizza la shell bash): +- Pulisci lo schermo (equivalente a Control+L se si utilizza la shell Bash): `clear` diff --git a/pages.it/common/clementine.md b/pages.it/common/clementine.md index 8eaebe331..563e5f921 100644 --- a/pages.it/common/clementine.md +++ b/pages.it/common/clementine.md @@ -1,7 +1,7 @@ # clementine > Un moderno player e gestore di librerie musicali. -> Maggiori informazioni: . +> Maggiori informazioni: . - Apri Clementine: diff --git a/pages.it/common/column.md b/pages.it/common/column.md index a6686d00d..03d51aa03 100644 --- a/pages.it/common/column.md +++ b/pages.it/common/column.md @@ -12,7 +12,7 @@ `printf "intestazione1 intestazione2\nbar foo\n" | column --table` -- Specifica un diverso separatore di colonna (e.g. "," per csv) (il predefinito è lo spazio): +- Specifica un diverso separatore di colonna (e.g. "," per CSV) (il predefinito è lo spazio): `printf "intestazione1 intestazione2\nbar foo\n" | column --table --separator {{,}}` diff --git a/pages.it/common/convert.md b/pages.it/common/convert.md deleted file mode 100644 index 4157824c0..000000000 --- a/pages.it/common/convert.md +++ /dev/null @@ -1,28 +0,0 @@ -# convert - -> Strumento della suite immagineMagick per la conversione di immagini. -> Maggiori informazioni: . - -- Converti un'immagine da JPG a PNG: - -`convert {{immagine.jpg}} {{immagine.png}}` - -- Scala un'immagine al 50% delle sue dimensioni originali: - -`convert {{immagine.png}} -resize 50% {{immagine2.png}}` - -- Scala un'immagine ad una dimensione massima di 640x480 mantenendo le proporzioni originali: - -`convert {{immagine.png}} -resize 640x480 {{immagine2.png}}` - -- Concatena più immagini orizzontalmente: - -`convert {{immagine1.png}} {{immagine2.png}} {{immagine3.png}} +append {{immagine123.png}}` - -- Crea una GIF da una serie di immagini con un intervallo di 100ms tra ogni immagine: - -`convert {{immagine1.png}} {{immagine2.png}} {{immagine3.png}} -delay {{100}} {{animazione.gif}}` - -- Crea un'immagine a tinta unita di un determinato colore: - -`convert -size {{800x600}} "xc:{{#ff0000}}" {{immagine.png}}` diff --git a/pages.it/common/dd.md b/pages.it/common/dd.md index 80ce0cb79..44e4a6b3d 100644 --- a/pages.it/common/dd.md +++ b/pages.it/common/dd.md @@ -1,24 +1,24 @@ # dd > Converti e copia un file. -> Maggiori informazioni: . +> Maggiori informazioni: . - Crea un disco USB avviabile da un file ISO e mostra il progresso: -`dd if={{file.iso}} of=/dev/{{disco_usb}} status=progress` +`dd if={{percorso/del/file.iso}} of={{/dev/disco_usb}} status=progress` -- Clona un disco in un altro a blocchi di 4MB, ignora gli errori e mostra il progresso: +- Clona un disco su un altro disco a blocchi con grandezza di 4 MiB e scarica le scritture prima che il comando termini: -`dd if=/dev/{{disco_sorgente}} of=/dev/{{disco_destinazione}} bs=4M conv=noerror status=progress` +`dd bs=4194304 conv=fsync if={{/dev/disco_sorgente}} of={{/dev/disco_destinazione}}` -- Genera un file di 100 byte randomici utilizzando il driver random del kernel: +- Genera un file con un numero specifico di byte randomici utilizzando il driver random del kernel: -`dd if=/dev/urandom of={{file_random}} bs=100 count=1` +`dd bs={{100}} count={{1}} if=/dev/urandom of={{percorso/del/file_random}}` - Testa la performance in scrittura di un disco: -`dd if=/dev/zero of={{file_1GB}} bs=1024 count=1000000` +`dd bs={{1024}} count={{1000000}} if=/dev/zero of={{percorso/del/file_1GB}}` -- Mostra il progresso di un'operazione dd in corso (comando da eseguire in un'altra shell): +- Crea un backup di sistema, salvalo in un file IMG (può essere ripristinato in seguito scambiando `if` e `of`), e mostra il progresso: -`kill -USR1 $(pgrep -x dd)` +`dd if={{/dev/disco}} of={{percorso/del/file.img}} status=progress` diff --git a/pages.it/common/diff.md b/pages.it/common/diff.md index 79e5406f8..4d7e5adb2 100644 --- a/pages.it/common/diff.md +++ b/pages.it/common/diff.md @@ -1,7 +1,7 @@ # diff > Confronta file e directory. -> Maggiori informazioni: . +> Maggiori informazioni: . - Confronta due file (elenca cambiamenti necessari per trasformare `vecchio_file` in `nuovo_file`): diff --git a/pages.it/common/docker-build.md b/pages.it/common/docker-build.md index 3533fc7a2..597df8747 100644 --- a/pages.it/common/docker-build.md +++ b/pages.it/common/docker-build.md @@ -1,28 +1,28 @@ # docker build -> Crea un'immagine a partire da un Dockerfile. La creazione di un'immagine docker è chiamata build. +> Crea un'immagine a partire da un Dockerfile. La creazione di un'immagine Docker è chiamata build. > Maggiori informazioni: . -- Crea un'immagine docker usando il Dockerfile nella directory corrente: +- Crea un'immagine Docker usando il Dockerfile nella directory corrente: `docker build .` -- Crea un'immagine docker usando il Dockerfile disponibile a un dato URL: +- Crea un'immagine Docker usando il Dockerfile disponibile a un dato URL: `docker build {{github.com/creack/docker-firefox}}` -- Crea e tagga un'immagine docker: +- Crea e tagga un'immagine Docker: `docker build --tag {{nome:tag}} .` -- Non usare la cache per la creazione di un'immagine docker: +- Non usare la cache per la creazione di un'immagine Docker: `docker build --no-cache --tag {{nome:tag}} .` -- Crea un'immagine docker usando un dato Dockerfile: +- Crea un'immagine Docker usando un dato Dockerfile: `docker build --file {{Dockerfile}} .` -- Crea un'immagine docker usando variabili fornite in fase di build: +- Crea un'immagine Docker usando variabili fornite in fase di build: `docker build --build-arg {{HTTP_PROXY=http://10.20.30.2:1234}} --build-arg {{FTP_PROXY=http://40.50.60.5:4567}} .` diff --git a/pages.it/common/docker-exec.md b/pages.it/common/docker-exec.md index 0815c96e8..4eb958f7b 100644 --- a/pages.it/common/docker-exec.md +++ b/pages.it/common/docker-exec.md @@ -19,7 +19,7 @@ `docker exec --interactive --detach {{nome_container}} {{comando}}` -- Imposta una variabile d'ambiente in una sessione bash in esecuzione: +- Imposta una variabile d'ambiente in una sessione Bash in esecuzione: `docker exec --interactive --tty --env {{nome_variabile}}={{valore}} {{nome_container}} {{/bin/bash}}` diff --git a/pages.it/common/docker-machine.md b/pages.it/common/docker-machine.md index 928348c3e..a6607466f 100644 --- a/pages.it/common/docker-machine.md +++ b/pages.it/common/docker-machine.md @@ -1,7 +1,7 @@ # docker-machine > Crea e gestisci macchine che utilizzano Docker. -> Maggiori informazioni: . +> Maggiori informazioni: . - Elenca macchine Docker in esecuzione: diff --git a/pages.it/common/docker-network.md b/pages.it/common/docker-network.md index 40b82a2c0..aa6b79b48 100644 --- a/pages.it/common/docker-network.md +++ b/pages.it/common/docker-network.md @@ -3,7 +3,7 @@ > Crea e gestisci reti docker. > Maggiori informazioni: . -- Elenca le reti disponibili configurate sul docker daemon: +- Elenca le reti disponibili configurate sul Docker daemon: `docker network ls` diff --git a/pages.it/common/ect.md b/pages.it/common/ect.md index 21ee28d8f..5778c1c67 100644 --- a/pages.it/common/ect.md +++ b/pages.it/common/ect.md @@ -1,6 +1,6 @@ # ect -> Efficiente Tool di Compressione (o ECT) è un ottimizzatore di file scritto in C++. Supporta file PNG, JPEG, GZIP e ZIP. +> Efficiente Tool di Compressione (o ECT) è un ottimizzatore di file scritto in C++. Supporta file PNG, JPEG, gzip e Zip. > Maggiori informazioni: . - Comprimi un file: diff --git a/pages.it/common/entr.md b/pages.it/common/entr.md index dae39f92d..aa61e2f65 100644 --- a/pages.it/common/entr.md +++ b/pages.it/common/entr.md @@ -1,7 +1,7 @@ # entr > Esegui comandi arbitrari al cambiamento di file. -> Maggiori informazioni: . +> Maggiori informazioni: . - Ricompila con `make` se qualsiasi file in quasiasi sottodirectory cambia: diff --git a/pages.it/common/expand.md b/pages.it/common/expand.md index 343232a3e..d04e034fd 100644 --- a/pages.it/common/expand.md +++ b/pages.it/common/expand.md @@ -17,8 +17,8 @@ - Sostituisci i tab con un determinato numero di spazi, non 8 (default): -`expand -t={{numero_spazi}} {{file}}` +`expand -t {{numero_spazi}} {{file}}` - Utilizza una lista separata da virgole di posizioni esplicite di tab: -`expand -t={{1,4,6}}` +`expand -t {{1,4,6}}` diff --git a/pages.it/common/fossil-ci.md b/pages.it/common/fossil-ci.md index 46b31e6aa..aa7e80a23 100644 --- a/pages.it/common/fossil-ci.md +++ b/pages.it/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> Questo comando è un alias per `fossil-commit`. +> Questo comando è un alias per `fossil commit`. > Maggiori informazioni: . - Consulta la documentazione del comando originale: diff --git a/pages.it/common/fossil-delete.md b/pages.it/common/fossil-delete.md index 045c51088..2dfd8c9e3 100644 --- a/pages.it/common/fossil-delete.md +++ b/pages.it/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > Questo comando è un alias per `fossil rm`. > Maggiori informazioni: . diff --git a/pages.it/common/fossil-forget.md b/pages.it/common/fossil-forget.md index 4047c7b2a..4288687b2 100644 --- a/pages.it/common/fossil-forget.md +++ b/pages.it/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > Questo comando è un alias per `fossil rm`. > Maggiori informazioni: . diff --git a/pages.it/common/fossil-new.md b/pages.it/common/fossil-new.md index 929b3c034..317a9fccf 100644 --- a/pages.it/common/fossil-new.md +++ b/pages.it/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> Questo comando è un alias per `fossil-init`. +> Questo comando è un alias per `fossil init`. > Maggiori informazioni: . - Consulta la documentazione del comando originale: diff --git a/pages.it/common/gh-cs.md b/pages.it/common/gh-cs.md index 9a71c8c02..f23050d93 100644 --- a/pages.it/common/gh-cs.md +++ b/pages.it/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> Questo comando è un alias per `gh-codespace`. +> Questo comando è un alias per `gh codespace`. > Maggiori informazioni: . - Consulta la documentazione del comando originale: diff --git a/pages.it/common/git-init.md b/pages.it/common/git-init.md index 5f6b1edff..58ed33bbc 100644 --- a/pages.it/common/git-init.md +++ b/pages.it/common/git-init.md @@ -15,6 +15,6 @@ `git init --object-format={{sha256}}` -- Inizializza un repository di soli dati, adatto per essere usato come server remoto accessibile via ssh: +- Inizializza un repository di soli dati, adatto per essere usato come server remoto accessibile via SSH: `git init --bare` diff --git a/pages.it/common/git-instaweb.md b/pages.it/common/git-instaweb.md index 704e63888..680dcc075 100644 --- a/pages.it/common/git-instaweb.md +++ b/pages.it/common/git-instaweb.md @@ -15,7 +15,7 @@ `git instaweb --start --port {{1234}}` -- Usa un http daemon specifico: +- Usa un HTTP daemon specifico: `git instaweb --start --httpd {{lighttpd|apache2|mongoose|plackup|webrick}}` diff --git a/pages.it/common/git-lfs.md b/pages.it/common/git-lfs.md index 63e5e4354..9658ace3e 100644 --- a/pages.it/common/git-lfs.md +++ b/pages.it/common/git-lfs.md @@ -1,7 +1,7 @@ # git lfs > Lavora con file di grandi dimensioni in repository Git. -> Maggiori informazioni: . +> Maggiori informazioni: . - Inizializza Git LFS: diff --git a/pages.it/common/gnmic-sub.md b/pages.it/common/gnmic-sub.md index aafbcef88..621e6004e 100644 --- a/pages.it/common/gnmic-sub.md +++ b/pages.it/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > Questo comando è un alias per `gnmic subscribe`. > Maggiori informazioni: . diff --git a/pages.it/common/magick-convert.md b/pages.it/common/magick-convert.md new file mode 100644 index 000000000..9c75a28ed --- /dev/null +++ b/pages.it/common/magick-convert.md @@ -0,0 +1,28 @@ +# magick convert + +> Strumento della suite immagineMagick per la conversione di immagini. +> Maggiori informazioni: . + +- Converti un'immagine da JPEG a PNG: + +`magick convert {{immagine.jpg}} {{immagine.png}}` + +- Scala un'immagine al 50% delle sue dimensioni originali: + +`magick convert {{immagine.png}} -resize 50% {{immagine2.png}}` + +- Scala un'immagine ad una dimensione massima di 640x480 mantenendo le proporzioni originali: + +`magick convert {{immagine.png}} -resize 640x480 {{immagine2.png}}` + +- Concatena più immagini orizzontalmente: + +`magick convert {{immagine1.png}} {{immagine2.png}} {{immagine3.png}} +append {{immagine123.png}}` + +- Crea una GIF da una serie di immagini con un intervallo di 100ms tra ogni immagine: + +`magick convert {{immagine1.png}} {{immagine2.png}} {{immagine3.png}} -delay {{100}} {{animazione.gif}}` + +- Crea un'immagine a tinta unita di un determinato colore: + +`magick convert -size {{800x600}} "xc:{{#ff0000}}" {{immagine.png}}` diff --git a/pages.it/common/man.md b/pages.it/common/man.md index 63675c0eb..21da226b3 100644 --- a/pages.it/common/man.md +++ b/pages.it/common/man.md @@ -1,7 +1,7 @@ # man > Formatta e mostra pagine manuale. -> Maggiori informazioni: . +> Maggiori informazioni: . - Mostra la pagina di manuale di un comando: diff --git a/pages.it/common/nmap.md b/pages.it/common/nmap.md index 98d235d8f..5d028ad18 100644 --- a/pages.it/common/nmap.md +++ b/pages.it/common/nmap.md @@ -2,7 +2,7 @@ > Nmap è un tool per port scanning ed esplorazione di rete. > Alcune funzionalità diventano attive solamente con privilegi d'amministratore. -> Maggiori informazioni: . +> Maggiori informazioni: . - Controlla se un indirizzo IP è attivo, e indovina il suo sistema operativo: diff --git a/pages.it/common/pio-init.md b/pages.it/common/pio-init.md index 28531cae0..936a827cc 100644 --- a/pages.it/common/pio-init.md +++ b/pages.it/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > Questo comando è un alias per `pio project`. diff --git a/pages.it/common/sudo.md b/pages.it/common/sudo.md index c3a6002b9..bec18e5ec 100644 --- a/pages.it/common/sudo.md +++ b/pages.it/common/sudo.md @@ -15,7 +15,7 @@ `sudo -u {{utente}} -g {{gruppo}} {{id -a}}` -- Ripeti l'ultimo comando prefissandolo con "sudo" (funziona solo in bash, zsh, ecc): +- Ripeti l'ultimo comando prefissandolo con "sudo" (funziona solo in Bash, Zsh, ecc): `sudo !!` diff --git a/pages.it/common/tlmgr-arch.md b/pages.it/common/tlmgr-arch.md index 143faf2aa..c9e6fd9f0 100644 --- a/pages.it/common/tlmgr-arch.md +++ b/pages.it/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > Questo comando è un alias per `tlmgr platform`. > Maggiori informazioni: . diff --git a/pages.it/common/tree.md b/pages.it/common/tree.md index 9e3b65886..550fe1633 100644 --- a/pages.it/common/tree.md +++ b/pages.it/common/tree.md @@ -1,7 +1,7 @@ # tree > Mostra i contenuti della directory corrente come un albero. -> Maggiori informazioni: . +> Maggiori informazioni: . - Stampa file e directory fino al 'num'-esimo livello di profondità (dove 1 significa la directory corrente): diff --git a/pages.it/linux/add-apt-repository.md b/pages.it/linux/add-apt-repository.md index f22d89fd3..416046389 100644 --- a/pages.it/linux/add-apt-repository.md +++ b/pages.it/linux/add-apt-repository.md @@ -1,13 +1,13 @@ # add-apt-repository -> Gestisce le definizioni di repository apt. +> Gestisce le definizioni di repository APT. > Maggiori informazioni: . -- Aggiunge un nuovo repository apt: +- Aggiunge un nuovo repository APT: `add-apt-repository {{identificativo_del_repository}}` -- Rimuove un repository apt: +- Rimuove un repository APT: `add-apt-repository --remove {{identificativo_del_repository}}` diff --git a/pages.it/linux/apt-add-repository.md b/pages.it/linux/apt-add-repository.md index 14ac6fd65..88a7ed1d0 100644 --- a/pages.it/linux/apt-add-repository.md +++ b/pages.it/linux/apt-add-repository.md @@ -1,13 +1,13 @@ # apt-add-repository -> Gestisce le definizioni di repository apt. +> Gestisce le definizioni di repository APT. > Maggiori informazioni: . -- Aggiunge un nuovo repository apt: +- Aggiunge un nuovo repository APT: `apt-add-repository {{identificativo_del_repository}}` -- Rimuove un repository apt: +- Rimuove un repository APT: `apt-add-repository --remove {{identificativo_del_repository}}` diff --git a/pages.it/linux/apt-file.md b/pages.it/linux/apt-file.md index bb1f8097b..58e6c0bdf 100644 --- a/pages.it/linux/apt-file.md +++ b/pages.it/linux/apt-file.md @@ -1,6 +1,6 @@ # apt-file -> Cerca un file dentro un pacchetto apt, includendo quelli non ancora installati. +> Cerca un file dentro un pacchetto APT, includendo quelli non ancora installati. > Maggiori informazioni: . - Aggiorna il database dei metadati: diff --git a/pages.it/linux/apt-key.md b/pages.it/linux/apt-key.md index 8460ab438..0a76c186f 100644 --- a/pages.it/linux/apt-key.md +++ b/pages.it/linux/apt-key.md @@ -19,6 +19,6 @@ `wget -qO - {{https://indirizzo.tld/filename.key}} | apt-key add -` -- Aggiunge una chiave da un server di chiavi con il solo id della chiave: +- Aggiunge una chiave da un server di chiavi con il solo ID della chiave: `apt-key adv --keyserver {{pgp.mit.edu}} --recv {{ID_DELLA_CHIAVE}}` diff --git a/pages.it/linux/ip-route-list.md b/pages.it/linux/ip-route-list.md index 9dce3a6ef..94a389d46 100644 --- a/pages.it/linux/ip-route-list.md +++ b/pages.it/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> Questo comando è un alias per `ip-route-show`. +> Questo comando è un alias per `ip route show`. - Consulta la documentazione del comando originale: diff --git a/pages.it/linux/ip.md b/pages.it/linux/ip.md index b14b2f949..eaa3d51d2 100644 --- a/pages.it/linux/ip.md +++ b/pages.it/linux/ip.md @@ -2,7 +2,7 @@ > Mostra / manipola routing, dispositivi, criteri di routing e tunnel. > Alcuni sottocomandi, come `ip address`, hanno una propria documentazione d'uso. -> Maggiori informazioni: . +> Maggiori informazioni: . - Elenca le interfacce con informazioni dettagliate: diff --git a/pages.it/linux/lsusb.md b/pages.it/linux/lsusb.md index 08106791a..c89409031 100644 --- a/pages.it/linux/lsusb.md +++ b/pages.it/linux/lsusb.md @@ -15,6 +15,6 @@ `lsusb --verbose` -- Elenca solamente i dispositivi con un certo id fornitore e id prodotto: +- Elenca solamente i dispositivi con un certo id fornitore e ID prodotto: `lsusb -d {{fornitore}}:{{prodotto}}` diff --git a/pages.it/linux/poweroff.md b/pages.it/linux/poweroff.md index 096cd09c5..67a9f1149 100644 --- a/pages.it/linux/poweroff.md +++ b/pages.it/linux/poweroff.md @@ -1,7 +1,7 @@ # poweroff > Chiude il sistema. -> Maggiori informazioni: . +> Maggiori informazioni: . - Spegne il sistema: diff --git a/pages.it/windows/logoff.md b/pages.it/windows/logoff.md index 97255f4f9..869b864ec 100644 --- a/pages.it/windows/logoff.md +++ b/pages.it/windows/logoff.md @@ -7,7 +7,7 @@ `logoff` -- Termina una sessione con il suo nome o id: +- Termina una sessione con il suo nome o ID: `logoff {{nome_sessione|id_sessione}}` diff --git a/pages.ja/common/7zr.md b/pages.ja/common/7zr.md index 4cdb22ad5..7cc8fe812 100644 --- a/pages.ja/common/7zr.md +++ b/pages.ja/common/7zr.md @@ -1,7 +1,7 @@ # 7zr > 圧縮率の高いファイルアーカイバです。 -> `7z` と似ていますが、 `7zr` は `.7z` 形式のみをサポートしています。 +> `7z` と似ていますが、 `7zr` は 7z 形式のみをサポートしています。 > 詳しくはこちら: - ファイルまたはディレクトリを圧縮する: diff --git a/pages.ja/common/bc.md b/pages.ja/common/bc.md index 5ed330d00..2b8de76e5 100644 --- a/pages.ja/common/bc.md +++ b/pages.ja/common/bc.md @@ -2,7 +2,7 @@ > 任意の精度で計算を行える言語です。 > `dc`も参照してください。 -> 詳しくはこちら: +> 詳しくはこちら: - 対話モードのセッションを開始する: diff --git a/pages.ja/common/cat.md b/pages.ja/common/cat.md index 8597dd0cf..3905d583a 100644 --- a/pages.ja/common/cat.md +++ b/pages.ja/common/cat.md @@ -1,7 +1,7 @@ # cat > ファイルの出力と連結を行います。 -> 詳しくはこちら: +> 詳しくはこちら: - ファイルの内容を標準出力に出力する: diff --git a/pages.ja/common/clamav.md b/pages.ja/common/clamav.md index ffd9c41ca..248b4c901 100644 --- a/pages.ja/common/clamav.md +++ b/pages.ja/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > このコマンドは `clamdscan` のエイリアスです。 > 詳しくはこちら: diff --git a/pages.ja/common/docker-ps.md b/pages.ja/common/docker-ps.md index c0cc3e52a..2b94dc1bc 100644 --- a/pages.ja/common/docker-ps.md +++ b/pages.ja/common/docker-ps.md @@ -17,7 +17,7 @@ - コンテナ名に指定の部分文字列を含むコンテナのみになるようにフィルタリングする: -`docker ps --filter="name={{コンテナ名}}"` +`docker ps --filter "name={{コンテナ名}}"` - 指定したイメージを原型(ancestor)として共有するコンテナのみになるようにフィルタリングする: @@ -25,12 +25,12 @@ - 終了コードでコンテナをフィルタリングする: -`docker ps --all --filter="exited={{コード}}"` +`docker ps --all --filter "exited={{コード}}"` - 以下のいずれかのステータスでフィルタリングする(created, running, removing, paused, exited, dead): -`docker ps --filter="status={{ステータス}}"` +`docker ps --filter "status={{ステータス}}"` - 特定のボリュームをマウントしている、または特定のパスにボリュームがマウントされているコンテナをフィルタリングする: -`docker ps --filter="volume={{ディレクトリパス}}" --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Mounts}}"` +`docker ps --filter "volume={{ディレクトリパス}}" --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Mounts}}"` diff --git a/pages.ja/common/docker-system.md b/pages.ja/common/docker-system.md index df68eb770..ff16679c0 100644 --- a/pages.ja/common/docker-system.md +++ b/pages.ja/common/docker-system.md @@ -21,7 +21,7 @@ - 不使用データのうち指定時間より前に作成されたものを削除する: -`docker system prune --filter="until={{時}}h{{分}}m"` +`docker system prune --filter "until={{時}}h{{分}}m"` - Dockerデーモンからのリアルタイムイベントを表示する: diff --git a/pages.ja/common/fossil-ci.md b/pages.ja/common/fossil-ci.md index a1b084fe2..eef9f6a2c 100644 --- a/pages.ja/common/fossil-ci.md +++ b/pages.ja/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> このコマンドは `fossil-commit` のエイリアスです。 +> このコマンドは `fossil commit`.のエイリアスです。 > 詳しくはこちら: - オリジナルのコマンドのドキュメントを表示する: diff --git a/pages.ja/common/fossil-delete.md b/pages.ja/common/fossil-delete.md index ed6672d3a..7048702b1 100644 --- a/pages.ja/common/fossil-delete.md +++ b/pages.ja/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > このコマンドは `fossil rm` のエイリアスです。 > 詳しくはこちら: diff --git a/pages.ja/common/fossil-forget.md b/pages.ja/common/fossil-forget.md index 9deb7780a..38844c768 100644 --- a/pages.ja/common/fossil-forget.md +++ b/pages.ja/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > このコマンドは `fossil rm` のエイリアスです。 > 詳しくはこちら: diff --git a/pages.ja/common/fossil-new.md b/pages.ja/common/fossil-new.md index fd67ee0eb..4567c4255 100644 --- a/pages.ja/common/fossil-new.md +++ b/pages.ja/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> このコマンドは `fossil-init` のエイリアスです。 +> このコマンドは `fossil init`.のエイリアスです。 > 詳しくはこちら: - オリジナルのコマンドのドキュメントを表示する: diff --git a/pages.ja/common/gh-cs.md b/pages.ja/common/gh-cs.md index 0ad5d4729..2ece419a6 100644 --- a/pages.ja/common/gh-cs.md +++ b/pages.ja/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> このコマンドは `gh-codespace` のエイリアスです。 +> このコマンドは `gh codespace`.のエイリアスです。 > 詳しくはこちら: - オリジナルのコマンドのドキュメントを表示する: diff --git a/pages.ja/common/gnmic-sub.md b/pages.ja/common/gnmic-sub.md index d6a7703f6..98bae4a09 100644 --- a/pages.ja/common/gnmic-sub.md +++ b/pages.ja/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > このコマンドは `gnmic subscribe` のエイリアスです。 > 詳しくはこちら: diff --git a/pages.ja/common/history.md b/pages.ja/common/history.md index 41fe3f8bb..0c2de4d1f 100644 --- a/pages.ja/common/history.md +++ b/pages.ja/common/history.md @@ -7,15 +7,15 @@ `history` -- 直近の20個のコマンドを表示する (`zsh` では20個目から始まるすべてのコマンドを表示する): +- 直近の20個のコマンドを表示する (Zsh では20個目から始まるすべてのコマンドを表示する): `history {{20}}` -- コマンド履歴のリストを消去する (現在の `bash` シェルに対してのみ): +- コマンド履歴のリストを消去する (現在の Bash シェルに対してのみ): `history -c` -- コマンド履歴ファイルを現在の `bash` シェルのコマンド履歴で上書きする (履歴を削除するために `history -c` と組み合わせることがよくあります): +- コマンド履歴ファイルを現在の Bash シェルのコマンド履歴で上書きする (履歴を削除するために `history -c` と組み合わせることがよくあります): `history -w` diff --git a/pages.ja/common/pio-init.md b/pages.ja/common/pio-init.md index ca32b0875..1b3a3b070 100644 --- a/pages.ja/common/pio-init.md +++ b/pages.ja/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > このコマンドは `pio project` のエイリアスです。 diff --git a/pages.ja/common/sed.md b/pages.ja/common/sed.md index 3114c76d7..db890f27b 100644 --- a/pages.ja/common/sed.md +++ b/pages.ja/common/sed.md @@ -1,7 +1,7 @@ # sed > スクリプトによるテキスト編集。 -> 詳しくはこちら: +> 詳しくはこちら: - ファイルの各行で正規表現の最初の出現箇所を置換し、その結果を表示する: diff --git a/pages.ja/common/tlmgr-arch.md b/pages.ja/common/tlmgr-arch.md index c33318078..fad945614 100644 --- a/pages.ja/common/tlmgr-arch.md +++ b/pages.ja/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > このコマンドは `tlmgr platform` のエイリアスです。 > 詳しくはこちら: diff --git a/pages.ja/linux/ip-route-list.md b/pages.ja/linux/ip-route-list.md index c41c49808..059420ec0 100644 --- a/pages.ja/linux/ip-route-list.md +++ b/pages.ja/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> このコマンドは `ip-route-show` のエイリアスです。 +> このコマンドは `ip route show`.のエイリアスです。 - オリジナルのコマンドのドキュメントを表示する: diff --git a/pages.ko/android/logcat.md b/pages.ko/android/logcat.md index b00d9caf7..5d5ab2ed4 100644 --- a/pages.ko/android/logcat.md +++ b/pages.ko/android/logcat.md @@ -17,8 +17,8 @@ - 특정 PID에 대한 로그 표시: -`logcat --pid={{프로세스_id}}` +`logcat --pid {{프로세스_id}}` - 특정 패키지의 프로세스에 대한 로그 표시: -`logcat --pid=$(pidof -s {{패키지}})` +`logcat --pid $(pidof -s {{패키지}})` diff --git a/pages.ko/common/2to3.md b/pages.ko/common/2to3.md index 4dac1b682..8f3799ba6 100644 --- a/pages.ko/common/2to3.md +++ b/pages.ko/common/2to3.md @@ -13,11 +13,11 @@ - 특정 파이썬 2 기능을 파이썬 3로 변경 (아래는 raw_input과 print를 수정하는 예): -`2to3 --write {{경로/파일.py}} --fix={{raw_input}} --fix={{print}}` +`2to3 --write {{경로/파일.py}} --fix {{raw_input}} --fix {{print}}` - 특정 기능을 제외한 모든 파이썬 2 기능을 파이썬 3로 변경: -`2to3 --write {{경로/파일.py}} --nofix={{has_key}} --nofix={{isinstance}}` +`2to3 --write {{경로/파일.py}} --nofix {{has_key}} --nofix {{isinstance}}` - 파이썬 2 에서 파이썬 3 로 변환할 수 있는 목록을 출력: @@ -25,8 +25,8 @@ - 디렉토리 안의 모든 파이썬 2 파일을 파이썬 3로 변경: -`2to3 --output-dir={{파이썬3/디렉토리/경로}} --write-unchanged-files --nobackups {{파이썬2/디렉토리/경로}}` +`2to3 --output-dir {{파이썬3/디렉토리/경로}} --write-unchanged-files --nobackups {{파이썬2/디렉토리/경로}}` - 2to3을 멀티쓰레드로 실행: -`2to3 --processes={{4}} --output-dir={{파이썬3/디렉토리/경로}} --write --nobackups --no-diff {{파이썬2/디렉토리/경로}}` +`2to3 --processes {{4}} --output-dir {{파이썬3/디렉토리/경로}} --write --nobackups --no-diff {{파이썬2/디렉토리/경로}}` diff --git a/pages.ko/common/alacritty.md b/pages.ko/common/alacritty.md index 5a4d79d76..62d343db1 100644 --- a/pages.ko/common/alacritty.md +++ b/pages.ko/common/alacritty.md @@ -15,10 +15,10 @@ `alacritty -e {{명령어}}` -- 대체 구성파일 지정 (기본값 : `$XDG_CONFIG_HOME/alacritty/alacritty.yml`): +- 대체 구성파일 지정 (기본값 : `$XDG_CONFIG_HOME/alacritty/alacritty.toml`): -`alacritty --config-file {{경로/config.yml}}` +`alacritty --config-file {{경로/config.toml}}` -- 재배치가 가능한 라이브 구성 설정으로 실행 (기본적으로 `alacritty.yml` 에서도 활성화 가능): +- 재배치가 가능한 라이브 구성 설정으로 실행 (기본적으로 `alacritty.toml` 에서도 활성화 가능): -`alacritty --live-config-reload --config-file {{경로/config.yml}}` +`alacritty --live-config-reload --config-file {{경로/config.toml}}` diff --git a/pages.ko/common/asciidoctor.md b/pages.ko/common/asciidoctor.md index df6c2e402..5563bd540 100644 --- a/pages.ko/common/asciidoctor.md +++ b/pages.ko/common/asciidoctor.md @@ -9,7 +9,7 @@ - 특정 `.adoc` 파일을 HTML로 변환하고 CSS 스타일시트 연결: -`asciidoctor -a stylesheet={{경로/대상/스타일시트.css}} {{경로/대상/파일.adoc}}` +`asciidoctor -a stylesheet {{경로/대상/스타일시트.css}} {{경로/대상/파일.adoc}}` - 특정 `.adoc` 파일을 포함 가능한 HTML로 변환하고, 본문을 제외한 모든 항목을 제거: @@ -17,4 +17,4 @@ - `asciidoctor-pdf` 라이브러리를 사용하여 특정 `.adoc` 파일을 PDF로 변환: -`asciidoctor --backend={{pdf}} --require={{asciidoctor-pdf}} {{경로/대상/파일.adoc}}` +`asciidoctor --backend {{pdf}} --require {{asciidoctor-pdf}} {{경로/대상/파일.adoc}}` diff --git a/pages.ko/common/autossh.md b/pages.ko/common/autossh.md index b96cc030a..bbd53473b 100644 --- a/pages.ko/common/autossh.md +++ b/pages.ko/common/autossh.md @@ -1,6 +1,6 @@ # autossh -> SSH 연결을 실행, 모니터링 및 재시작. port 재전송 tunnel을 유지하기 위해 자동 재연결. 모든 ssh 플래그 허용. +> SSH 연결을 실행, 모니터링 및 재시작. port 재전송 tunnel을 유지하기 위해 자동 재연결. 모든 SSH 플래그 허용. > 더 많은 정보: . - SSH session을 열고, 모니터링 포트가 데이터를 리턴하지 못하면 다시 시작: diff --git a/pages.ko/common/bash.md b/pages.ko/common/bash.md index 66d712dbb..9439ec836 100644 --- a/pages.ko/common/bash.md +++ b/pages.ko/common/bash.md @@ -28,6 +28,6 @@ `bash -e {{경로/대상/script.sh}}` -- `stdin`에서 bash 실행하기: +- `stdin`에서 Bash 실행하기: `{{echo "echo 'bash가 실행되었습니다'"}} | bash` diff --git a/pages.ko/common/bc.md b/pages.ko/common/bc.md index 435299b5d..f811290f1 100644 --- a/pages.ko/common/bc.md +++ b/pages.ko/common/bc.md @@ -1,7 +1,7 @@ # bc > 계산기의 기능을 수행합니다. -> 더 많은 정보: . +> 더 많은 정보: . - 표준 Math 라이브러리를 사용한 대화형 모드에서 계산기 실행하기: diff --git a/pages.ko/common/bosh.md b/pages.ko/common/bosh.md index 4d67d7d3e..23d9a5bb7 100644 --- a/pages.ko/common/bosh.md +++ b/pages.ko/common/bosh.md @@ -23,7 +23,7 @@ `bosh -e {{환경}} vms -d {{전개}}` -- 가상 머신의 ssh: +- 가상 머신의 SSH: `bosh -e {{환경}} ssh {{가상머신}} -d {{전개}}` diff --git a/pages.ko/common/browser-sync.md b/pages.ko/common/browser-sync.md index ebf989dc1..08dbb5e1a 100644 --- a/pages.ko/common/browser-sync.md +++ b/pages.ko/common/browser-sync.md @@ -7,7 +7,7 @@ `browser-sync start --server {{디렉토리/의/경로}} --files {{디렉토리/의/경로}}` -- 로컬 디렉토리에서 서버 시작, 일부 디렉토리에서 모든 css파일 확인: +- 로컬 디렉토리에서 서버 시작, 일부 디렉토리에서 모든 CSS파일 확인: `browser-sync start --server --files '{{디렉토리/의/경로/*.css}}'` diff --git a/pages.ko/common/cabal.md b/pages.ko/common/cabal.md index 85a079573..d7e555e98 100644 --- a/pages.ko/common/cabal.md +++ b/pages.ko/common/cabal.md @@ -2,7 +2,7 @@ > Haskell 패키지 인프라 (Cabal)에 대한 명령어 라인 인터페이스. > Hackage 패키지 저장소에서 Haskell 프로젝트 및 Cabal패키지 관리. -> 더 많은 정보: . +> 더 많은 정보: . - Hackage에서 패키지 검색 및 리스트: diff --git a/pages.ko/common/cat.md b/pages.ko/common/cat.md index 5208f26f6..34f318205 100644 --- a/pages.ko/common/cat.md +++ b/pages.ko/common/cat.md @@ -1,16 +1,24 @@ # cat > 파일 출력 및 연결. -> 더 많은 정보: . +> 더 많은 정보: . -- 표준출력으로 파일 내용 출력: +- 파일 내용을 `stdout`으로 출력: -`cat {{파일명}}` +`cat {{경로/대상/파일}}` -- 여러 파일을 대상 파일에 연결: +- 여러 파일을 출력 파일로 연결: -`cat {{파일명1 파일명2 ...}} > {{대상_파일명}}` +`cat {{경로/대상/파일1 경로/대상/파일2 ...}} > {{경로/대상/출력_파일}}` -- 대상 파일에 여러 파일 내용 추가: +- 여러 파일을 출력 파일에 추가: -`cat {{파일명1 파일명2 ...}} >> {{대상_파일명}}` +`cat {{경로/대상/파일1 경로/대상/파일2 ...}} >> {{경로/대상/출력_파일}}` + +- 버퍼링 없이 파일 내용을 출력 파일로 복사: + +`cat -u {{/dev/tty12}} > {{/dev/tty13}}` + +- `stdin`을 파일로 쓰기: + +`cat - > {{경로/대상/파일}}` diff --git a/pages.ko/common/clamav.md b/pages.ko/common/clamav.md index 013a7cb5d..e1f9e8071 100644 --- a/pages.ko/common/clamav.md +++ b/pages.ko/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > 이 명령은 `clamdscan` 의 에일리어스 (별칭) 입니다. > 더 많은 정보: . diff --git a/pages.ko/common/clear.md b/pages.ko/common/clear.md index b4da4d487..0f030439f 100644 --- a/pages.ko/common/clear.md +++ b/pages.ko/common/clear.md @@ -3,6 +3,6 @@ > 터미널 화면을 지웁니다(clear). > 더 많은 정보: . -- 터미널 화면을 지웁니다 (bash 쉘에서 Control-L을 누르는 것과 같은 기능입니다): +- 터미널 화면을 지웁니다 (Bash 쉘에서 Control-L을 누르는 것과 같은 기능입니다): `clear` diff --git a/pages.ko/common/clementine.md b/pages.ko/common/clementine.md index e39d47753..53206b992 100644 --- a/pages.ko/common/clementine.md +++ b/pages.ko/common/clementine.md @@ -1,7 +1,7 @@ # clementine > 현대적인 음악 플레이어이자 라이브러리 생성자. -> 더 많은 정보: . +> 더 많은 정보: . - Clementine 열기: diff --git a/pages.ko/common/column.md b/pages.ko/common/column.md index 2b95be647..3c08f7e88 100644 --- a/pages.ko/common/column.md +++ b/pages.ko/common/column.md @@ -12,7 +12,7 @@ `printf "header1 header2\nbar foo\n" | column --table` -- -t 옵션(예: "", csv)에 대한 열 구분 기호 문자를 지정; 기본값은 공백입니다: +- -t 옵션(예: "", CSV)에 대한 열 구분 기호 문자를 지정; 기본값은 공백입니다: `printf "header1,header2\nbar,foo\n" | column --table --separator {{,}}` diff --git a/pages.ko/common/convert.md b/pages.ko/common/convert.md deleted file mode 100644 index f48cb3afe..000000000 --- a/pages.ko/common/convert.md +++ /dev/null @@ -1,32 +0,0 @@ -# convert - -> ImageMagick 이미지 변환 도구. -> 더 많은 정보: . - -- JPG이미지를 PNG이미지로 변환: - -`convert {{이미지.jpg}} {{이미지.png}}` - -- 이미지를 원래 크기의 50%로 조정: - -`convert {{이미지.png}} -resize 50% {{이미지2.png}}` - -- 원래 종횡비를 유지하면서 이미지를 최대 640x480 크기로 조정: - -`convert {{이미지.png}} -resize 640x480 {{이미지2.png}}` - -- 이미지를 가로로 추가: - -`convert {{이미지1.png}} {{이미지2.png}} {{이미지3.png}} +append {{이미지123.png}}` - -- 이미지를 세로로 추가: - -`convert {{이미지1.png}} {{이미지2.png}} {{이미지3.png}} -append {{이미지123.png}}` - -- 100ms 지연된 일련의 이미지에서 GIF 만들기: - -`convert {{이미지1.png}} {{이미지2.png}} {{이미지3.png}} -delay {{100}} {{애니메이션.gif}}` - -- 단색 배경만으로 이미지 만들기: - -`convert -size {{800x600}} "xc:{{#ff0000}}" {{이미지.png}}` diff --git a/pages.ko/common/diff.md b/pages.ko/common/diff.md index 1b9afed5a..f1c74437c 100644 --- a/pages.ko/common/diff.md +++ b/pages.ko/common/diff.md @@ -1,7 +1,7 @@ # diff > 파일들과 디렉토리들을 비교한다. -> 더 많은 정보: . +> 더 많은 정보: . - 파일들 비교하기 (`이전_파일명`을 `새_파일명`으로 바꾸는 변경점들 목록): diff --git a/pages.ko/common/docker-machine.md b/pages.ko/common/docker-machine.md index ec40effc3..59bfbdc68 100644 --- a/pages.ko/common/docker-machine.md +++ b/pages.ko/common/docker-machine.md @@ -1,7 +1,7 @@ # docker-machine > 도커를 실행하는 머신들을 생성하고 관리한다. -> 더 많은 정보: . +> 더 많은 정보: . - 현재 실행중인 도커 머신들 목록보기: diff --git a/pages.ko/common/exa.md b/pages.ko/common/exa.md new file mode 100644 index 000000000..413d6cc7d --- /dev/null +++ b/pages.ko/common/exa.md @@ -0,0 +1,36 @@ +# exa + +> `ls`의 현대적인 대체품 (디렉토리 내용 나열). +> 더 많은 정보: . + +- 파일을 한 줄에 하나씩 나열: + +`exa --oneline` + +- 숨김 파일을 포함한 모든 파일 나열: + +`exa --all` + +- 모든 파일의 긴 형식 목록 (권한, 소유권, 크기 및 수정 날짜): + +`exa --long --all` + +- 가장 큰 파일을 맨 위에 나열: + +`exa --reverse --sort={{size}}` + +- 파일 트리를 3단계 깊이로 표시: + +`exa --long --tree --level={{3}}` + +- 수정 날짜순으로 파일 나열 (오래된 것부터): + +`exa --long --sort={{modified}}` + +- 헤더, 아이콘 및 Git 상태와 함께 파일 나열: + +`exa --long --header --icons --git` + +- `.gitignore`에 언급된 파일은 나열하지 않음: + +`exa --git-ignore` diff --git a/pages.ko/common/eza.md b/pages.ko/common/eza.md new file mode 100644 index 000000000..132a5f0f0 --- /dev/null +++ b/pages.ko/common/eza.md @@ -0,0 +1,36 @@ +# eza + +> `exa`를 기반으로 한 `ls`의 현대적이고 유지 관리되는 대체품. +> 더 많은 정보: . + +- 파일을 한 줄에 하나씩 나열: + +`eza --oneline` + +- 숨김 파일을 포함한 모든 파일 나열: + +`eza --all` + +- 모든 파일의 긴 형식 목록 (권한, 소유권, 크기 및 수정 날짜): + +`eza --long --all` + +- 가장 큰 파일을 맨 위에 나열: + +`eza --reverse --sort={{size}}` + +- 파일 트리를 3단계 깊이로 표시: + +`eza --long --tree --level={{3}}` + +- 수정 날짜순으로 파일 나열 (오래된 것부터): + +`eza --long --sort={{modified}}` + +- 헤더, 아이콘 및 Git 상태와 함께 파일 나열: + +`eza --long --header --icons --git` + +- `.gitignore`에 언급된 파일은 나열하지 않음: + +`eza --git-ignore` diff --git a/pages.ko/common/find.md b/pages.ko/common/find.md new file mode 100644 index 000000000..f07335376 --- /dev/null +++ b/pages.ko/common/find.md @@ -0,0 +1,36 @@ +# find + +> 디렉토리 트리 아래에서 파일 또는 폴더를 재귀적으로 찾습니다. +> 더 많은 정보: . + +- 확장자로 파일 찾기: + +`find {{루트_경로}} -name '{{*.ext}}'` + +- 여러 경로/이름 패턴에 맞는 파일 찾기: + +`find {{루트_경로}} -path '{{**/경로/**/*.ext}}' -or -name '{{*패턴*}}'` + +- 대소문자를 구분하지 않고 주어진 이름에 맞는 디렉토리 찾기: + +`find {{루트_경로}} -type d -iname '{{*lib*}}'` + +- 주어진 패턴에 맞는 파일을 특정 경로를 제외하고 찾기: + +`find {{루트_경로}} -name '{{*.py}}' -not -path '{{*/site-packages/*}}'` + +- 주어진 크기 범위에 맞는 파일을 찾고 재귀 깊이를 "1"로 제한: + +`find {{루트_경로}} -maxdepth 1 -size {{+500k}} -size {{-10M}}` + +- 각 파일에 대해 명령 실행 (명령 내에서 파일명을 액세스하려면 `{}` 사용): + +`find {{루트_경로}} -name '{{*.ext}}' -exec {{wc -l}} {} \;` + +- 오늘 수정된 모든 파일을 찾아 결과를 단일 명령에 인수로 전달: + +`find {{루트_경로}} -daystart -mtime {{-1}} -exec {{tar -cvf archive.tar}} {} \+` + +- 빈 (0 바이트) 파일을 찾아 삭제: + +`find {{루트_경로}} -type {{f}} -empty -delete` diff --git a/pages.ko/common/fossil-ci.md b/pages.ko/common/fossil-ci.md index 2f8a097f3..220ac6dda 100644 --- a/pages.ko/common/fossil-ci.md +++ b/pages.ko/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> 이 명령은 `fossil-commit` 의 에일리어스 (별칭) 입니다. +> 이 명령은 `fossil commit`.의 에일리어스 (별칭) 입니다. > 더 많은 정보: . - 원본 명령의 도큐멘테이션 (설명서) 보기: diff --git a/pages.ko/common/fossil-delete.md b/pages.ko/common/fossil-delete.md index 11e44da2e..5a6560fcd 100644 --- a/pages.ko/common/fossil-delete.md +++ b/pages.ko/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > 이 명령은 `fossil rm` 의 에일리어스 (별칭) 입니다. > 더 많은 정보: . diff --git a/pages.ko/common/fossil-forget.md b/pages.ko/common/fossil-forget.md index 059749d93..515667c21 100644 --- a/pages.ko/common/fossil-forget.md +++ b/pages.ko/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > 이 명령은 `fossil rm` 의 에일리어스 (별칭) 입니다. > 더 많은 정보: . diff --git a/pages.ko/common/fossil-new.md b/pages.ko/common/fossil-new.md index 1abd963af..82bcb8462 100644 --- a/pages.ko/common/fossil-new.md +++ b/pages.ko/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> 이 명령은 `fossil-init` 의 에일리어스 (별칭) 입니다. +> 이 명령은 `fossil init`.의 에일리어스 (별칭) 입니다. > 더 많은 정보: . - 원본 명령의 도큐멘테이션 (설명서) 보기: diff --git a/pages.ko/common/gh-cs.md b/pages.ko/common/gh-cs.md index 360393b37..f5439fcd0 100644 --- a/pages.ko/common/gh-cs.md +++ b/pages.ko/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> 이 명령은 `gh-codespace` 의 에일리어스 (별칭) 입니다. +> 이 명령은 `gh codespace`.의 에일리어스 (별칭) 입니다. > 더 많은 정보: . - 원본 명령의 도큐멘테이션 (설명서) 보기: diff --git a/pages.ko/common/git-add.md b/pages.ko/common/git-add.md index f56632a20..86f47af44 100644 --- a/pages.ko/common/git-add.md +++ b/pages.ko/common/git-add.md @@ -1,32 +1,32 @@ # git add -> 변경된 파일들을 인덱스에 추가합니다. +> 변경된 파일을 색인에 추가합니다. > 더 많은 정보: . -- 인덱스에 파일 추가: +- 파일을 색인에 추가: -`git add {{파일/의/경로}}` +`git add {{경로/대상/파일}}` -- 모든 파일 추가 (추적된 파일과 추적되지 않은 파일 모두): +- 모든 파일 추가 (추적된 파일 및 추적되지 않은 파일 모두): `git add -A` -- 이미 추적된 파일만 추가: +- 이미 추적 중인 파일만 추가: `git add -u` -- 무시되는 파일 추가: +- 무시된 파일도 추가: `git add -f` -- 파일의 일부분을 대화식으로 추가: +- 파일 일부를 대화적으로 스테이징: `git add -p` -- 주어진 파일의 일부분을 대화식으로 추가: +- 특정 파일의 일부를 대화적으로 스테이징: -`git add -p {{파일/의/경로}}` +`git add -p {{경로/대상/파일}}` -- 대화식으로 파일을 추가: +- 파일을 대화적으로 스테이징: `git add -i` diff --git a/pages.ko/common/git-bisect.md b/pages.ko/common/git-bisect.md new file mode 100644 index 000000000..2a95a0501 --- /dev/null +++ b/pages.ko/common/git-bisect.md @@ -0,0 +1,25 @@ +# git bisect + +> 버그를 도입한 커밋을 찾기 위해 이진 탐색을 사용합니다. +> Git은 자동적으로 커밋 그래프를 왔다갔다하면서 결함이 있는 커밋을 점차적으로 좁힙니다. +> 더 많은 정보: . + +- 알려진 버그가 있는 커밋과 알려진 깨끗한 (일반적으로 이전) 커밋으로 제한된 커밋 범위에서 bisect 세션 시작: + +`git bisect start {{bad_commit}} {{good_commit}}` + +- `git bisect`가 선택한 각 커밋에 대해 이슈를 테스트한 후 "good" 또는 "bad"로 표시: + +`git bisect {{good|bad}}` + +- `git bisect`가 결함이 있는 커밋을 정확히 찾으면 bisect 세션을 종료하고 이전 브랜치로 돌아가기: + +`git bisect reset` + +- bisect 중 커밋 건너뛰기 (예: 다른 이슈로 인해 테스트가 실패하는 커밋): + +`git bisect skip` + +- 지금까지 수행된 작업에 대한 로그 표시: + +`git bisect log` diff --git a/pages.ko/common/git-branch.md b/pages.ko/common/git-branch.md new file mode 100644 index 000000000..99eda5747 --- /dev/null +++ b/pages.ko/common/git-branch.md @@ -0,0 +1,36 @@ +# git branch + +> 브랜치 작업을 위한 주요 Git 명령어. +> 더 많은 정보: . + +- 모든 브랜치(로컬 및 원격; 현재 브랜치는 `*`로 강조됨) 나열: + +`git branch --all` + +- 특정 Git 커밋을 기록에 포함하는 브랜치 나열: + +`git branch --all --contains {{커밋_해시}}` + +- 현재 브랜치의 이름 표시: + +`git branch --show-current` + +- 현재 커밋을 기반으로 새로운 브랜치 생성: + +`git branch {{브랜치_이름}}` + +- 특정 커밋을 기반으로 새로운 브랜치 생성: + +`git branch {{브랜치_이름}} {{커밋_해시}}` + +- 브랜치 이름 변경 (체크아웃되지 않은 상태여야 함): + +`git branch -m {{이전_브랜치_이름}} {{새로운_브랜치_이름}}` + +- 로컬 브랜치 삭제 (체크아웃되지 않은 상태여야 함): + +`git branch -d {{브랜치_이름}}` + +- 원격 브랜치 삭제: + +`git push {{원격_이름}} --delete {{원격_브랜치_이름}}` diff --git a/pages.ko/common/git-checkout.md b/pages.ko/common/git-checkout.md new file mode 100644 index 000000000..9298bcf6a --- /dev/null +++ b/pages.ko/common/git-checkout.md @@ -0,0 +1,36 @@ +# git checkout + +> 브랜치 또는 작업 트리로 경로를 체크아웃합니다. +> 더 많은 정보: . + +- 새로운 브랜치를 생성하고 체크아웃: + +`git checkout -b {{브랜치_이름}}` + +- 특정 참조를 기반으로 새로운 브랜치를 생성하고 체크아웃 (브랜치, remote/branch, tag가 유효한 참조 예시입니다): + +`git checkout -b {{브랜치_이름}} {{참조}}` + +- 기존 로컬 브랜치로 체크아웃: + +`git checkout {{브랜치_이름}}` + +- 이전에 체크아웃한 브랜치로 체크아웃: + +`git checkout -` + +- 기존 원격 브랜치로 체크아웃: + +`git checkout --track {{원격_이름}}/{{브랜치_이름}}` + +- 현재 디렉토리에서 모든 스테이징되지 않은 변경 사항을 삭제 (더 많은 취소 유사 명령은 `git reset`을 참조하십시오): + +`git checkout .` + +- 특정 파일의 스테이징되지 않은 변경 사항 삭제: + +`git checkout {{경로/대상/파일}}` + +- 현재 디렉토리에 있는 파일을 주어진 브랜치에서 커밋된 버전으로 대체: + +`git checkout {{브랜치_이름}} -- {{경로/대상/파일}}` diff --git a/pages.ko/common/git-clone.md b/pages.ko/common/git-clone.md index b250851d9..7389d941d 100644 --- a/pages.ko/common/git-clone.md +++ b/pages.ko/common/git-clone.md @@ -1,36 +1,36 @@ # git clone -> 이미 존재하는 레포지토리를 복제. +> 기존 저장소를 복제합니다. > 더 많은 정보: . -- 이미 존재하는 레포지토리를 특정 디렉토리에 복제: +- 기존 저장소를 새 디렉토리로 복제 (기본 디렉토리는 저장소 이름): -`git clone {{원격_레포지토리_경로}} {{경로/대상/디렉터리}}` +`git clone {{원격_저장소_위치}} {{경로/대상/폴더}}` -- 이미 존재하는 레포지토리를 그 서브모듈을 복제: +- 기존 저장소 및 그 하위 모듈 복제: -`git clone --recursive {{원격_레포지토리_경로}}` +`git clone --recursive {{원격_저장소_위치}}` -- 기존 저장소의 `.git` 디렉토리를 복제: +- 기존 저장소의 `.git` 디렉토리만 복제: -`git clone --no-checkout {{원격_레포지토리_경로}}` +`git clone --no-checkout {{원격_저장소_위치}}` -- 로컬 레포지토리를 복제: +- 로컬 저장소 복제: -`git clone --local {{경로/대상/로컬/레포지토리}}` +`git clone --local {{경로/대상/로컬/저장소}}` -- 출력 없이 복제: +- 조용히 복제: -`git clone --quiet {{원격_레포지토리_경로}}` +`git clone --quiet {{원격_저장소_위치}}` -- 이미 존재하는 레포지토리를 최근 커밋 10개만 복제 (시간 절약에 좋음): +- 기존 저장소를 기본 브랜치에서 최근 커밋 10개만 복제 (시간 절약에 좋음): -`git clone --depth {{10}} {{원격_레포지토리_경로}}` +`git clone --depth {{10}} {{원격_저장소_위치}}` -- 이미 존재하는 레포지토리의 특정 브랜치만 복제: +- 기존 저장소의 특정 브랜치만 복제: -`git clone --branch {{브랜치_이름}} --single-branch {{원격_레포지토리_경로}}` +`git clone --branch {{이름}} --single-branch {{원격_저장소_위치}}` -- 특정 SSH 명령어를 사용하여 이미 존재하는 레포지토리 복제: +- 특정 SSH 명령을 사용하여 기존 저장소 복제: -`git clone --config core.sshCommand="{{ssh -i 경로/대상/개인_ssh_key}}" {{원격_레포지토리_경로}}` +`git clone --config core.sshCommand="{{ssh -i path/to/private_ssh_key}}" {{원격_저장소_위치}}` diff --git a/pages.ko/common/git-commit.md b/pages.ko/common/git-commit.md new file mode 100644 index 000000000..e1611502c --- /dev/null +++ b/pages.ko/common/git-commit.md @@ -0,0 +1,32 @@ +# git commit + +> 파일을 저장소에 커밋합니다. +> 더 많은 정보: . + +- 스테이징된 파일을 메시지와 함께 저장소에 커밋: + +`git commit --message "{{메시지}}"` + +- 파일에서 읽은 메시지로 스테이징된 파일을 저장소에 커밋: + +`git commit --file {{파일/커밋_메시지_경로}}` + +- 수정 및 삭제된 모든 파일을 자동으로 스테이징하고 메시지와 함께 커밋: + +`git commit --all --message "{{메시지}}"` + +- 스테이징된 파일을 커밋하고 지정된 GPG 키로 서명합니다 (인수가 지정되지 않은 경우 구성 파일에 정의된 키 사용): + +`git commit --gpg-sign {{키_아이디}} --message "{{메시지}}"` + +- 현재 스테이징된 변경 사항을 추가하여 마지막 커밋을 업데이트하고 커밋의 해시를 변경합니다: + +`git commit --amend` + +- 특정 파일(이미 스테이징된)만 커밋: + +`git commit {{파일/경로1}} {{파일/경로2}}` + +- 스테이징된 파일이 없더라도 커밋 생성: + +`git commit --message "{{메시지}}" --allow-empty` diff --git a/pages.ko/common/git-diff.md b/pages.ko/common/git-diff.md new file mode 100644 index 000000000..8d6000eca --- /dev/null +++ b/pages.ko/common/git-diff.md @@ -0,0 +1,36 @@ +# git diff + +> 추적된 파일의 변경 사항을 보여줍니다. +> 더 많은 정보: . + +- 스테이지되지 않은 변경 사항 표시: + +`git diff` + +- 모든 커밋되지 않은 변경 사항 표시 (스테이지된 것 포함): + +`git diff HEAD` + +- 오직 스테이지에 있는(추가되었지만 아직 커밋되지 않은) 변경 사항만 표시: + +`git diff --staged` + +- 특정 일자/시간 이후의 모든 커밋부터 변경 사항 표시 (일자 표현, 예: "1 주 2 일" 또는 ISO 일자): + +`git diff 'HEAD@{3 months|weeks|days|hours|seconds ago}'` + +- 특정 커밋 이후 변경된 파일 이름만 표시: + +`git diff --name-only {{커밋}}` + +- 특정 커밋 이후 파일 생성, 이름 변경 및 모드 변경 요약 표시: + +`git diff --summary {{커밋}}` + +- 두 브랜치 또는 커밋 사이의 단일 파일 비교: + +`git diff {{브랜치_1}}..{{브랜치_2}} [--] {{경로/대상/파일}}` + +- 현재 브랜치에서 다른 브랜치로부터 다른 파일 비교: + +`git diff {{브랜치}}:{{경로/대상/파일2}} {{경로/대상/파일}}` diff --git a/pages.ko/common/git-fetch.md b/pages.ko/common/git-fetch.md new file mode 100644 index 000000000..f65ec65cb --- /dev/null +++ b/pages.ko/common/git-fetch.md @@ -0,0 +1,24 @@ +# git fetch + +> 원격 저장소에서 객체와 참조를 다운로드합니다. +> 더 많은 정보: . + +- 기본 원격 업스트림 저장소로부터 최신 변경 사항 가져오기 (설정된 경우): + +`git fetch` + +- 특정 원격 업스트림 저장소에서 새 브랜치 가져오기: + +`git fetch {{remote_name}}` + +- 모든 원격 업스트림 저장소에서 최신 변경 사항 가져오기: + +`git fetch --all` + +- 원격 업스트림 저장소에서 태그도 함께 가져오기: + +`git fetch --tags` + +- 업스트림에서 삭제된 원격 브랜치에 대한 로컬 참조 삭제: + +`git fetch --prune` diff --git a/pages.ko/common/git-grep.md b/pages.ko/common/git-grep.md new file mode 100644 index 000000000..7014b6b24 --- /dev/null +++ b/pages.ko/common/git-grep.md @@ -0,0 +1,25 @@ +# git-grep + +> 저장소의 히스토리에서 파일 내의 문자열을 찾습니다. +> 일반 `grep`과 같은 많은 플래그를 수용합니다. +> 더 많은 정보: . + +- 추적된 파일에서 문자열 검색: + +`git grep {{검색_문자열}}` + +- 추적된 파일 중 일치하는 패턴의 파일에서 문자열 검색: + +`git grep {{검색_문자열}} -- {{파일_글로브_패턴}}` + +- 서브모듈을 포함하여 추적된 파일에서 문자열 검색: + +`git grep --recurse-submodules {{검색_문자열}}` + +- 특정 히스토리 지점에서 문자열 검색: + +`git grep {{검색_문자열}} {{HEAD~2}}` + +- 모든 브랜치에서 문자열 검색: + +`git grep {{검색_문자열}} $(git rev-list --all)` diff --git a/pages.ko/common/git-init.md b/pages.ko/common/git-init.md new file mode 100644 index 000000000..b5e9c7a0c --- /dev/null +++ b/pages.ko/common/git-init.md @@ -0,0 +1,20 @@ +# git init + +> 새로운 로컬 Git 저장소를 초기화합니다. +> 더 많은 정보: . + +- 새로운 로컬 저장소 초기화: + +`git init` + +- 초기 브랜치에 지정된 이름을 가진 저장소를 초기화: + +`git init --initial-branch={{branch_name}}` + +- 객체 해시로 SHA256를 사용하여 저장소 초기화 (Git 버전 2.29+ 이상 필요): + +`git init --object-format={{sha256}}` + +- SSH를 통해 원격으로 사용할 수 있는 베어본 저장소 초기화: + +`git init --bare` diff --git a/pages.ko/common/git-log.md b/pages.ko/common/git-log.md new file mode 100644 index 000000000..bd35c120f --- /dev/null +++ b/pages.ko/common/git-log.md @@ -0,0 +1,36 @@ +# git log + +> 커밋 이력을 보여줍니다. +> 더 많은 정보: . + +- 현재 작업 디렉토리의 Git 리포지토리에서 현재 커밋을 기준으로 역순으로 커밋 시퀀스 보기: + +`git log` + +- 변경 사항을 포함해, 특정 파일 또는 디렉토리의 이력 보기: + +`git log -p {{파일_또는_디렉토리_경로}}` + +- 각 커밋에서 어떤 파일이 변경되었는지 개요 보기: + +`git log --stat` + +- 현재 브랜치의 커밋 그래프를 첫 줄만 사용해 보기: + +`git log --oneline --graph` + +- 전체 리포지토리의 모든 커밋, 태그 및 브랜치의 그래프 보기: + +`git log --oneline --decorate --all --graph` + +- 특정 문자열이 포함된 커밋 메시지만 보기 (대소문자 구분 없이): + +`git log -i --grep {{검색_문자열}}` + +- 특정 작성자의 마지막 N개의 커밋 보기: + +`git log -n {{개수}} --author={{작성자}}` + +- 두 날짜(yyyy-mm-dd) 사이의 커밋 보기: + +`git log --before="{{2017-01-29}}" --after="{{2017-01-17}}"` diff --git a/pages.ko/common/git-merge.md b/pages.ko/common/git-merge.md new file mode 100644 index 000000000..3b67d1485 --- /dev/null +++ b/pages.ko/common/git-merge.md @@ -0,0 +1,24 @@ +# git merge + +> 브랜치를 병합합니다. +> 더 많은 정보: . + +- 현재 브랜치에 브랜치 병합: + +`git merge {{브랜치_이름}}` + +- 병합 메시지 편집: + +`git merge --edit {{브랜치_이름}}` + +- 브랜치 병합 및 병합 커밋 생성: + +`git merge --no-ff {{브랜치_이름}}` + +- 충돌이 발생한 경우 병합 중단: + +`git merge --abort` + +- 특정 전략을 사용하여 병합: + +`git merge --strategy {{전략}} --strategy-option {{전략_옵션}} {{브랜치_이름}}` diff --git a/pages.ko/common/git-mv.md b/pages.ko/common/git-mv.md new file mode 100644 index 000000000..3939e8ddb --- /dev/null +++ b/pages.ko/common/git-mv.md @@ -0,0 +1,16 @@ +# git mv + +> 파일을 이동하거나 이름을 변경하고 Git 인덱스를 업데이트합니다. +> 더 많은 정보: . + +- 파일을 저장소 내에서 이동하고 해당 이동을 다음 커밋에 추가: + +`git mv {{경로/대상/파일}} {{새/경로/대상/파일}}` + +- 파일 또는 디렉토리의 이름을 변경하고 해당 변경 사항을 다음 커밋에 추가: + +`git mv {{경로/대상/파일_또는_디렉토리}} {{경로/대상/목적지}}` + +- 대상 경로에 파일 또는 디렉토리가 이미 존재하는 경우 덮어쓰기: + +`git mv --force {{경로/대상/파일_또는_디렉토리}} {{경로/대상/목적지}}` diff --git a/pages.ko/common/git-pull.md b/pages.ko/common/git-pull.md new file mode 100644 index 000000000..9d12ac438 --- /dev/null +++ b/pages.ko/common/git-pull.md @@ -0,0 +1,16 @@ +# git pull + +> 원격 저장소에서 브랜치를 가져와 로컬 저장소에 병합합니다. +> 더 많은 정보: . + +- 기본 원격 저장소에서 변경 사항 다운로드 및 병합: + +`git pull` + +- 기본 원격 저장소에서 변경 사항 다운로드 후 패스트-포워드 사용: + +`git pull --rebase` + +- 지정된 원격 저장소와 브랜치에서 변경 사항 다운로드 후 다음 HEAD에 병합: + +`git pull {{원격_이름}} {{브랜치}}` diff --git a/pages.ko/common/git-push.md b/pages.ko/common/git-push.md new file mode 100644 index 000000000..4600c2422 --- /dev/null +++ b/pages.ko/common/git-push.md @@ -0,0 +1,36 @@ +# git push + +> 로컬 커밋을 원격 저장소로 푸시합니다. +> 더 많은 정보: . + +- 현재 브랜치의 로컬 변경 사항을 기본 원격 상대 브랜치에 보내기: + +`git push` + +- 특정 로컬 브랜치에서 해당 원격 상대 브랜치로 변경 사항 보내기: + +`git push {{원격_이름}} {{로컬_브랜치}}` + +- 특정 로컬 브랜치에서 해당 원격 상대 브랜치로 변경 사항을 보내고, 원격 브랜치를 로컬 브랜치의 기본 푸시/풀 대상으로 설정: + +`git push -u {{원격_이름}} {{로컬_브랜치}}` + +- 특정 로컬 브랜치에서 특정 원격 브랜치로 변경 사항 보내기: + +`git push {{원격_이름}} {{로컬_브랜치}}:{{원격_브랜치}}` + +- 모든 로컬 브랜치의 변경 사항을 주어진 원격 저장소의 상대 브랜치로 보내기: + +`git push --all {{원격_이름}}` + +- 원격 저장소에서 브랜치 삭제: + +`git push {{원격_이름}} --delete {{원격_브랜치}}` + +- 로컬과 대응되는 원격 브랜치가 없는 원격 브랜치 제거: + +`git push --prune {{원격_이름}}` + +- 아직 원격 저장소에 없는 태그 게시: + +`git push --tags` diff --git a/pages.ko/common/git-rebase.md b/pages.ko/common/git-rebase.md new file mode 100644 index 000000000..9259cf429 --- /dev/null +++ b/pages.ko/common/git-rebase.md @@ -0,0 +1,37 @@ +# git rebase + +> 다른 브랜치 위에 있는 커밋을 다시 적용합니다. +> 주로 전체 브랜치를 다른 기저로 "이동"하여 새 위치에 커밋의 복사본을 만들 때 사용됩니다. +> 더 많은 정보: . + +- 현재 브랜치를 다른 지정된 브랜치 위에 리베이스: + +`git rebase {{새_기저_브랜치}}` + +- 커밋을 재배치, 생략, 결합 또는 수정할 수 있도록 하는 대화형 리베이스 시작: + +`git rebase -i {{대상_기저_브랜치_또는_커밋_해시}}` + +- 충돌하는 파일 편집 후, 병합 실패로 중단된 리베이스 계속하기: + +`git rebase --continue` + +- 충돌이 발생한 커밋을 건너뛸 때, 병합 충돌로 일시 중지된 리베이스를 건너뛰어서 계속하기: + +`git rebase --skip` + +- 진행 중인 리베이스 중단 (예: 병합 충돌로 인해 중단된 경우): + +`git rebase --abort` + +- 시작할 수 있는 오래된 베이스 제공 및 현재 브랜치 일부를 새 베이스로 이동: + +`git rebase --onto {{새_기저}} {{이전_기저}}` + +- 마지막 5개의 커밋을 그대로 다시 적용해, 재배치, 생략, 결합 또는 수정할 수 있도록 멈추기: + +`git rebase -i {{HEAD~5}}` + +- 작업 브랜치 버전을 우선하는 방식으로 모든 충돌을 자동으로 해결 (`theirs` 키워드는 이 경우 반대 의미를 갖습니다): + +`git rebase -X theirs {{브랜치_이름}}` diff --git a/pages.ko/common/git-reset.md b/pages.ko/common/git-reset.md new file mode 100644 index 000000000..b2f590b21 --- /dev/null +++ b/pages.ko/common/git-reset.md @@ -0,0 +1,33 @@ +# git reset + +> 현재 Git HEAD를 지정된 상태로 재설정하여 커밋을 취소하거나 변경 사항의 스테이징을 취소합니다. +> 경로가 전달되면 "스테이징 해제"로 작동하고, 커밋 해시 또는 브랜치가 전달되면 "커밋 취소"로 작동합니다. +> 더 많은 정보: . + +- 모두 스테이징 해제: + +`git reset` + +- 특정 파일의 스테이징 해제: + +`git reset {{경로/대상/파일1 경로/대상/파일2 ...}}` + +- 파일 일부를 대화식으로 스테이징 해제: + +`git reset --patch {{경로/대상/파일}}` + +- 마지막 커밋을 취소하되 해당 변경 사항을 (그리고 추가로 커밋되지 않은 변경 사항들도) 파일 시스템에 유지: + +`git reset HEAD~` + +- 마지막 두 개의 커밋을 취소하고 해당 변경 사항을 인덱스에 추가하여 커밋할 준비 완료: + +`git reset --soft HEAD~2` + +- 커밋되지 않은 변경 사항을 모두 무시하고, staged 또는 unstaged 상태에 상관없이 삭제 (오직 unstaged 변경 사항인 경우 `git checkout` 사용): + +`git reset --hard` + +- 지정된 커밋으로 저장소를 재설정하여 해당 이후에 발생한 커밋, 스테이징 및 커밋되지 않은 변경 사항을 모두 삭제: + +`git reset --hard {{커밋}}` diff --git a/pages.ko/common/git-restore.md b/pages.ko/common/git-restore.md new file mode 100644 index 000000000..1b32029be --- /dev/null +++ b/pages.ko/common/git-restore.md @@ -0,0 +1,33 @@ +# git restore + +> 작업 트리 파일을 복원합니다. Git 버전 2.23+ 이상이 필요합니다. +> 같이 보기: `git checkout` 및 `git reset`. +> 더 많은 정보: . + +- 언스테이지된 파일을 현재 커밋 (HEAD)의 버전으로 복원: + +`git restore {{경로/대상/파일}}` + +- 언스테이지된 파일을 특정 커밋의 버전으로 복원: + +`git restore --source {{커밋}} {{경로/대상/파일}}` + +- 추적 중인 파일에 대한 모든 언스테이지된 변경 사항을 폐기: + +`git restore :/` + +- 파일의 스테이지를 내리기: + +`git restore --staged {{경로/대상/파일}}` + +- 모든 파일의 스테이지를 내리기: + +`git restore --staged :/` + +- 스테이지 및 언스테이지된 파일의 모든 변경 사항 폐기: + +`git restore --worktree --staged :/` + +- 파일의 섹션을 대화적으로 선택하여 복원: + +`git restore --patch` diff --git a/pages.ko/common/git-rm.md b/pages.ko/common/git-rm.md new file mode 100644 index 000000000..2c9da337c --- /dev/null +++ b/pages.ko/common/git-rm.md @@ -0,0 +1,16 @@ +# git rm + +> 저장소 인덱스와 로컬 파일 시스템에서 파일을 제거합니다. +> 더 많은 정보: . + +- 저장소 인덱스와 파일 시스템에서 파일 제거: + +`git rm {{경로/대상/파일}}` + +- 디렉토리 제거: + +`git rm -r {{경로/대상/폴더}}` + +- 저장소 인덱스에서 파일 제거하되 로컬에서는 그대로 유지: + +`git rm --cached {{경로/대상/파일}}` diff --git a/pages.ko/common/git-show.md b/pages.ko/common/git-show.md new file mode 100644 index 000000000..624d2c577 --- /dev/null +++ b/pages.ko/common/git-show.md @@ -0,0 +1,36 @@ +# git show + +> 다양한 종류의 Git 객체 (커밋, 태그 등)을 표시합니다. +> 더 많은 정보: . + +- 최신 커밋에 대한 정보 표시 (해시, 메시지, 변경 사항 및 기타 메타데이터): + +`git show` + +- 특정 커밋에 대한 정보 표시: + +`git show {{커밋}}` + +- 특정 태그와 관련된 커밋에 대한 정보 표시: + +`git show {{태그}}` + +- 브랜치의 HEAD로부터 3번째 커밋에 대한 정보 표시: + +`git show {{브랜치}}~{{3}}` + +- 커밋 메시지를 한 줄로 표시하고 diff 출력을 억제: + +`git show --oneline -s {{커밋}}` + +- 변경된 파일에 대한 추가/제거된 문자의 통계만 표시: + +`git show --stat {{커밋}}` + +- 추가, 이름 변경 또는 삭제된 파일 목록만 표시: + +`git show --summary {{커밋}}` + +- 파일의 내용을 특정 리비전 (예: 브랜치, 태그 또는 커밋)에서 표시: + +`git show {{리비전}}:{{경로/대상/파일}}` diff --git a/pages.ko/common/git-status.md b/pages.ko/common/git-status.md new file mode 100644 index 000000000..4c6573fe3 --- /dev/null +++ b/pages.ko/common/git-status.md @@ -0,0 +1,29 @@ +# git status + +> Git 저장소의 파일 변경 사항을 표시합니다. +> 현재 체크아웃된 커밋과 비교하여 변경된, 추가된 및 삭제된 파일을 나열합니다. +> 더 많은 정보: . + +- 커밋할 파일로 아직 추가되지 않은 변경된 파일 보기: + +`git status` + +- [s]hort 형식으로 출력: + +`git status --short` + +- [b]ranch 및 추적 정보 표시: + +`git status --branch` + +- [s]hort 형식으로 출력하면서 [b]ranch 정보 표시: + +`git status --short --branch` + +- 현재 숨겨둔 엔트리의 수 표시: + +`git status --show-stash` + +- 출력에 추적되지 않는 파일을 표시하지 않기: + +`git status --untracked-files=no` diff --git a/pages.ko/common/git-switch.md b/pages.ko/common/git-switch.md new file mode 100644 index 000000000..5e253d3bd --- /dev/null +++ b/pages.ko/common/git-switch.md @@ -0,0 +1,29 @@ +# git switch + +> Git 브랜치 간 전환합니다. Git 버전 2.23+가 필요합니다. +> 같이 보기: `git checkout`. +> 더 많은 정보: . + +- 기존 브랜치로 전환: + +`git switch {{브랜치_이름}}` + +- 새 브랜치를 만들고 전환: + +`git switch --create {{브랜치_이름}}` + +- 기존 커밋을 기반으로 새 브랜치를 만들고 전환: + +`git switch --create {{브랜치_이름}} {{커밋}}` + +- 이전 브랜치로 전환: + +`git switch -` + +- 브랜치로 전환하고 모든 서브모듈을 일치하도록 업데이트: + +`git switch --recurse-submodules {{브랜치_이름}}` + +- 브랜치로 전환하고 현재 브랜치와 미커밋된 변경 사항을 자동으로 병합: + +`git switch --merge {{브랜치_이름}}` diff --git a/pages.ko/common/git-tag.md b/pages.ko/common/git-tag.md new file mode 100644 index 000000000..169d18d4d --- /dev/null +++ b/pages.ko/common/git-tag.md @@ -0,0 +1,33 @@ +# git tag + +> 태그를 생성하거나 나열하거나 삭제하거나 확인합니다. +> 태그는 커밋에 대한 정적 참조입니다. +> 더 많은 정보: . + +- 모든 태그 나열: + +`git tag` + +- 주어진 이름을 가진 태그를 현재 커밋을 가리키도록 생성: + +`git tag {{태그_이름}}` + +- 주어진 이름을 가진 태그를 주어진 커밋을 가리키도록 생성: + +`git tag {{태그_이름}} {{커밋}}` + +- 주어진 메시지로 주석이 달린 태그를 생성: + +`git tag {{태그_이름}} -m {{태그_메시지}}` + +- 주어진 이름을 가진 태그를 삭제: + +`git tag -d {{태그_이름}}` + +- 업스트림에서 업데이트된 태그 가져오기: + +`git fetch --tags` + +- 특정 커밋을 조상으로 포함하는 모든 태그 나열: + +`git tag --contains {{커밋}}` diff --git a/pages.ko/common/gnmic-sub.md b/pages.ko/common/gnmic-sub.md index 5ef6a777d..6811f321d 100644 --- a/pages.ko/common/gnmic-sub.md +++ b/pages.ko/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > 이 명령은 `gnmic subscribe` 의 에일리어스 (별칭) 입니다. > 더 많은 정보: . diff --git a/pages.ko/common/grep.md b/pages.ko/common/grep.md index b2564a0b5..83c69c22b 100644 --- a/pages.ko/common/grep.md +++ b/pages.ko/common/grep.md @@ -9,28 +9,28 @@ - 정규표현식을 사용하지 않고 정확히 일치하는 문자열 검색: -`grep --fixed-strings "{{문자열}}" {{파일/의/경로}}` +`grep {{-F|--fixed-strings}} "{{문자열}}" {{파일/의/경로}}` - 재귀적으로 디렉토리 안의 바이너리 파일을 제외한 모든 파일 안에서 패턴을 검색하고, 일치하는 줄의 번호를 보여줌: -`grep --recursive --line-number --binary-files={{without-match}} "{{검색_패턴}}" {{디렉토리/의/경로}}` +`grep {{-r|--recursive}} {{-n|--line-number}} --binary-files={{without-match}} "{{검색_패턴}}" {{디렉토리/의/경로}}` - 대소문자를 구분하지 않는 모드에서 확장된 정규표현식 사용 (`?`, `+`, `{}`, `()` 그리고 `|` 를 지원): -`grep --extended-regexp --ignore-case "{{검색_패턴}}" {{파일/의/경로}}` +`grep {{-E|--extended-regexp}} {{-i|--ignore-case}} "{{검색_패턴}}" {{파일/의/경로}}` - 일치하는 문자열 주변, 이전 혹은 이후의 3줄을 출력: -`grep --{{context|before-context|after-context}}={{3}} "{{검색_패턴}}" {{파일/의/경로}}` +`grep --{{context|before-context|after-context}} 3 "{{검색_패턴}}" {{파일/의/경로}}` - 각각의 일치하는 문자열의 파일 이름과 줄 번호 출력: -`grep --with-filename --line-number --color=always "{{검색_패턴}}" {{파일/의/경로}}` +`grep {{-H|--with-filename}} {{-n|--line-number}} --color=always "{{검색_패턴}}" {{파일/의/경로}}` - 패턴과 일치하는 줄을 검색하고, 일치하는 문자만 출력: -`grep --only-matching "{{검색_패턴}}" {{파일/의/경로}}` +`grep {{-o|--only-matching}} "{{검색_패턴}}" {{파일/의/경로}}` - 패턴과 일치하지 않는 라인에 대한 `stdin` 검색: -`cat {{파일/의/경로}} | grep --invert-match "{{검색_패턴}}"` +`cat {{파일/의/경로}} | grep {{-v|--invert-match}} "{{검색_패턴}}"` diff --git a/pages.ko/common/magick-convert.md b/pages.ko/common/magick-convert.md new file mode 100644 index 000000000..2c5f0e560 --- /dev/null +++ b/pages.ko/common/magick-convert.md @@ -0,0 +1,32 @@ +# magick convert + +> ImageMagick 이미지 변환 도구. +> 더 많은 정보: . + +- JPG이미지를 PNG이미지로 변환: + +`magick convert {{이미지.jpg}} {{이미지.png}}` + +- 이미지를 원래 크기의 50%로 조정: + +`magick convert {{이미지.png}} -resize 50% {{이미지2.png}}` + +- 원래 종횡비를 유지하면서 이미지를 최대 640x480 크기로 조정: + +`magick convert {{이미지.png}} -resize 640x480 {{이미지2.png}}` + +- 이미지를 가로로 추가: + +`magick convert {{이미지1.png}} {{이미지2.png}} {{이미지3.png}} +append {{이미지123.png}}` + +- 이미지를 세로로 추가: + +`magick convert {{이미지1.png}} {{이미지2.png}} {{이미지3.png}} -append {{이미지123.png}}` + +- 100ms 지연된 일련의 이미지에서 GIF 만들기: + +`magick convert {{이미지1.png}} {{이미지2.png}} {{이미지3.png}} -delay {{100}} {{애니메이션.gif}}` + +- 단색 배경만으로 이미지 만들기: + +`magick convert -size {{800x600}} "xc:{{#ff0000}}" {{이미지.png}}` diff --git a/pages.ko/common/man.md b/pages.ko/common/man.md index 50319127e..f91ca96af 100644 --- a/pages.ko/common/man.md +++ b/pages.ko/common/man.md @@ -1,7 +1,7 @@ # man > 설명서 페이지 형식 지정 및 표시. -> 더 많은 정보: . +> 더 많은 정보: . - 명령에 대한 설명서 페이지를 표시: diff --git a/pages.ko/common/mkdir.md b/pages.ko/common/mkdir.md new file mode 100644 index 000000000..eea94affb --- /dev/null +++ b/pages.ko/common/mkdir.md @@ -0,0 +1,16 @@ +# mkdir + +> 디렉토리를 생성하고 해당 권한을 설정합니다. +> 더 많은 정보: . + +- 특정 디렉토리 생성: + +`mkdir {{경로/대상/폴더1 경로/대상/폴더2 ...}}` + +- 필요시 특정 디렉토리와 그 [상위] 디렉토리를 생성: + +`mkdir -p {{경로/대상/폴더1 경로/대상/폴더2 ...}}` + +- 특정 권한으로 디렉토리 생성: + +`mkdir -m {{rwxrw-r--}} {{경로/대상/폴더1 경로/대상/폴더2 ...}}` diff --git a/pages.ko/common/mv.md b/pages.ko/common/mv.md new file mode 100644 index 000000000..dfa761b5d --- /dev/null +++ b/pages.ko/common/mv.md @@ -0,0 +1,32 @@ +# mv + +> 파일 및 디렉토리를 이동하거나 이름을 변경합니다. +> 더 많은 정보: . + +- 대상이 기존 디렉토리가 아닌 경우 파일 또는 디렉토리 이름 변경: + +`mv {{경로/대상/원본}} {{경로/대상/목표}}` + +- 파일 또는 디렉토리를 기존 디렉토리로 이동: + +`mv {{경로/대상/원본}} {{경로/대상/기존_폴더}}` + +- 여러 파일을 기존 디렉토리로 이동하고 파일 이름은 그대로 유지: + +`mv {{경로/대상/원본1 경로/대상/원본2 ...}} {{경로/대상/기존_폴더}}` + +- 기존 파일을 덮어쓸 때 확인하지 않음: + +`mv -f {{경로/대상/원본}} {{경로/대상/목표}}` + +- 파일 권한과 관계없이 기존 파일을 덮어쓸 때 확인을 요청: + +`mv -i {{경로/대상/원본}} {{경로/대상/목표}}` + +- 대상 위치에 기존 파일이 있을 경우 덮어쓰지 않음: + +`mv -n {{경로/대상/원본}} {{경로/대상/목표}}` + +- 파일을 이동한 후에 파일을 표시하는 자세한 모드로 이동: + +`mv -v {{경로/대상/원본}} {{경로/대상/목표}}` diff --git a/pages.ko/common/nc.md b/pages.ko/common/nc.md index 92be38e43..a5c222d4c 100644 --- a/pages.ko/common/nc.md +++ b/pages.ko/common/nc.md @@ -1,7 +1,7 @@ # nc > Netcat은 TCP 또는 UDP 데이터 작업을 위한 다목적 유틸리티입니다. -> 더 많은 정보: . +> 더 많은 정보: . - 특정 포트에서 수신대기 및 수신한 데이터 출력: diff --git a/pages.ko/common/netstat.md b/pages.ko/common/netstat.md index 2b827ea27..370f4bb92 100644 --- a/pages.ko/common/netstat.md +++ b/pages.ko/common/netstat.md @@ -1,7 +1,7 @@ # netstat > 열린 연결 및 소켓 포트 등과 같은 네트워크 관련 정보를 표시합니다. -> 더 많은 정보: . +> 더 많은 정보: . - 모든 포트 나열: diff --git a/pages.ko/common/pio-init.md b/pages.ko/common/pio-init.md index 7f6a71a1f..d58d78e1a 100644 --- a/pages.ko/common/pio-init.md +++ b/pages.ko/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > 이 명령은 `pio project` 의 에일리어스 (별칭) 입니다. diff --git a/pages.ko/common/pkill.md b/pages.ko/common/pkill.md index 41c78f5b6..3d3ba361e 100644 --- a/pages.ko/common/pkill.md +++ b/pages.ko/common/pkill.md @@ -2,7 +2,7 @@ > 프로세스 이름에 따라 시그널을 전송합니다. > 주로 프로세스를 종료하는데 사용합니다. -> 더 많은 정보: . +> 더 많은 정보: . - 일치하는 모든 프로세스 종료: diff --git a/pages.ko/common/rmdir.md b/pages.ko/common/rmdir.md new file mode 100644 index 000000000..d7008f8e9 --- /dev/null +++ b/pages.ko/common/rmdir.md @@ -0,0 +1,13 @@ +# rmdir + +> 파일이 없는 디렉토리를 제거합니다. +> 같이 보기: `rm`. +> 더 많은 정보: . + +- 특정 디렉토리 제거: + +`rmdir {{경로/대상/폴더1 경로/대상/폴더2 ...}}` + +- 특정 중첩 디렉토리를 재귀적으로 제거: + +`rmdir -p {{경로/대상/폴더1 경로/대상/폴더2 ...}}` diff --git a/pages.ko/common/rsync.md b/pages.ko/common/rsync.md index 40dd7c9ad..ca97b0357 100644 --- a/pages.ko/common/rsync.md +++ b/pages.ko/common/rsync.md @@ -10,28 +10,28 @@ - 아카이브 모드 (디렉토리를 반복적으로 복사하고, 권한, 소유권, 수정 시간을 확인 및 보존하지 않고 심볼릭 링크를 복사) 사용: -`rsync --archive {{경로/대상/소스}} {{경로/대상/목적지}}` +`rsync {{-a|--archive}} {{경로/대상/소스}} {{경로/대상/목적지}}` - 데이터가 대상으로 전송될 때 압축하고, 사람이 읽을 수 있는 자세한 진행 상황을 표시하고, 중단된 경우 부분적으로 전송된 파일 유지: -`rsync --compress --verbose --human-readable --partial --progress {{경로/대상/소스}} {{경로/대상/목적지}}` +`rsync {{-zvhP|--compress --verbose --human-readable --partial --progress}} {{경로/대상/소스}} {{경로/대상/목적지}}` - 반복적으로 폴더 복사: -`rsync --recursive {{경로/대상/소스}} {{경로/대상/목적지}}` +`rsync {{-r|--recursive}} {{경로/대상/소스}} {{경로/대상/목적지}}` - 디렉터리 내용을 전송하지만, 디렉터리 자체는 전송하지 않음: -`rsync --recursive {{경로/대상/소스}}/ {{경로/대상/목적지}}` +`rsync {{-r|--recursive}} {{경로/대상/소스}}/ {{경로/대상/목적지}}` - 디렉토리를 반복적으로 복사하고, 아카이브 모드를 사용하고, 심볼릭 링크를 확인하고, 대상에 있는 최신 파일을 건너뜀: -`rsync --archive --update --copy-links {{경로/대상/소스}} {{경로/대상/목적지}}` +`rsync {{-auL|--archive --update --copy-links}} {{경로/대상/소스}} {{경로/대상/목적지}}` - `rsyncd`를 실행하는 원격 호스트로 폴더를 전송하고 소스에 존재하지 않는 대상의 파일으 삭제: -`rsync --recursive --delete rsync://{{호스트}}:{{경로/대상/소스}} {{경로/대상/목적지}}` +`rsync {{-r|--recursive}} --delete rsync://{{호스트}}:{{경로/대상/소스}} {{경로/대상/목적지}}` - 기본값(22)이 아닌 다른 포트를 사용하여 SSH를 통해 파일을 전송하고 전체적인 진행 상황을 표시: -`rsync --rsh 'ssh -p {{port}}' --info=progress2 {{호스트}}:{{경로/대상/소스}} {{경로/대상/목적지}}` +`rsync {{-e|--rsh}} 'ssh -p {{port}}' --info=progress2 {{호스트}}:{{경로/대상/소스}} {{경로/대상/목적지}}` diff --git a/pages.ko/common/sed.md b/pages.ko/common/sed.md index 50d7cb991..63ffca97f 100644 --- a/pages.ko/common/sed.md +++ b/pages.ko/common/sed.md @@ -2,7 +2,7 @@ > 스크립트 가능한 방식으로 텍스트 편집. > 함께 보기: `awk`, `ed`. -> 더 많은 정보: . +> 더 많은 정보: . - 모든 입력 줄에서 모든 `apple`(기본 정규식)항목을 `mango`(기본 정규식)로 바꾸고 결과를 `stdout`에 출력: diff --git a/pages.ko/common/tlmgr-arch.md b/pages.ko/common/tlmgr-arch.md index fac7928e8..b8258c20f 100644 --- a/pages.ko/common/tlmgr-arch.md +++ b/pages.ko/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > 이 명령은 `tlmgr platform` 의 에일리어스 (별칭) 입니다. > 더 많은 정보: . diff --git a/pages.ko/common/touch.md b/pages.ko/common/touch.md new file mode 100644 index 000000000..4593e8741 --- /dev/null +++ b/pages.ko/common/touch.md @@ -0,0 +1,20 @@ +# touch + +> 파일을 생성하고 접근/수정 시간을 설정합니다. +> 더 많은 정보: . + +- 특정 파일 생성: + +`touch {{경로/대상/파일1 경로/대상/파일2 ...}}` + +- 파일의 [a]ccess 또는 [m]odification 시간을 현재 시간으로 설정하고 파일이 없으면 [c]reate 하지 않음: + +`touch -c -{{a|m}} {{경로/대상/파일1 경로/대상/파일2 ...}}` + +- 파일의 [t]ime을 특정 값으로 설정하고 파일이 없으면 [c]reate 하지 않음: + +`touch -c -t {{YYYYMMDDHHMM.SS}} {{경로/대상/파일1 경로/대상/파일2 ...}}` + +- 파일의 타임스탬프를 [r]eference 파일의 타임스탬프로 설정하고 파일이 없으면 [c]reate 하지 않음: + +`touch -c -r {{경로/대상/참조_파일}} {{경로/대상/파일1 경로/대상/파일2 ...}}` diff --git a/pages.ko/common/virsh.md b/pages.ko/common/virsh.md index 398a9fc4c..3a91740c8 100644 --- a/pages.ko/common/virsh.md +++ b/pages.ko/common/virsh.md @@ -2,7 +2,7 @@ > virsh 게스트 도메인을 관리합니다. (Note: 'guest_id'는 게스트의 아이디, 이름 또는 UUID일 수 있습니다). > `virsh list`와 같은 일부 하위 명령에는 자체 사용 설명서가 있습니다. -> 더 많은 정보: . +> 더 많은 정보: . - 하이퍼아비저 세션에 연결: diff --git a/pages.ko/common/webpack.md b/pages.ko/common/webpack.md index 2b3a82211..7220fa1a9 100644 --- a/pages.ko/common/webpack.md +++ b/pages.ko/common/webpack.md @@ -7,7 +7,7 @@ `webpack {{app.js}} {{bundle.js}}` -- 자바스크립트 파일에서도 CSS 파일을 로드 (이 경우 `.css` 파일에 CSS 로더를 사용합니다): +- 자바스크립트 파일에서도 CSS 파일을 로드 (이 경우 CSS 파일에 CSS 로더를 사용합니다): `webpack {{app.js}} {{bundle.js}} --module-bind '{{css=css}}'` diff --git a/pages.ko/freebsd/cal.md b/pages.ko/freebsd/cal.md new file mode 100644 index 000000000..243717689 --- /dev/null +++ b/pages.ko/freebsd/cal.md @@ -0,0 +1,32 @@ +# cal + +> 현재 날짜가 강조된 달력을 표시합니다. +> 더 많은 정보: . + +- 현재 월의 달력 표시: + +`cal` + +- 특정 연도의 달력 표시: + +`cal {{연도}}` + +- 특정 월과 연도의 달력 표시: + +`cal {{월}} {{연도}}` + +- 현재 연도의 전체 달력 표시: + +`cal -y` + +- 오늘을 강조하지 않고 날짜를 중심으로 [3]개월 표시: + +`cal -h -3 {{월}} {{연도}}` + +- 현재 연도의 특정 월의 이전 2개월과 이후 3개월 표시: + +`cal -A 3 -B 2 {{월}}` + +- 율리우스력 날짜 표시 (1부터 시작하여 1월 1일부터 번호 매김): + +`cal -j` diff --git a/pages.ko/freebsd/chfn.md b/pages.ko/freebsd/chfn.md new file mode 100644 index 000000000..a5c7ea69b --- /dev/null +++ b/pages.ko/freebsd/chfn.md @@ -0,0 +1,7 @@ +# chfn + +> 이 명령어는 `chpass`의 에일리어스 (별칭) 입니다. + +- 원본 명령의 도큐멘테이션 (설명서) 보기: + +`tldr chpass` diff --git a/pages.ko/freebsd/chpass.md b/pages.ko/freebsd/chpass.md new file mode 100644 index 000000000..35922724b --- /dev/null +++ b/pages.ko/freebsd/chpass.md @@ -0,0 +1,33 @@ +# chpass + +> 사용자 데이터베이스 정보, 로그인 쉘 및 비밀번호를 추가하거나 변경합니다. +> 같이 보기: `passwd`. +> 더 많은 정보: . + +- 현재 사용자의 사용자 데이터베이스 정보를 대화식으로 추가하거나 변경: + +`su -c chpass` + +- 현재 사용자의 로그인 쉘 설정: + +`chpass -s {{경로/대상/쉘}}` + +- 특정 사용자의 로그인 쉘 설정: + +`chpass -s {{경로/대상/쉘}} {{사용자명}}` + +- 계정 만료 시간 변경 (에포크로부터 초 단위, UTC): + +`su -c 'chpass -e {{시간}} {{사용자명}}'` + +- 사용자 비밀번호 변경: + +`su -c 'chpass -p {{암호화된_비밀번호}} {{사용자명}}'` + +- 조회할 NIS 서버의 호스트명 또는 주소 지정: + +`su -c 'chpass -h {{호스트명}} {{사용자명}}'` + +- 특정 NIS 도메인 지정 (기본값은 시스템 도메인 이름): + +`su -c 'chpass -d {{도메인}} {{사용자명}}'` diff --git a/pages.ko/freebsd/chsh.md b/pages.ko/freebsd/chsh.md new file mode 100644 index 000000000..fcd121523 --- /dev/null +++ b/pages.ko/freebsd/chsh.md @@ -0,0 +1,7 @@ +# chsh + +> 이 명령어는 `chpass`의 에일리어스 (별칭) 입니다. + +- 원본 명령의 도큐멘테이션 (설명서) 보기: + +`tldr chpass` diff --git a/pages.ko/freebsd/df.md b/pages.ko/freebsd/df.md new file mode 100644 index 000000000..3fac998ad --- /dev/null +++ b/pages.ko/freebsd/df.md @@ -0,0 +1,32 @@ +# df + +> 파일 시스템 디스크 공간 사용량 개요를 표시합니다. +> 더 많은 정보: . + +- 512바이트 단위로 모든 파일 시스템과 디스크 사용량 표시: + +`df` + +- [h]uman-readable(1024의 거듭제곱에 기반한) 단위를 사용해 총합 표시: + +`df -h -c` + +- [H]uman-readable(1000의 거듭제곱에 기반한) 단위 사용: + +`df -{{-si|H}}` + +- 주어진 파일 또는 디렉토리를 포함하는 파일 시스템 및 디스크 사용량 표시: + +`df {{경로/대상/파일_또는_폴더}}` + +- [i]노드의 수 및 사용된 노드 수를 포함해 파일 시스템 [T]ypes에 대한 통계 포함: + +`df -iT` + +- 공간 값을 쓸 때 1024바이트 단위 사용하기: + +`df -k` + +- [P]ortable한 방식으로 정보 표시: + +`df -P` diff --git a/pages.ko/freebsd/look.md b/pages.ko/freebsd/look.md new file mode 100644 index 000000000..20761a7c6 --- /dev/null +++ b/pages.ko/freebsd/look.md @@ -0,0 +1,21 @@ +# look + +> 정렬된 파일에서 접두사로 시작하는 줄을 표시합니다. +> 같이 보기: `grep`, `sort`. +> 더 많은 정보: . + +- 특정 파일에서 특정 접두사로 시작하는 줄을 검색: + +`look {{접두사}} {{경로/대상/파일}}` + +- 알파벳과 숫자만 대소문자를 구분하지 않고 검색: + +`look {{-f|--ignore-case}} {{-d|--alphanum}} {{접두사}} {{경로/대상/파일}}` + +- 종결 문자 지정 (기본값은 공백): + +`look {{-t|--terminate}} {{,}}` + +- `/usr/share/dict/words`에서 검색 (`--ignore-case` 및 `--alphanum`이 가정됨): + +`look {{접두사}}` diff --git a/pages.ko/freebsd/pkg.md b/pages.ko/freebsd/pkg.md new file mode 100644 index 000000000..3c485778c --- /dev/null +++ b/pages.ko/freebsd/pkg.md @@ -0,0 +1,28 @@ +# pkg + +> FreeBSD 패키지 관리자입니다. +> 더 많은 정보: . + +- 새 패키지 설치: + +`pkg install {{패키지}}` + +- 패키지 삭제: + +`pkg delete {{패키지}}` + +- 모든 패키지 업그레이드: + +`pkg upgrade` + +- 패키지 검색: + +`pkg search {{키워드}}` + +- 설치된 패키지 목록: + +`pkg info` + +- 필요없는 의존성 제거: + +`pkg autoremove` diff --git a/pages.ko/freebsd/sed.md b/pages.ko/freebsd/sed.md new file mode 100644 index 000000000..a35203a8a --- /dev/null +++ b/pages.ko/freebsd/sed.md @@ -0,0 +1,29 @@ +# sed + +> 스크립트로 텍스트를 편집합니다. +> 같이 보기: `awk`, `ed`. +> 더 많은 정보: . + +- 모든 입력 라인에서 `apple` (기본 정규표현식)을 `mango` (기본 정규표현식)로 대체하고 결과를 `stdout`에 인쇄: + +`{{명령}} | sed 's/apple/mango/g'` + +- 특정 스크립트 [f]파일을 실행하고 결과를 `stdout`에 인쇄: + +`{{명령}} | sed -f {{경로/대상/스크립트.sed}}` + +- 관련 `w` 함수 또는 플래그가 포함된 명령이 입력 줄에 적용될 때까지 각 파일 열기 지연: + +`{{명령}} | sed -fa {{경로/대상/스크립트.sed}}` + +- 모든 입력 라인에서 `apple` (확장 정규표현식)을 `APPLE` (확장 정규표현식)로 대체하고 결과를 `stdout`에 인쇄: + +`{{명령}} | sed -E 's/(apple)/\U\1/g'` + +- 첫 번째 줄만 `stdout`에 인쇄: + +`{{명령}} | sed -n '1p'` + +- 특정 파일에서 `apple` (기본 정규표현식)을 `mango` (기본 정규표현식)로 모두 대체하고 원본 파일 덮어쓰기: + +`sed -i 's/apple/mango/g' {{경로/대상/파일}}` diff --git a/pages.ko/freebsd/sockstat.md b/pages.ko/freebsd/sockstat.md new file mode 100644 index 000000000..f6123f94f --- /dev/null +++ b/pages.ko/freebsd/sockstat.md @@ -0,0 +1,36 @@ +# sockstat + +> 오픈된 인터넷 또는 UNIX 도메인 소켓을 나열합니다. +> 더 많은 정보: . + +- 어떤 사용자/프로세스가 어떤 포트에서 [l]istening하는지 보기: + +`sockstat -l` + +- 특정 [p]ort에서 사용 중인 IPv[4]/IPv[6] 소켓 정보 보기, 특정 [P]rotocol 사용: + +`sockstat -{{4|6}} -l -P {{tcp|udp|sctp|divert}} -p {{port1,port2...}}` + +- [c]onnected 소켓도 표시, 숫자형식의 UID를 사용자 이름으로 해석하지 않고 [w]ider 필드 크기 사용: + +`sockstat -cnw` + +- 특정 [j]ail ID 또는 이름에 속하는 소켓만 [v]erbose 모드로 표시: + +`sockstat -jv` + +- 프로토콜 [s]tate 및 원격 [U]DP 캡슐화 포트 번호 표시 (현재 SCTP 및 TCP에만 구현됨): + +`sockstat -sU` + +- [C]ongestion control 모듈 및 프로토콜 [S]tack 표시 (현재 TCP에만 구현됨): + +`sockstat -CS` + +- 로컬 및 외부 주소가 루프백 네트워크 접두어 127.0.0.0/8이 아니거나 IPv6 루프백 주소 ::1을 포함하지 않는 경우에만 인터넷 소켓 표시: + +`sockstat -L` + +- 헤더를 표시하지 않음 ([q]uiet 모드), [u]nix 소켓 표시하고 `inp_gencnt` 표시: + +`sockstat -qui` diff --git a/pages.ko/freebsd/ypchfn.md b/pages.ko/freebsd/ypchfn.md new file mode 100644 index 000000000..5f8fe7ee4 --- /dev/null +++ b/pages.ko/freebsd/ypchfn.md @@ -0,0 +1,7 @@ +# ypchfn + +> 이 명령어는 `chpass`의 에일리어스 (별칭) 입니다. + +- 원본 명령의 도큐멘테이션 (설명서) 보기: + +`tldr chpass` diff --git a/pages.ko/freebsd/ypchpass.md b/pages.ko/freebsd/ypchpass.md new file mode 100644 index 000000000..c0abdfb6a --- /dev/null +++ b/pages.ko/freebsd/ypchpass.md @@ -0,0 +1,7 @@ +# ypchpass + +> 이 명령어는 `chpass`의 에일리어스 (별칭) 입니다. + +- 원본 명령의 도큐멘테이션 (설명서) 보기: + +`tldr chpass` diff --git a/pages.ko/freebsd/ypchsh.md b/pages.ko/freebsd/ypchsh.md new file mode 100644 index 000000000..2679e6f1b --- /dev/null +++ b/pages.ko/freebsd/ypchsh.md @@ -0,0 +1,7 @@ +# ypchsh + +> 이 명령어는 `chpass`의 에일리어스 (별칭) 입니다. + +- 원본 명령의 도큐멘테이션 (설명서) 보기: + +`tldr chpass` diff --git a/pages.ko/linux/add-apt-repository.md b/pages.ko/linux/add-apt-repository.md index c0815aebd..898d348ba 100644 --- a/pages.ko/linux/add-apt-repository.md +++ b/pages.ko/linux/add-apt-repository.md @@ -3,7 +3,7 @@ > 적절한 저장소 정의를 관리합니다. > 더 많은 정보: . -- 새로운 apt 레포지토리 추가: +- 새로운 APT 레포지토리 추가: `add-apt-repository {{레포지토리_스펙}}` diff --git a/pages.ko/linux/dd.md b/pages.ko/linux/dd.md index b573f12d7..5fb0877ad 100644 --- a/pages.ko/linux/dd.md +++ b/pages.ko/linux/dd.md @@ -9,24 +9,20 @@ - 4 MiB 블록이 있는 다른 드라이브에 드라이브를 복제하고, 오류를 무시하고 진행 상황을 표시: -`dd if={{/dev/소스_드라이브}} of={{/dev/목적지_드라이브}} bs={{4M}} conv={{noerror}} status=progress` +`dd bs=4M conv=noerror if={{/dev/소스_드라이브}} of={{/dev/목적지_드라이브}} status=progress` -- 커널 랜덤 드라이버를 사용하여 랜덤 100바이트의 파일 생성: +- 커널 랜덤 드라이버를 사용하여, 특정 수의 임의 바이트 크기를 가지는 파일 생성: -`dd if=/dev/urandom of={{경로/대상/랜덤_파일}} bs={{100}} count={{1}}` +`dd bs={{100}} count={{1}} if=/dev/urandom of={{경로/대상/랜덤_파일}}` - 디스크의 쓰기 성능 벤치마크: -`dd if=/dev/zero of={{경로/대상/1GB_파일}} bs={{1024}} count={{1000000}}` +`dd bs={{1M}} count={{1024}} if=/dev/zero of={{경로/대상/1GB_파일}}` - IMG 파일로 시스템 백업을 생성하고 진행 상황 표시: `dd if={{/dev/드라이브_장치}} of={{경로/대상/파일.img}} status=progress` -- IMG 파일에서 드라이브를 복원하고 진행 상황을 표시: - -`dd if={{경로/대상/파일.img}} of={{/dev/드라이브_장치}} status=progress` - -- 진행 중인 dd 작업의 진행 상황을 확인 (다른 셸에서 이 명령어 실행): +- 진행 중인 `dd` 작업의 진행 상황을 확인 (다른 셸에서 이 명령어 실행): `kill -USR1 $(pgrep -x dd)` diff --git a/pages.ko/linux/ip-route-list.md b/pages.ko/linux/ip-route-list.md index 82aee362c..b2d1f703f 100644 --- a/pages.ko/linux/ip-route-list.md +++ b/pages.ko/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> 이 명령은 `ip-route-show` 의 에일리어스 (별칭) 입니다. +> 이 명령은 `ip route show`.의 에일리어스 (별칭) 입니다. - 원본 명령의 도큐멘테이션 (설명서) 보기: diff --git a/pages.ko/linux/pacman-database.md b/pages.ko/linux/pacman-database.md new file mode 100644 index 000000000..8820036dc --- /dev/null +++ b/pages.ko/linux/pacman-database.md @@ -0,0 +1,30 @@ +# pacman --database + +> Arch Linux 패키지 데이터베이스를 조작합니다. +> 설치된 패키지의 특정 속성을 수정합니다. +> 같이 보기: `pacman`. +> 더 많은 정보: . + +- 패키지를 암묵적으로 설치된 것으로 표시: + +`sudo pacman --database --asdeps {{패키지}}` + +- 패키지를 명시적으로 설치된 것으로 표시: + +`sudo pacman --database --asexplicit {{패키지}}` + +- 모든 패키지 의존성이 설치되었는지 확인: + +`pacman --database --check` + +- 모든 지정된 의존성이 사용 가능한지 확인하기 위해 저장소 검사: + +`pacman --database --check --check` + +- 오류 메시지만 표시: + +`pacman --database --check --quiet` + +- 도움말 표시: + +`pacman --database --help` diff --git a/pages.ko/linux/pacman-deptest.md b/pages.ko/linux/pacman-deptest.md new file mode 100644 index 000000000..c3139d33f --- /dev/null +++ b/pages.ko/linux/pacman-deptest.md @@ -0,0 +1,21 @@ +# pacman --deptest + +> 지정된 각 의존성을 확인하고 시스템에 현재 충족되지 않은 의존성 목록을 반환합니다. +> 같이 보기: `pacman`. +> 더 많은 정보: . + +- 설치되지 않은 의존성의 패키지 이름을 출력: + +`pacman --deptest {{패키지1 패키지2 ...}}` + +- 설치된 패키지가 주어진 최소 버전을 충족하는지 확인: + +`pacman --deptest "{{bash>=5}}"` + +- 패키지의 최신 버전이 설치되었는지 확인: + +`pacman --deptest "{{bash>5}}"` + +- 도움말 표시: + +`pacman --deptest --help` diff --git a/pages.ko/linux/pacman-files.md b/pages.ko/linux/pacman-files.md new file mode 100644 index 000000000..bdd772539 --- /dev/null +++ b/pages.ko/linux/pacman-files.md @@ -0,0 +1,29 @@ +# pacman --files + +> Arch Linux 패키지 관리 도구. +> 같이 보기: `pacman`, `pkgfile`. +> 더 많은 정보: . + +- 패키지 데이터베이스 업데이트: + +`sudo pacman --files --refresh` + +- 특정 파일을 소유한 패키지 찾기: + +`pacman --files {{파일_이름}}` + +- 정규 표현식을 사용하여 특정 파일을 소유한 패키지 찾기: + +`pacman --files --regex '{{정규표현식}}'` + +- 패키지 이름만 나열: + +`pacman --files --quiet {{파일_이름}}` + +- 특정 패키지가 소유한 파일 나열: + +`pacman --files --list {{패키지}}` + +- 도움말 표시: + +`pacman --files --help` diff --git a/pages.ko/linux/pacman-key.md b/pages.ko/linux/pacman-key.md new file mode 100644 index 000000000..37ad0fd89 --- /dev/null +++ b/pages.ko/linux/pacman-key.md @@ -0,0 +1,37 @@ +# pacman-key + +> GnuPG를 사용하여 pacman의 키링을 관리하는 래퍼 스크립트. +> 같이 보기: `pacman`. +> 더 많은 정보: . + +- `pacman` 키링 초기화: + +`sudo pacman-key --init` + +- 기본 Arch Linux 키 추가: + +`sudo pacman-key --populate {{archlinux}}` + +- 공개 키링에서 키 나열: + +`pacman-key --list-keys` + +- 지정된 키 추가: + +`sudo pacman-key --add {{경로/대상/키파일.gpg}}` + +- 키 서버에서 키 수신: + +`sudo pacman-key --recv-keys "{{uid|name|email}}"` + +- 특정 키의 지문 출력: + +`pacman-key --finger "{{uid|name|email}}"` + +- 가져온 키를 로컬에서 서명: + +`sudo pacman-key --lsign-key "{{uid|name|email}}"` + +- 특정 키 제거: + +`sudo pacman-key --delete "{{uid|name|email}}"` diff --git a/pages.ko/linux/pacman-mirrors.md b/pages.ko/linux/pacman-mirrors.md new file mode 100644 index 000000000..79981c380 --- /dev/null +++ b/pages.ko/linux/pacman-mirrors.md @@ -0,0 +1,26 @@ +# pacman-mirrors + +> Manjaro Linux용 `pacman` 미러 리스트 생성. +> `pacman-mirrors`를 실행할 때마다 데이터베이스를 동기화하고 `sudo pacman -Syyu`를 사용하여 시스템을 업데이트해야 합니다. +> 같이 보기: `pacman`. +> 더 많은 정보: . + +- 기본 설정을 사용하여 미러 리스트 생성: + +`sudo pacman-mirrors --fasttrack` + +- 현재 미러 상태 확인: + +`pacman-mirrors --status` + +- 현재 브랜치 표시: + +`pacman-mirrors --get-branch` + +- 다른 브랜치로 전환: + +`sudo pacman-mirrors --api --set-branch {{stable|unstable|testing}}` + +- 거주 국가의 미러만 사용하여 미러 리스트 생성: + +`sudo pacman-mirrors --geoip` diff --git a/pages.ko/linux/pacman-query.md b/pages.ko/linux/pacman-query.md new file mode 100644 index 000000000..040de28fd --- /dev/null +++ b/pages.ko/linux/pacman-query.md @@ -0,0 +1,37 @@ +# pacman --query + +> Arch Linux 패키지 관리 도구. +> 같이 보기: `pacman`. +> 더 많은 정보: . + +- 설치된 패키지와 버전 나열: + +`pacman --query` + +- 명시적으로 설치된 패키지와 버전만 나열: + +`pacman --query --explicit` + +- 파일을 소유한 패키지 찾기: + +`pacman --query --owns {{파일_이름}}` + +- 설치된 패키지 정보 표시: + +`pacman --query --info {{패키지}}` + +- 패키지가 소유한 파일 나열: + +`pacman --query --list {{패키지}}` + +- 고아 패키지 나열 (의존성으로 설치되었지만 더 이상 어떤 패키지도 필요로 하지 않는 패키지): + +`pacman --query --unrequired --deps --quiet` + +- 저장소에서 찾을 수 없는 설치된 패키지 나열: + +`pacman --query --foreign` + +- 오래된 패키지 나열: + +`pacman --query --upgrades` diff --git a/pages.ko/linux/pacman-remove.md b/pages.ko/linux/pacman-remove.md new file mode 100644 index 000000000..f98a02fbb --- /dev/null +++ b/pages.ko/linux/pacman-remove.md @@ -0,0 +1,33 @@ +# pacman --remove + +> Arch Linux 패키지 관리 도구. +> 같이 보기: `pacman`. +> 더 많은 정보: . + +- 패키지와 그 의존성 제거: + +`sudo pacman --remove --recursive {{패키지}}` + +- 패키지와 그 의존성 및 구성 파일 제거: + +`sudo pacman --remove --recursive --nosave {{패키지}}` + +- 확인 없이 패키지 제거: + +`sudo pacman --remove --noconfirm {{패키지}}` + +- 고아 패키지 제거 (의존성으로 설치되었지만 더 이상 어떤 패키지도 필요로 하지 않는 패키지): + +`sudo pacman --remove --recursive --nosave $(pacman --query --unrequired --deps --quiet)` + +- 패키지와 해당 패키지를 의존하는 모든 패키지 제거: + +`sudo pacman --remove --cascade {{패키지}}` + +- 영향을 받을 패키지 목록 표시 (패키지를 제거하지 않음): + +`pacman --remove --print {{패키지}}` + +- 도움말 표시: + +`pacman --remove --help` diff --git a/pages.ko/linux/pacman-sync.md b/pages.ko/linux/pacman-sync.md new file mode 100644 index 000000000..78c60ca29 --- /dev/null +++ b/pages.ko/linux/pacman-sync.md @@ -0,0 +1,37 @@ +# pacman --sync + +> Arch Linux 패키지 관리 도구. +> 같이 보기: `pacman`. +> 더 많은 정보: . + +- 새 패키지 설치: + +`sudo pacman --sync {{패키지}}` + +- 모든 패키지 동기화 및 업데이트 (`--downloadonly`를 추가하여 패키지를 다운로드만 하고 업데이트하지 않음): + +`sudo pacman --sync --refresh --sysupgrade` + +- 모든 패키지를 업데이트하고 새 패키지를 확인 없이 설치: + +`sudo pacman --sync --refresh --sysupgrade --noconfirm {{패키지}}` + +- 정규 표현식 또는 키워드로 패키지 데이터베이스 검색: + +`pacman --sync --search "{{검색어}}"` + +- 패키지 정보 표시: + +`pacman --sync --info {{패키지}}` + +- 패키지 업데이트 중 충돌하는 파일 덮어쓰기: + +`sudo pacman --sync --refresh --sysupgrade --overwrite {{경로/대상/파일}}` + +- 모든 패키지를 동기화 및 업데이트하지만 특정 패키지는 무시 (여러 번 사용 가능): + +`sudo pacman --sync --refresh --sysupgrade --ignore {{패키지}}` + +- 설치되지 않은 패키지와 사용되지 않는 저장소를 캐시에서 제거 (모든 패키지를 정리하려면 `--clean` 플래그를 두 번 사용): + +`sudo pacman --sync --clean` diff --git a/pages.ko/linux/pacman-upgrade.md b/pages.ko/linux/pacman-upgrade.md new file mode 100644 index 000000000..2118c47c0 --- /dev/null +++ b/pages.ko/linux/pacman-upgrade.md @@ -0,0 +1,29 @@ +# pacman --upgrade + +> Arch Linux 패키지 관리 도구. +> 같이 보기: `pacman`. +> 더 많은 정보: . + +- 파일에서 하나 이상의 패키지 설치: + +`sudo pacman --upgrade {{경로/대상/패키지1.pkg.tar.zst}} {{경로/대상/패키지2.pkg.tar.zst}}` + +- 확인 없이 패키지 설치: + +`sudo pacman --upgrade --noconfirm {{경로/대상/패키지.pkg.tar.zst}}` + +- 패키지 설치 중 충돌하는 파일 덮어쓰기: + +`sudo pacman --upgrade --overwrite {{경로/대상/파일}} {{경로/대상/패키지.pkg.tar.zst}}` + +- 의존성 버전 검사를 건너뛰고 패키지 설치: + +`sudo pacman --upgrade --nodeps {{경로/대상/패키지.pkg.tar.zst}}` + +- 영향을 받을 패키지 목록 표시 (패키지를 설치하지 않음): + +`pacman --upgrade --print {{경로/대상/패키지.pkg.tar.zst}}` + +- 도움말 표시: + +`pacman --upgrade --help` diff --git a/pages.ko/linux/pacman.md b/pages.ko/linux/pacman.md new file mode 100644 index 000000000..25cb35ecd --- /dev/null +++ b/pages.ko/linux/pacman.md @@ -0,0 +1,38 @@ +# pacman + +> Arch Linux 패키지 관리 도구. +> 같이 보기: `pacman-database`, `pacman-deptest`, `pacman-files`, `pacman-key`, `pacman-mirrors`, `pacman-query`, `pacman-remove`, `pacman-sync`, `pacman-upgrade`. +> 다른 패키지 관리자의 동등한 명령을 보려면 . +> 더 많은 정보: . + +- 모든 패키지를 동기화하고 업데이트: + +`sudo pacman -Syu` + +- 새 패키지 설치: + +`sudo pacman -S {{패키지}}` + +- 특정 패키지 및 의존성 제거: + +`sudo pacman -Rs {{패키지}}` + +- 특정 파일이 포함된 패키지를 데이터베이스에서 검색: + +`pacman -F "{{파일_이름}}"` + +- 설치된 패키지 및 버전 나열: + +`pacman -Q` + +- 명시적으로 설치된 패키지 및 버전만 나열: + +`pacman -Qe` + +- 고아 패키지(의존성으로 설치되었지만 더 이상 어떤 패키지도 필요로 하지 않는 패키지) 나열: + +`pacman -Qtdq` + +- 전체 `pacman` 캐시 삭제: + +`sudo pacman -Scc` diff --git a/pages.ko/linux/pacman4console.md b/pages.ko/linux/pacman4console.md new file mode 100644 index 000000000..2547a3b7c --- /dev/null +++ b/pages.ko/linux/pacman4console.md @@ -0,0 +1,20 @@ +# pacman4console + +> 오리지널 팩맨에서 영감을 받은 텍스트 기반 콘솔 게임. +> 더 많은 정보: . + +- 1단계에서 게임 시작: + +`pacman4console` + +- 특정 단계에서 게임 시작 (총 9개의 공식 단계가 있음): + +`pacman4console --level={{단계_번호}}` + +- 지정된 텍스트 파일에 저장하면서 pacman4console 레벨 편집기 시작: + +`pacman4consoleedit {{경로/대상/레벨_파일}}` + +- 사용자 정의 레벨 플레이: + +`pacman4console --level={{경로/대상/레벨_파일}}` diff --git a/pages.ko/linux/pwd.md b/pages.ko/linux/pwd.md new file mode 100644 index 000000000..37ea61765 --- /dev/null +++ b/pages.ko/linux/pwd.md @@ -0,0 +1,16 @@ +# pwd + +> 현재 작업 중인 디렉토리의 이름을 출력합니다. +> 더 많은 정보: . + +- 현재 디렉토리 출력: + +`pwd` + +- 현재 디렉토리를 출력하고 모든 심볼릭 링크를 해석 (즉, "물리적" 경로 표시): + +`pwd --physical` + +- 현재 논리적 디렉토리 출력: + +`pwd --logical` diff --git a/pages.ko/linux/yaourt.md b/pages.ko/linux/yaourt.md new file mode 100644 index 000000000..8f9be5065 --- /dev/null +++ b/pages.ko/linux/yaourt.md @@ -0,0 +1,24 @@ +# yaourt + +> Arch Linux 유틸리티로 Arch User Repository(AUR)에서 패키지를 빌드합니다. +> 더 많은 정보: . + +- 모든 패키지 동기화 및 업데이트 (AUR 포함): + +`yaourt -Syua` + +- 새 패키지 설치 (AUR 포함): + +`yaourt -S {{패키지}}` + +- 패키지와 그 의존성 제거 (AUR 패키지 포함): + +`yaourt -Rs {{패키지}}` + +- 키워드로 패키지 데이터베이스 검색 (AUR 포함): + +`yaourt -Ss {{검색어}}` + +- 설치된 패키지, 버전 및 저장소 나열 (AUR 패키지는 'local' 저장소로 나열됨): + +`yaourt -Q` diff --git a/pages.ko/linux/yay.md b/pages.ko/linux/yay.md new file mode 100644 index 000000000..af3711a54 --- /dev/null +++ b/pages.ko/linux/yay.md @@ -0,0 +1,37 @@ +# yay + +> Yet Another Yogurt: Arch User Repository(AUR)에서 패키지를 빌드하고 설치합니다. +> 같이 보기: `pacman`. +> 더 많은 정보: . + +- 저장소와 AUR에서 패키지를 검색하고 상호작용하며 설치: + +`yay {{패키지_이름|검색어}}` + +- 저장소와 AUR의 모든 패키지를 동기화하고 업데이트: + +`yay` + +- AUR 패키지만 동기화하고 업데이트: + +`yay -Sua` + +- 저장소와 AUR에서 새 패키지 설치: + +`yay -S {{패키지}}` + +- 설치된 패키지와 그 의존성 및 구성 파일 제거: + +`yay -Rns {{패키지}}` + +- 저장소와 AUR의 패키지 데이터베이스에서 키워드 검색: + +`yay -Ss {{키워드}}` + +- 고아 패키지 제거 (의존성으로 설치되었지만 더 이상 어떤 패키지도 필요로 하지 않는 패키지): + +`yay -Yc` + +- 설치된 패키지와 시스템 상태에 대한 통계 표시: + +`yay -Ps` diff --git a/pages.ko/netbsd/cal.md b/pages.ko/netbsd/cal.md new file mode 100644 index 000000000..52e926e80 --- /dev/null +++ b/pages.ko/netbsd/cal.md @@ -0,0 +1,36 @@ +# cal + +> 달력을 표시합니다. +> 더 많은 정보: . + +- 현재 월의 달력 표시: + +`cal` + +- 특정 연도의 달력 표시: + +`cal {{연도}}` + +- 특정 월과 연도의 달력 표시: + +`cal {{월}} {{연도}}` + +- 1부터 시작하는 율리우스력을 사용해 현재 연도의 전체 달력 표시: + +`cal -y -j` + +- 오늘을 강조하고 날짜를 포함해 3개월 표시: + +`cal -h -3 {{월}} {{연도}}` + +- 현재 연도의 특정 월의 이전 2개월과 이후 3개월 표시: + +`cal -A 3 -B 2 {{월}}` + +- 지정한 월의 이전 및 이후의 월 수를 지정: + +`cal -C {{월 수}} {{월}}` + +- 주의 시작 요일을 지정 (0: 일요일, 1: 월요일, ..., 6: 토요일): + +`cal -d {{0..6}}` diff --git a/pages.ko/netbsd/chfn.md b/pages.ko/netbsd/chfn.md new file mode 100644 index 000000000..a5c7ea69b --- /dev/null +++ b/pages.ko/netbsd/chfn.md @@ -0,0 +1,7 @@ +# chfn + +> 이 명령어는 `chpass`의 에일리어스 (별칭) 입니다. + +- 원본 명령의 도큐멘테이션 (설명서) 보기: + +`tldr chpass` diff --git a/pages.ko/netbsd/chpass.md b/pages.ko/netbsd/chpass.md new file mode 100644 index 000000000..0334ec9b3 --- /dev/null +++ b/pages.ko/netbsd/chpass.md @@ -0,0 +1,29 @@ +# chpass + +> 사용자 데이터베이스 정보, 로그인 셸 및 비밀번호를 추가하거나 변경합니다. +> 같이 보기: `passwd`. +> 더 많은 정보: . + +- 현재 사용자에게 특정 로그인 셸을 대화식으로 설정: + +`su -c chpass` + +- 현재 사용자에게 특정 로그인 셸 설정: + +`chpass -s {{경로/대상/셸}}` + +- 특정 사용자에게 로그인 셸 설정: + +`chpass chsh -s {{경로/대상/셸}} {{사용자명}}` + +- `passwd` 파일 형식으로 사용자 데이터베이스 항목 지정: + +`su -c 'chpass -a {{사용자명:암호화된_비밀번호:uid:gid:...}} -s {{경로/대상/파일}}' {{사용자명}}` + +- 로컬 비밀번호 파일만 업데이트: + +`su -c 'chpass -l -s {{경로/대상/셸}}' {{사용자명}}` + +- 데이터베이스 [y]P 비밀번호 데이터베이스 항목을 강제로 변경: + +`su -c 'chpass -y -s {{경로/대상/셸}}' {{사용자명}}` diff --git a/pages.ko/netbsd/chsh.md b/pages.ko/netbsd/chsh.md new file mode 100644 index 000000000..fcd121523 --- /dev/null +++ b/pages.ko/netbsd/chsh.md @@ -0,0 +1,7 @@ +# chsh + +> 이 명령어는 `chpass`의 에일리어스 (별칭) 입니다. + +- 원본 명령의 도큐멘테이션 (설명서) 보기: + +`tldr chpass` diff --git a/pages.ko/netbsd/df.md b/pages.ko/netbsd/df.md new file mode 100644 index 000000000..7f8b342d3 --- /dev/null +++ b/pages.ko/netbsd/df.md @@ -0,0 +1,32 @@ +# df + +> 파일 시스템 디스크 공간 사용량 개요를 표시합니다. +> 더 많은 정보: . + +- 512바이트 단위로 모든 파일 시스템과 디스크 사용량 표시: + +`df` + +- [h]uman-readable 단위 사용 (1024의 거듭제곱에 기반): + +`df -h` + +- `statvfs`에 의해 반환된 구조체의 모든 필드 표시: + +`df -G` + +- 주어진 파일 또는 디렉토리를 포함하는 파일 시스템과 해당 디스크 사용량 표시: + +`df {{경로/대상/파일_또는_폴더}}` + +- 빈 및 사용중인 [i]노드의 통계 포함: + +`df -i` + +- 공간 값을 쓸 때 1024바이트 단위 사용: + +`df -k` + +- [P]ortable한 방식으로 정보 표시: + +`df -P` diff --git a/pages.ko/netbsd/pkgin.md b/pages.ko/netbsd/pkgin.md new file mode 100644 index 000000000..48793adfd --- /dev/null +++ b/pages.ko/netbsd/pkgin.md @@ -0,0 +1,28 @@ +# pkgin + +> NetBSD에서 `pkgsrc` 바이너리 패키지를 관리합니다. +> 더 많은 정보: . + +- 패키지 설치: + +`pkgin install {{패키지}}` + +- 패키지 및 해당 의존성 제거: + +`pkgin remove {{패키지}}` + +- 모든 패키지 업그레이드: + +`pkgin full-upgrade` + +- 패키지 검색: + +`pkgin search {{키워드}}` + +- 설치된 패키지 나열: + +`pkgin list` + +- 필요없는 의존성 제거: + +`pkgin autoremove` diff --git a/pages.ko/netbsd/sed.md b/pages.ko/netbsd/sed.md new file mode 100644 index 000000000..952c68646 --- /dev/null +++ b/pages.ko/netbsd/sed.md @@ -0,0 +1,33 @@ +# sed + +> 스크립트로 텍스트를 편집합니다. +> 같이 보기: `awk`, `ed`. +> 더 많은 정보: . + +- 모든 입력 라인에서 `apple` (기본 정규표현식)을 `mango` (기본 정규표현식)로 대체하고 결과를 `stdout`에 인쇄: + +`{{명령}} | sed 's/apple/mango/g'` + +- 특정 스크립트 [f]파일을 실행하고 결과를 `stdout`에 인쇄: + +`{{명령}} | sed -f {{경로/대상/스크립트.sed}}` + +- 관련 `w` 함수 또는 플래그가 포함된 명령이 입력 줄에 적용될 때까지 각 파일 열기 지연: + +`{{명령}} | sed -fa {{경로/대상/스크립트.sed}}` + +- GNU [g]정규식 확장 활성화: + +`{{명령}} | sed -fg {{경로/대상/스크립트.sed}}` + +- 모든 입력 라인에서 `apple` (확장 정규표현식)을 `APPLE` (확장 정규표현식)으로 대체하고 결과를 `stdout`에 인쇄: + +`{{명령}} | sed -E 's/(apple)/\U\1/g'` + +- 첫 번째 줄만 `stdout`에 인쇄: + +`{{명령}} | sed -n '1p'` + +- 특정 파일에서 `apple` (기본 정규표현식)을 `mango` (기본 정규표현식)로 모두 대체하고 원본 파일 덮어쓰기: + +`sed -i 's/apple/mango/g' {{경로/대상/파일}}` diff --git a/pages.ko/netbsd/sockstat.md b/pages.ko/netbsd/sockstat.md new file mode 100644 index 000000000..b5a4a403b --- /dev/null +++ b/pages.ko/netbsd/sockstat.md @@ -0,0 +1,26 @@ +# sockstat + +> 열린 인터넷 또는 UNIX 도메인 소켓을 나열합니다. +> 참고: 이 프로그램은 FreeBSD의 `sockstat`를 NetBSD 3.0용으로 다시 작성한 것입니다. +> 같이 보기: `netstat`. +> 더 많은 정보: . + +- IPv4, IPv6 및 Unix 소켓에 대한 수신 및 연결된 소켓에 대한 정보 표시: + +`sockstat` + +- 특정 포트에서 특정 프로토콜을 사용하는 IPv[4]/IPv[6] 소켓 [l]istening에 대한 정보 표시: + +`sockstat -{{4|6}} -l -P {{tcp|udp|sctp|divert}} -p {{port1,port2...}}` + +- [c]onnected 소켓도 표시하며 [u]nix 소켓도 표시: + +`sockstat -cu` + +- 주소 및 포트의 심볼릭 이름을 해결하지 않고 [n]umeric 출력만 표시: + +`sockstat -n` + +- 지정된 주소 [f]amily의 소켓만 나열: + +`sockstat -f {{inet|inet6|local|unix}}` diff --git a/pages.ko/openbsd/cal.md b/pages.ko/openbsd/cal.md new file mode 100644 index 000000000..57ab585a3 --- /dev/null +++ b/pages.ko/openbsd/cal.md @@ -0,0 +1,32 @@ +# cal + +> 현재 날짜가 강조된 달력을 표시합니다. +> 더 많은 정보: . + +- 현재 월의 달력 표시: + +`cal` + +- 특정 년도의 달력 표시: + +`cal {{년도}}` + +- 특정 월과 년도의 달력 표시: + +`cal {{월}} {{년도}}` + +- 현재 년도의 달력 표시: + +`cal -y` + +- [j]율리우스력 표시 (1부터 시작되며 1월 1일부터 번호 부여됨): + +`cal -j` + +- 일요일 대신에 [m]월요일을 주 시작으로 사용: + +`cal -m` + +- [w]주 번호 표시 (`-j`와 호환되지 않음): + +`cal -w` diff --git a/pages.ko/openbsd/chfn.md b/pages.ko/openbsd/chfn.md new file mode 100644 index 000000000..a5c7ea69b --- /dev/null +++ b/pages.ko/openbsd/chfn.md @@ -0,0 +1,7 @@ +# chfn + +> 이 명령어는 `chpass`의 에일리어스 (별칭) 입니다. + +- 원본 명령의 도큐멘테이션 (설명서) 보기: + +`tldr chpass` diff --git a/pages.ko/openbsd/chpass.md b/pages.ko/openbsd/chpass.md new file mode 100644 index 000000000..959dc5858 --- /dev/null +++ b/pages.ko/openbsd/chpass.md @@ -0,0 +1,21 @@ +# chpass + +> 로그인 셸과 비밀번호를 포함한 사용자 데이터베이스 정보를 추가하거나 변경합니다. +> 같이 보기: `passwd`. +> 더 많은 정보: . + +- 현재 사용자에게 특정 로그인 셸을 대화식으로 설정: + +`doas chsh` + +- 현재 사용자에게 특정 로그인 셸을 설정: + +`doas chsh -s {{경로/대상/셸}}` + +- 특정 사용자에게 로그인 셸을 설정: + +`doas chsh -s {{경로/대상/셸}} {{사용자명}}` + +- `passwd` 파일 형식의 사용자 데이터베이스 항목을 지정: + +`doas chsh -a {{사용자명:암호화된_비밀번호:uid:gid:...}}` diff --git a/pages.ko/openbsd/chsh.md b/pages.ko/openbsd/chsh.md new file mode 100644 index 000000000..fcd121523 --- /dev/null +++ b/pages.ko/openbsd/chsh.md @@ -0,0 +1,7 @@ +# chsh + +> 이 명령어는 `chpass`의 에일리어스 (별칭) 입니다. + +- 원본 명령의 도큐멘테이션 (설명서) 보기: + +`tldr chpass` diff --git a/pages.ko/openbsd/df.md b/pages.ko/openbsd/df.md new file mode 100644 index 000000000..27d9d62e5 --- /dev/null +++ b/pages.ko/openbsd/df.md @@ -0,0 +1,28 @@ +# df + +> 파일 시스템 디스크 공간 사용량 개요를 표시합니다. +> 더 많은 정보: . + +- 모든 파일 시스템과 디스크 사용량을 512바이트 단위로 표시: + +`df` + +- [h]uman-readable 형식으로 모든 파일 시스템과 디스크 사용량 표시 (1024의 거듭 제곱에 기반): + +`df -h` + +- 지정된 파일 또는 디렉토리를 포함하는 파일 시스템 및 해당 디스크 사용량 표시: + +`df {{경로/대상/파일_또는_폴더}}` + +- 무료 및 사용 중인 [i]노드 수에 대한 통계 포함: + +`df -i` + +- 공간 수치 작성 시 1024바이트 단위 사용: + +`df -k` + +- [P]ortable 방식으로 정보 표시: + +`df -P` diff --git a/pages.ko/openbsd/pkg.md b/pages.ko/openbsd/pkg.md new file mode 100644 index 000000000..4c473e47c --- /dev/null +++ b/pages.ko/openbsd/pkg.md @@ -0,0 +1,16 @@ +# pkg + +> OpenBSD 패키지 관리자 도구. +> 더 많은 정보: . + +- 패키지 설치/업데이트에 대한 설명서 보기: + +`tldr pkg_add` + +- 패키지 제거에 대한 설명서 보기: + +`tldr pkg_delete` + +- 패키지 정보를 확인하는 설명서 보기: + +`tldr pkg_info` diff --git a/pages.ko/openbsd/pkg_add.md b/pages.ko/openbsd/pkg_add.md new file mode 100644 index 000000000..acc3c6c66 --- /dev/null +++ b/pages.ko/openbsd/pkg_add.md @@ -0,0 +1,17 @@ +# pkg_add + +> OpenBSD에 패키지를 설치/업데이트합니다. +> 같이 보기: `pkg_info`, `pkg_delete`. +> 더 많은 정보: . + +- 종속성을 포함하여 모든 패키지를 업데이트: + +`pkg_add -u` + +- 새로운 패키지 설치: + +`pkg_add {{패키지}}` + +- `pkg_info`의 원시 출력에서 패키지 설치: + +`pkg_add -l {{경로/대상/파일}}` diff --git a/pages.ko/openbsd/pkg_delete.md b/pages.ko/openbsd/pkg_delete.md new file mode 100644 index 000000000..3f933b108 --- /dev/null +++ b/pages.ko/openbsd/pkg_delete.md @@ -0,0 +1,17 @@ +# pkg_delete + +> OpenBSD에서 패키지를 제거합니다. +> 같이 보기: `pkg_add`, `pkg_info`. +> 더 많은 정보: . + +- 패키지 삭제: + +`pkg_delete {{패키지}}` + +- 사용되지 않는 의존성을 포함하여 패키지 삭제: + +`pkg_delete -a {{패키지}}` + +- 패키지의 Dry-run 삭제: + +`pkg_delete -n {{패키지}}` diff --git a/pages.ko/openbsd/pkg_info.md b/pages.ko/openbsd/pkg_info.md new file mode 100644 index 000000000..0e3867521 --- /dev/null +++ b/pages.ko/openbsd/pkg_info.md @@ -0,0 +1,13 @@ +# pkg_info + +> OpenBSD의 패키지에 대한 정보를 확인합니다. +> 같이 보기: `pkg_add`, `pkg_delete`. +> 더 많은 정보: . + +- 패키지 이름을 사용해 패키지 검색: + +`pkg_info -Q {{패키지}}` + +- `pkg_add -l`과 함께 사용할 설치된 패키지 목록을 출력: + +`pkg_info -mz` diff --git a/pages.ko/openbsd/sed.md b/pages.ko/openbsd/sed.md new file mode 100644 index 000000000..8a481be00 --- /dev/null +++ b/pages.ko/openbsd/sed.md @@ -0,0 +1,29 @@ +# sed + +> 스크립트로 텍스트를 편집합니다. +> 같이 보기: `awk`, `ed`. +> 더 많은 정보: . + +- 모든 입력 라인에서 `apple` (기본 정규표현식)을 `mango` (기본 정규표현식)로 대체하고 결과를 `stdout`에 인쇄: + +`{{명령}} | sed 's/apple/mango/g'` + +- 특정 스크립트 [f]파일을 실행하고 결과를 `stdout`에 인쇄: + +`{{명령}} | sed -f {{경로/대상/스크립트.sed}}` + +- 관련 `w` 함수 또는 플래그가 포함된 명령이 입력 줄에 적용될 때까지 각 파일 열기 지연: + +`{{명령}} | sed -fa {{경로/대상/스크립트.sed}}` + +- 모든 입력 라인에서 `apple` (확장 정규표현식)을 `APPLE` (확장 정규표현식)로 대체하고 결과를 `stdout`에 인쇄: + +`{{명령}} | sed -E 's/(apple)/\U\1/g'` + +- 첫 번째 줄만 `stdout`에 인쇄: + +`{{명령}} | sed -n '1p'` + +- 특정 파일에서 `apple` (기본 정규표현식)을 `mango` (기본 정규표현식)로 모두 대체하고 원본 파일 덮어쓰기: + +`sed -i 's/apple/mango/g' {{경로/대상/파일}}` diff --git a/pages.ko/osx/date.md b/pages.ko/osx/date.md index 10241a401..e5095be86 100644 --- a/pages.ko/osx/date.md +++ b/pages.ko/osx/date.md @@ -17,4 +17,4 @@ - 기본 형식을 사용하여 특정 날짜(Unix 타임스탬프로 표시) 표시: -`date -r 1473305798` +`date -r {{1473305798}}` diff --git a/pages.ko/sunos/devfsadm.md b/pages.ko/sunos/devfsadm.md new file mode 100644 index 000000000..f36a2bcaa --- /dev/null +++ b/pages.ko/sunos/devfsadm.md @@ -0,0 +1,16 @@ +# devfsadm + +> `/dev`의 관리 명령어입니다. `/dev` 네임스페이스를 유지합니다. +> 더 많은 정보: . + +- 새 디스크 검색: + +`devfsadm -c disk` + +- 미해결된 /dev 링크를 정리하고 새 장치를 검색: + +`devfsadm -C -v` + +- 시뮬레이션 실행 - 변경될 내용을 출력하지만 수정하지 않음: + +`devfsadm -C -v -n` diff --git a/pages.ko/sunos/dmesg.md b/pages.ko/sunos/dmesg.md new file mode 100644 index 000000000..9664ea36a --- /dev/null +++ b/pages.ko/sunos/dmesg.md @@ -0,0 +1,16 @@ +# dmesg + +> 커널 메시지를 `stdout`에 기록합니다. +> 더 많은 정보: . + +- 커널 메시지 표시: + +`dmesg` + +- 시스템에서 사용 가능한 물리적 메모리 양 표시: + +`dmesg | grep -i memory` + +- 한 번에 한 페이지씩 커널 메시지 표시: + +`dmesg | less` diff --git a/pages.ko/sunos/prctl.md b/pages.ko/sunos/prctl.md new file mode 100644 index 000000000..6ebfe8a98 --- /dev/null +++ b/pages.ko/sunos/prctl.md @@ -0,0 +1,16 @@ +# prctl + +> 실행 중인 프로세스, 작업 및 프로젝트의 리소스 제어를 가져오거나 설정합니다. +> 더 많은 정보: . + +- 프로세스 제한 및 권한 검사: + +`prctl {{pid}}` + +- 기계적 분석이 가능한 형식으로 프로세스 제한 및 권한 검사: + +`prctl -P {{pid}}` + +- 실행 중인 프로세스의 특정 제한 가져오기: + +`prctl -n process.max-file-descriptor {{pid}}` diff --git a/pages.ko/sunos/prstat.md b/pages.ko/sunos/prstat.md new file mode 100644 index 000000000..b47c94cff --- /dev/null +++ b/pages.ko/sunos/prstat.md @@ -0,0 +1,24 @@ +# prstat + +> 활성 프로세스 통계를 보고합니다. +> 더 많은 정보: . + +- 모든 프로세스 검토 및 CPU 사용량으로 정렬해 통계 보고: + +`prstat` + +- 모든 프로세스 검토 및 메모리 사용량으로 정렬해 통계 보고: + +`prstat -s rss` + +- 각 사용자에 대한 총 사용량 요약 보고: + +`prstat -t` + +- 마이크로스테이트 프로세스 계정 정보 보고: + +`prstat -m` + +- 매 초마다 상위 5개 CPU 사용 프로세스 목록 출력: + +`prstat -c -n 5 -s cpu 1` diff --git a/pages.ko/sunos/snoop.md b/pages.ko/sunos/snoop.md new file mode 100644 index 000000000..ca6593df5 --- /dev/null +++ b/pages.ko/sunos/snoop.md @@ -0,0 +1,25 @@ +# snoop + +> 네트워크 패킷 스니퍼. +> tcpdump와 동일한 기능을 하는 SunOS 대체품. +> 더 많은 정보: . + +- 특정 네트워크 인터페이스에서 패킷을 캡처: + +`snoop -d {{e1000g0}}` + +- 화면에 표시하는 대신 캡처된 패킷을 파일에 저장: + +`snoop -o {{경로/대상/파일}}` + +- 파일에서 패킷의 상세 프로토콜 레이어 요약 표시: + +`snoop -V -i {{경로/대상/파일}}` + +- 호스트 이름에서 지정된 포트로 가는 네트워크 패킷을 캡처: + +`snoop to port {{포트}} from host {{호스트명}}` + +- 두 IP 주소 간에 교환되는 네트워크 패킷의 hex 덤프를 캡처하고 표시: + +`snoop -x0 -p4 {{ip1}} {{ip2}}` diff --git a/pages.ko/sunos/svcadm.md b/pages.ko/sunos/svcadm.md new file mode 100644 index 000000000..65a506eb7 --- /dev/null +++ b/pages.ko/sunos/svcadm.md @@ -0,0 +1,24 @@ +# svcadm + +> 서비스 인스턴스를 조작합니다. +> 더 많은 정보: . + +- 서비스를 서비스 데이터베이스에서 활성화: + +`svcadm enable {{서비스_이름}}` + +- 서비스 비활성화: + +`svcadm disable {{서비스_이름}}` + +- 실행 중인 서비스 다시 시작: + +`svcadm restart {{서비스_이름}}` + +- 서비스에게 구성 파일을 다시 읽도록 명령: + +`svcadm refresh {{서비스_이름}}` + +- 서비스의 유지보수 상태를 해제하고 시작하도록 명령: + +`svcadm clear {{서비스_이름}}` diff --git a/pages.ko/sunos/svccfg.md b/pages.ko/sunos/svccfg.md new file mode 100644 index 000000000..3c78a38ea --- /dev/null +++ b/pages.ko/sunos/svccfg.md @@ -0,0 +1,16 @@ +# svccfg + +> 서비스 구성을 가져오고, 내보내고, 수정합니다. +> 더 많은 정보: . + +- 구성 파일 유효성 검사: + +`svccfg validate {{경로/대상/smf_파일.xml}}` + +- 서비스 구성을 파일로 내보내기: + +`svccfg export {{서비스명}} > {{경로/대상/smf_파일.xml}}` + +- 파일에서 서비스 구성 가져오거나 업데이트: + +`svccfg import {{경로/대상/smf_파일.xml}}` diff --git a/pages.ko/sunos/svcs.md b/pages.ko/sunos/svcs.md new file mode 100644 index 000000000..8f2ca8f6b --- /dev/null +++ b/pages.ko/sunos/svcs.md @@ -0,0 +1,24 @@ +# svcs + +> 실행 중인 서비스에 대한 정보를 나열합니다. +> 더 많은 정보: . + +- 모든 실행 중인 서비스를 나열: + +`svcs` + +- 실행되고 있지 않은 서비스를 나열: + +`svcs -vx` + +- 서비스에 대한 정보를 나열: + +`svcs apache` + +- 서비스 로그 파일의 위치 표시: + +`svcs -L apache` + +- 서비스 로그 파일의 끝을 표시: + +`tail $(svcs -L apache)` diff --git a/pages.ko/sunos/truss.md b/pages.ko/sunos/truss.md new file mode 100644 index 000000000..fa5f9f299 --- /dev/null +++ b/pages.ko/sunos/truss.md @@ -0,0 +1,25 @@ +# truss + +> 시스템 콜을 추적하는 문제 해결 도구. +> strace와 동일한 기능을 하는 SunOS 대체품. +> 더 많은 정보: . + +- 프로그램을 실행하여 모든 자식 프로세스를 따라가며 추적 시작: + +`truss -f {{프로그램}}` + +- PID에 따라 특정 프로세스 추적 시작: + +`truss -p {{pid}}` + +- 인수 및 환경 변수를 표시하며 프로그램을 실행하여 추적 시작: + +`truss -a -e {{프로그램}}` + +- 각 시스템 콜마다 시간, 호출 및 오류 수를 계산하고 프로그램 종료 시 요약 보고: + +`truss -c -p {{pid}}` + +- 시스템 콜 이름으로 출력을 필터링하여 프로세스 추적: + +`truss -p {{pid}} -t {{시스템_콜_이름}}` diff --git a/pages.lo/common/clamav.md b/pages.lo/common/clamav.md index c0fe7ef88..8a8396f05 100644 --- a/pages.lo/common/clamav.md +++ b/pages.lo/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > ຄຳສັ່ງນີ້ເປັນອີກຊື່ໜຶ່ງຂອງຄຳສັ່ງ `clamdscan`. > ຂໍ້ມູນເພີ່ມເຕີມ: . diff --git a/pages.lo/common/fossil-ci.md b/pages.lo/common/fossil-ci.md index 267ba0728..b18670fbd 100644 --- a/pages.lo/common/fossil-ci.md +++ b/pages.lo/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> ຄຳສັ່ງນີ້ເປັນອີກຊື່ໜຶ່ງຂອງຄຳສັ່ງ `fossil-commit`. +> ຄຳສັ່ງນີ້ເປັນອີກຊື່ໜຶ່ງຂອງຄຳສັ່ງ `fossil commit`. > ຂໍ້ມູນເພີ່ມເຕີມ: . - ເປີດເບິ່ງລາຍລະອຽດຂອງຄຳສັ່ງແບບເຕັມ: diff --git a/pages.lo/common/fossil-delete.md b/pages.lo/common/fossil-delete.md index 3f97df421..6a4d65b45 100644 --- a/pages.lo/common/fossil-delete.md +++ b/pages.lo/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > ຄຳສັ່ງນີ້ເປັນອີກຊື່ໜຶ່ງຂອງຄຳສັ່ງ `fossil rm`. > ຂໍ້ມູນເພີ່ມເຕີມ: . diff --git a/pages.lo/common/fossil-forget.md b/pages.lo/common/fossil-forget.md index dd9d7e779..a902ffa75 100644 --- a/pages.lo/common/fossil-forget.md +++ b/pages.lo/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > ຄຳສັ່ງນີ້ເປັນອີກຊື່ໜຶ່ງຂອງຄຳສັ່ງ `fossil rm`. > ຂໍ້ມູນເພີ່ມເຕີມ: . diff --git a/pages.lo/common/fossil-new.md b/pages.lo/common/fossil-new.md index 7f261bf6e..7b3a9d14a 100644 --- a/pages.lo/common/fossil-new.md +++ b/pages.lo/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> ຄຳສັ່ງນີ້ເປັນອີກຊື່ໜຶ່ງຂອງຄຳສັ່ງ `fossil-init`. +> ຄຳສັ່ງນີ້ເປັນອີກຊື່ໜຶ່ງຂອງຄຳສັ່ງ `fossil init`. > ຂໍ້ມູນເພີ່ມເຕີມ: . - ເປີດເບິ່ງລາຍລະອຽດຂອງຄຳສັ່ງແບບເຕັມ: diff --git a/pages.lo/common/gh-cs.md b/pages.lo/common/gh-cs.md index 812206519..0ddd82fc1 100644 --- a/pages.lo/common/gh-cs.md +++ b/pages.lo/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> ຄຳສັ່ງນີ້ເປັນອີກຊື່ໜຶ່ງຂອງຄຳສັ່ງ `gh-codespace`. +> ຄຳສັ່ງນີ້ເປັນອີກຊື່ໜຶ່ງຂອງຄຳສັ່ງ `gh codespace`. > ຂໍ້ມູນເພີ່ມເຕີມ: . - ເປີດເບິ່ງລາຍລະອຽດຂອງຄຳສັ່ງແບບເຕັມ: diff --git a/pages.lo/common/gnmic-sub.md b/pages.lo/common/gnmic-sub.md index 2acd695c3..7fdc66722 100644 --- a/pages.lo/common/gnmic-sub.md +++ b/pages.lo/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > ຄຳສັ່ງນີ້ເປັນອີກຊື່ໜຶ່ງຂອງຄຳສັ່ງ `gnmic subscribe`. > ຂໍ້ມູນເພີ່ມເຕີມ: . diff --git a/pages.lo/common/pio-init.md b/pages.lo/common/pio-init.md index 0399c7574..e4c287244 100644 --- a/pages.lo/common/pio-init.md +++ b/pages.lo/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > ຄຳສັ່ງນີ້ເປັນອີກຊື່ໜຶ່ງຂອງຄຳສັ່ງ `pio project`. diff --git a/pages.lo/common/tlmgr-arch.md b/pages.lo/common/tlmgr-arch.md index 541519c01..fc10c2da1 100644 --- a/pages.lo/common/tlmgr-arch.md +++ b/pages.lo/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > ຄຳສັ່ງນີ້ເປັນອີກຊື່ໜຶ່ງຂອງຄຳສັ່ງ `tlmgr platform`. > ຂໍ້ມູນເພີ່ມເຕີມ: . diff --git a/pages.lo/linux/ip-route-list.md b/pages.lo/linux/ip-route-list.md index 9d2b67301..1764d8b23 100644 --- a/pages.lo/linux/ip-route-list.md +++ b/pages.lo/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> ຄຳສັ່ງນີ້ເປັນອີກຊື່ໜຶ່ງຂອງຄຳສັ່ງ `ip-route-show`. +> ຄຳສັ່ງນີ້ເປັນອີກຊື່ໜຶ່ງຂອງຄຳສັ່ງ `ip route show`. - ເປີດເບິ່ງລາຍລະອຽດຂອງຄຳສັ່ງແບບເຕັມ: diff --git a/pages.ml/common/clamav.md b/pages.ml/common/clamav.md index ef46d6a78..8d43ff0fe 100644 --- a/pages.ml/common/clamav.md +++ b/pages.ml/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > ഈ കമാൻഡ് `clamdscan` എന്നത്തിന്റെ അപരനാമമാണ്. > കൂടുതൽ വിവരങ്ങൾ: . diff --git a/pages.ml/common/fossil-ci.md b/pages.ml/common/fossil-ci.md index fc441861b..adc32b6dd 100644 --- a/pages.ml/common/fossil-ci.md +++ b/pages.ml/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> ഈ കമാൻഡ് `fossil-commit` എന്നത്തിന്റെ അപരനാമമാണ്. +> ഈ കമാൻഡ് `fossil commit`.എന്നത്തിന്റെ അപരനാമമാണ്. > കൂടുതൽ വിവരങ്ങൾ: . - യഥാർത്ഥ കമാൻഡിനായി ഡോക്യുമെന്റേഷൻ കാണുക: diff --git a/pages.ml/common/fossil-delete.md b/pages.ml/common/fossil-delete.md index 5c5800412..81255ba39 100644 --- a/pages.ml/common/fossil-delete.md +++ b/pages.ml/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > ഈ കമാൻഡ് `fossil rm` എന്നത്തിന്റെ അപരനാമമാണ്. > കൂടുതൽ വിവരങ്ങൾ: . diff --git a/pages.ml/common/fossil-forget.md b/pages.ml/common/fossil-forget.md index a3036c91c..467338e09 100644 --- a/pages.ml/common/fossil-forget.md +++ b/pages.ml/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > ഈ കമാൻഡ് `fossil rm` എന്നത്തിന്റെ അപരനാമമാണ്. > കൂടുതൽ വിവരങ്ങൾ: . diff --git a/pages.ml/common/fossil-new.md b/pages.ml/common/fossil-new.md index 5abed24eb..d2dfbe45f 100644 --- a/pages.ml/common/fossil-new.md +++ b/pages.ml/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> ഈ കമാൻഡ് `fossil-init` എന്നത്തിന്റെ അപരനാമമാണ്. +> ഈ കമാൻഡ് `fossil init`.എന്നത്തിന്റെ അപരനാമമാണ്. > കൂടുതൽ വിവരങ്ങൾ: . - യഥാർത്ഥ കമാൻഡിനായി ഡോക്യുമെന്റേഷൻ കാണുക: diff --git a/pages.ml/common/gh-cs.md b/pages.ml/common/gh-cs.md index ae1c13e10..f757e0226 100644 --- a/pages.ml/common/gh-cs.md +++ b/pages.ml/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> ഈ കമാൻഡ് `gh-codespace` എന്നത്തിന്റെ അപരനാമമാണ്. +> ഈ കമാൻഡ് `gh codespace`.എന്നത്തിന്റെ അപരനാമമാണ്. > കൂടുതൽ വിവരങ്ങൾ: . - യഥാർത്ഥ കമാൻഡിനായി ഡോക്യുമെന്റേഷൻ കാണുക: diff --git a/pages.ml/common/gnmic-sub.md b/pages.ml/common/gnmic-sub.md index 94caa4015..18fb16901 100644 --- a/pages.ml/common/gnmic-sub.md +++ b/pages.ml/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > ഈ കമാൻഡ് `gnmic subscribe` എന്നത്തിന്റെ അപരനാമമാണ്. > കൂടുതൽ വിവരങ്ങൾ: . diff --git a/pages.ml/common/pio-init.md b/pages.ml/common/pio-init.md index fdcf17f7e..7aa04feef 100644 --- a/pages.ml/common/pio-init.md +++ b/pages.ml/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > ഈ കമാൻഡ് `pio project` എന്നത്തിന്റെ അപരനാമമാണ്. diff --git a/pages.ml/common/tlmgr-arch.md b/pages.ml/common/tlmgr-arch.md index 8895bf9c9..9000913ce 100644 --- a/pages.ml/common/tlmgr-arch.md +++ b/pages.ml/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > ഈ കമാൻഡ് `tlmgr platform` എന്നത്തിന്റെ അപരനാമമാണ്. > കൂടുതൽ വിവരങ്ങൾ: . diff --git a/pages.ml/linux/ip-route-list.md b/pages.ml/linux/ip-route-list.md index 36d744fa1..fd33df51d 100644 --- a/pages.ml/linux/ip-route-list.md +++ b/pages.ml/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> ഈ കമാൻഡ് `ip-route-show` എന്നത്തിന്റെ അപരനാമമാണ്. +> ഈ കമാൻഡ് `ip route show`.എന്നത്തിന്റെ അപരനാമമാണ്. - യഥാർത്ഥ കമാൻഡിനായി ഡോക്യുമെന്റേഷൻ കാണുക: diff --git a/pages.ne/common/cat.md b/pages.ne/common/cat.md index 2ed607540..8f7afde01 100644 --- a/pages.ne/common/cat.md +++ b/pages.ne/common/cat.md @@ -1,7 +1,7 @@ # cat > फाइलहरू देखाउनुहोस् र जोड्नुहोस्। -> थप जानकारी: । +> थप जानकारी: । - फाइल भित्रका कुराहरुलाई मानक आउटपुटमा देखाउनुहोस्: diff --git a/pages.ne/common/clamav.md b/pages.ne/common/clamav.md index b5d0140dc..e0d1aadd6 100644 --- a/pages.ne/common/clamav.md +++ b/pages.ne/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > यो आदेश `clamdscan` को उपनाम हो | > थप जानकारी: । diff --git a/pages.ne/common/fossil-ci.md b/pages.ne/common/fossil-ci.md index 0cf9efb9e..b5b3597ca 100644 --- a/pages.ne/common/fossil-ci.md +++ b/pages.ne/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> यो आदेश `fossil-commit` को उपनाम हो | +> यो आदेश `fossil commit`.को उपनाम हो | > थप जानकारी: । - मौलिक आदेशको लागि कागजात हेर्नुहोस्: diff --git a/pages.ne/common/fossil-delete.md b/pages.ne/common/fossil-delete.md index 17a53a892..7b5312d4d 100644 --- a/pages.ne/common/fossil-delete.md +++ b/pages.ne/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > यो आदेश `fossil rm` को उपनाम हो | > थप जानकारी: । diff --git a/pages.ne/common/fossil-forget.md b/pages.ne/common/fossil-forget.md index 82477f924..ea20916d0 100644 --- a/pages.ne/common/fossil-forget.md +++ b/pages.ne/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > यो आदेश `fossil rm` को उपनाम हो | > थप जानकारी: । diff --git a/pages.ne/common/fossil-new.md b/pages.ne/common/fossil-new.md index 949528949..1a72e833f 100644 --- a/pages.ne/common/fossil-new.md +++ b/pages.ne/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> यो आदेश `fossil-init` को उपनाम हो | +> यो आदेश `fossil init`.को उपनाम हो | > थप जानकारी: । - मौलिक आदेशको लागि कागजात हेर्नुहोस्: diff --git a/pages.ne/common/gh-cs.md b/pages.ne/common/gh-cs.md index 43992fc6f..aba52f099 100644 --- a/pages.ne/common/gh-cs.md +++ b/pages.ne/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> यो आदेश `gh-codespace` को उपनाम हो | +> यो आदेश `gh codespace`.को उपनाम हो | > थप जानकारी: । - मौलिक आदेशको लागि कागजात हेर्नुहोस्: diff --git a/pages.ne/common/gnmic-sub.md b/pages.ne/common/gnmic-sub.md index 9a107477a..4db4b9248 100644 --- a/pages.ne/common/gnmic-sub.md +++ b/pages.ne/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > यो आदेश `gnmic subscribe` को उपनाम हो | > थप जानकारी: । diff --git a/pages.ne/common/pio-init.md b/pages.ne/common/pio-init.md index d2c9da4e9..727873937 100644 --- a/pages.ne/common/pio-init.md +++ b/pages.ne/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > यो आदेश `pio project` को उपनाम हो | diff --git a/pages.ne/common/tlmgr-arch.md b/pages.ne/common/tlmgr-arch.md index 25083aea4..e6edcb4ae 100644 --- a/pages.ne/common/tlmgr-arch.md +++ b/pages.ne/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > यो आदेश `tlmgr platform` को उपनाम हो | > थप जानकारी: । diff --git a/pages.ne/linux/ip-route-list.md b/pages.ne/linux/ip-route-list.md index a26dc2c49..8363596d0 100644 --- a/pages.ne/linux/ip-route-list.md +++ b/pages.ne/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> यो आदेश `ip-route-show` को उपनाम हो | +> यो आदेश `ip route show`.को उपनाम हो | - मौलिक आदेशको लागि कागजात हेर्नुहोस्: diff --git a/pages.nl/android/logcat.md b/pages.nl/android/logcat.md index cb5a556d8..b1507c279 100644 --- a/pages.nl/android/logcat.md +++ b/pages.nl/android/logcat.md @@ -17,8 +17,8 @@ - Toon logs voor een specifieke PID: -`logcat --pid={{pid}}` +`logcat --pid {{pid}}` - Toon logs voor een proces van een specifiek pakket: -`logcat --pid=$(pidof -s {{pakket}})` +`logcat --pid $(pidof -s {{pakket}})` diff --git a/pages.nl/android/wm.md b/pages.nl/android/wm.md index 399703762..b4dfa4903 100644 --- a/pages.nl/android/wm.md +++ b/pages.nl/android/wm.md @@ -6,8 +6,8 @@ - Toon de fysieke grootte van het scherm van een Android-apparaat: -`wm {{size}}` +`wm size` - Toon de fysieke dichtheid van het scherm van een Android-apparaat: -`wm {{density}}` +`wm density` diff --git a/pages.nl/common/!.md b/pages.nl/common/!.md index eba38804b..869e3c6c0 100644 --- a/pages.nl/common/!.md +++ b/pages.nl/common/!.md @@ -7,13 +7,13 @@ `sudo !!` -- Vervang met een commando op basis van het lijnnummer gevonden met`history`: +- Vervang met een commando op basis van het regelnummer gevonden met `history`: -`!{{number}}` +`!{{nummer}}` - Vervang met een commando dat een bepaald aantal regels terug werd gebruikt: -`!-{{number}}` +`!-{{nummer}}` - Vervang met het meest recente commando die begint met string: @@ -21,4 +21,8 @@ - Vervang met de argumenten van het laatste commando: -`{{command}} !*` +`{{commando}} !*` + +- Substitute met het laatste argument van het laatste commando:: + +`{{commando}} !$` diff --git a/pages.nl/common/2to3.md b/pages.nl/common/2to3.md index 5d48ef451..46901a491 100644 --- a/pages.nl/common/2to3.md +++ b/pages.nl/common/2to3.md @@ -13,11 +13,11 @@ - Converteer specifieke Python 2-taalfuncties naar Python 3: -`2to3 --write {{pad/naar/bestand.py}} --fix={{raw_input}} --fix={{print}}` +`2to3 --write {{pad/naar/bestand.py}} --fix {{raw_input}} --fix {{print}}` - Converteer alle Python 2-taalfuncties behalve de gespecificeerde naar Python 3: -`2to3 --write {{pad/naar/bestand.py}} --nofix={{has_key}} --nofix={{isinstance}}` +`2to3 --write {{pad/naar/bestand.py}} --nofix {{has_key}} --nofix {{isinstance}}` - Geef een lijst weer met alle beschikbare taalfuncties die kunnen worden geconverteerd van Python 2 naar Python 3: @@ -25,8 +25,8 @@ - Converteer alle Python 2-bestanden in een map naar Python 3: -`2to3 --output-dir={{pad/naar/python3_map}} --write-unchanged-files --nobackups {{pad/naar/python2_map}}` +`2to3 --output-dir {{pad/naar/python3_map}} --write-unchanged-files --nobackups {{pad/naar/python2_map}}` - Voer 2to3 uit met meerdere threads: -`2to3 --processes={{4}} --output-dir={{pad/naar/python3_map}} --write --nobackups --no-diff {{pad/naar/python2_map}}` +`2to3 --processes {{4}} --output-dir {{pad/naar/python3_map}} --write --nobackups --no-diff {{pad/naar/python2_map}}` diff --git a/pages.nl/common/7zr.md b/pages.nl/common/7zr.md index d2f6e715b..af56b1422 100644 --- a/pages.nl/common/7zr.md +++ b/pages.nl/common/7zr.md @@ -1,7 +1,7 @@ # 7zr > Bestandsarchiver met een hoge compressieverhouding. -> Vergelijkbaar met `7z`, behalve dat het alleen `.7z`-bestanden ondersteunt. +> Vergelijkbaar met `7z`, behalve dat het alleen 7z-bestanden ondersteunt. > Meer informatie: . - Archiveer een bestand of map: diff --git a/pages.nl/common/^.md b/pages.nl/common/^.md new file mode 100644 index 000000000..c26c5ee8b --- /dev/null +++ b/pages.nl/common/^.md @@ -0,0 +1,17 @@ +# Caret + +> Bash ingebouwd commando om snel een string in het vorige commando te vervangen en het resultaat uit te voeren. +> Equivalent aan `!!:s^string1^string2`. +> Meer informatie: . + +- Voer het vorige commando uit waarbij `string1` wordt vervangen door `string2`: + +`^{{string1}}^{{string2}}` + +- Verwijder `string1` uit het vorige commando: + +`^{{string1}}^` + +- Vervang `string1` door `string2` in het vorige commando en voeg `string3` toe aan het einde ervan: + +`^{{string1}}^{{string2}}^{{string3}}` diff --git a/pages.nl/common/a2ping.md b/pages.nl/common/a2ping.md index 90241621d..15921a494 100644 --- a/pages.nl/common/a2ping.md +++ b/pages.nl/common/a2ping.md @@ -3,7 +3,7 @@ > Converteer afbeeldingen in EPS- of PDF-bestanden. > Meer informatie: . -- Converteer een afbeelding naar PDF (Opmerking: het opgeven van een uitvoerbestandsnaam is optioneel): +- Converteer een afbeelding naar PDF (Let op: het opgeven van een uitvoerbestandsnaam is optioneel): `a2ping {{pad/naar/afbeelding.ext}} {{pad/naar/uitvoer.pdf}}` @@ -11,11 +11,11 @@ `a2ping --nocompress {{none|zip|best|flate}} {{pad/naar/bestand}}` -- Scan HiResBoundingBox indien aanwezig (Opmerking: de standaard is yes): +- Scan HiResBoundingBox indien aanwezig (Let op: de standaard is yes): `a2ping --nohires {{pad/naar/bestand}}` -- Sta pagina-inhoud onder en links van de oorsprong toe (Opmerking: de standaard is no): +- Sta pagina-inhoud onder en links van de oorsprong toe (Let op: de standaard is no): `a2ping --below {{pad/naar/bestand}}` diff --git a/pages.nl/common/ac.md b/pages.nl/common/ac.md index a9fd0c162..29f7b3e36 100644 --- a/pages.nl/common/ac.md +++ b/pages.nl/common/ac.md @@ -1,20 +1,20 @@ # ac -> Druk statistieken af over hoe lang gebruikers verbonden zijn geweest. +> Toon statistieken over hoe lang gebruikers verbonden zijn geweest. > Meer informatie: . -- Druk af hoe lang de huidige gebruiker verbonden is in uren: +- Toon hoe lang de huidige gebruiker verbonden is in uren: `ac` -- Druk af hoe lang gebruikers verbonden zijn in uren: +- Toon hoe lang gebruikers verbonden zijn in uren: `ac -p` -- Druk af hoe lang een bepaalde gebruiker verbonden is in uren: +- Toon hoe lang een bepaalde gebruiker verbonden is in uren: `ac -p {{gebruikersnaam}}` -- Print hoe lang een bepaalde gebruiker verbonden is in uren per dag (met totaal): +- Toon hoe lang een bepaalde gebruiker verbonden is in uren per dag (met totaal): `ac -dp {{gebruikersnaam}}` diff --git a/pages.nl/common/accelerate.md b/pages.nl/common/accelerate.md index c5d436164..4d56fc2c2 100644 --- a/pages.nl/common/accelerate.md +++ b/pages.nl/common/accelerate.md @@ -11,7 +11,7 @@ `accelerate config` -- Druk de geschatte GPU-geheugenkosten af van het uitvoeren van een Hugging Face model met verschillende gegevenstypen: +- Toon de geschatte GPU-geheugenkosten van het uitvoeren van een Hugging Face model met verschillende gegevenstypen: `accelerate estimate-memory {{name/model}}` diff --git a/pages.nl/common/ack.md b/pages.nl/common/ack.md index cd276bf5e..0e01bd1b8 100644 --- a/pages.nl/common/ack.md +++ b/pages.nl/common/ack.md @@ -1,7 +1,7 @@ # ack > Een zoektool zoals grep, geoptimaliseerd voor ontwikkelaars. -> Zie ook: `rg`, dat is veel sneller. +> Bekijk ook: `rg`, dat is veel sneller. > Meer informatie: . - Zoek recursief naar bestanden met een tekenreeks of reguliere expressie in de huidige map: @@ -18,17 +18,17 @@ - Beperk het zoeken tot bestanden van een specifiek type: -`ack --type={{ruby}} "{{zoekpatroon}}"` +`ack --type {{ruby}} "{{zoekpatroon}}"` - Zoek niet in bestanden van een specifiek type: -`ack --type=no{{ruby}} "{{zoekpatroon}}"` +`ack --type no{{ruby}} "{{zoekpatroon}}"` - Tel het totaal aantal gevonden matches: `ack --count --no-filename "{{zoekpatroon}}"` -- Druk alleen voor elk bestand de bestandsnamen en het aantal overeenkomsten af: +- Toon alleen voor elk bestand de bestandsnamen en het aantal overeenkomsten: `ack --count --files-with-matches "{{zoekpatroon}}"` diff --git a/pages.nl/common/acme.sh.md b/pages.nl/common/acme.sh.md index 02bdb5eaf..a5b2a39a1 100644 --- a/pages.nl/common/acme.sh.md +++ b/pages.nl/common/acme.sh.md @@ -1,7 +1,7 @@ # acme.sh > Shell-script dat het ACME-clientprotocol implementeert, een alternatief voor `certbot`. -> Zie ook `acme.sh dns`. +> Bekijk ook `acme.sh dns`. > Meer informatie: . - Geef een certificaat uit met behulp van de webroot-modus: diff --git a/pages.nl/common/adb-logcat.md b/pages.nl/common/adb-logcat.md index 57e0747d8..e94f13d9b 100644 --- a/pages.nl/common/adb-logcat.md +++ b/pages.nl/common/adb-logcat.md @@ -25,11 +25,11 @@ - Geef logboeken weer voor een specifiek proces: -`adb logcat --pid={{pid}}` +`adb logcat --pid {{pid}}` - Logboeken weergeven voor het proces van een specifiek pakket: -`adb logcat --pid=$(adb shell pidof -s {{pakket}})` +`adb logcat --pid $(adb shell pidof -s {{pakket}})` - Kleur de log in (gebruik meestal met filters): diff --git a/pages.nl/common/adscript.md b/pages.nl/common/adscript.md index 218f3a9c9..82dcf5d92 100644 --- a/pages.nl/common/adscript.md +++ b/pages.nl/common/adscript.md @@ -5,7 +5,7 @@ - Compileer een bestand naar een objectbestand: -`adscript --output {{pad/naar/bestand.o}} {{pad/naar/input_file.adscript}}` +`adscript --output {{pad/naar/bestand.o}} {{pad/naar/invoer_bestand.adscript}}` - Compileer en koppel een bestand aan een zelfstandig uitvoerbaar bestand: diff --git a/pages.nl/common/airodump-ng.md b/pages.nl/common/airodump-ng.md index 469b81b97..e52313675 100644 --- a/pages.nl/common/airodump-ng.md +++ b/pages.nl/common/airodump-ng.md @@ -4,10 +4,18 @@ > Deel van `aircrack-ng`. > Meer informatie: . -- Leg pakketten vast en geef informatie weer over een draadloos netwerk: +- Leg pakketten vast en geef informatie weer over draadloze netwerken op de 2.4GHz band: `sudo airodump-ng {{interface}}` +- Leg pakketten vast en geef informatie weer over draadloze netwerken op de 5GHz band: + +`sudo airodump-ng {{interface}} --band a` + +- Leg pakketten vast en geef informatie weer over draadloze netwerken op de 2.4GHz en de 5GHz band: + +`sudo airodump-ng {{interface}} --band abg` + - Leg pakketten vast en geef informatie weer over een draadloos netwerk met het MAC-adres en kanaal, en sla de uitvoer op in een bestand: `sudo airodump-ng --channel {{kanaal}} --write {{pad/naar/bestand}} --bssid {{mac}} {{interface}}` diff --git a/pages.nl/common/alacritty.md b/pages.nl/common/alacritty.md index f043e2ec0..5f33c747e 100644 --- a/pages.nl/common/alacritty.md +++ b/pages.nl/common/alacritty.md @@ -15,10 +15,10 @@ `alacritty -e {{bevel}}` -- Geef een alternatief configuratiebestand op (standaard ingesteld op `$XDG_CONFIG_HOME/alacritty/alacritty.yml`): +- Geef een alternatief configuratiebestand op (standaard ingesteld op `$XDG_CONFIG_HOME/alacritty/alacritty.toml`): -`alacritty --config-file {{pad/naar/config.yml}}` +`alacritty --config-file {{pad/naar/config.toml}}` -- Uitvoeren met live config reload ingeschakeld (kan ook standaard worden ingeschakeld in `alacritty.yml`): +- Uitvoeren met live config reload ingeschakeld (kan ook standaard worden ingeschakeld in `alacritty.toml`): -`alacritty --live-config-reload --config-file {{pad/naar/config.yml}}` +`alacritty --live-config-reload --config-file {{pad/naar/config.toml}}` diff --git a/pages.nl/common/amass-db.md b/pages.nl/common/amass-db.md deleted file mode 100644 index a6df40a84..000000000 --- a/pages.nl/common/amass-db.md +++ /dev/null @@ -1,20 +0,0 @@ -# amass db - -> Interactie met een Amass database. -> Meer informatie: . - -- Toon alle uitgevoerde opsommingen in de database: - -`amass db -dir {{pad/naar/database_map}} -list` - -- Toon de resultaten van een specifieke opsommingsindex en domeinnaam: - -`amass db -dir {{pad/naar/database_map}} -d {{domeinnaam}} -enum {{indexlijst}} -show` - -- Toon alle gevonden subdomeinen van een domeinnaam binnen de opsomming: - -`amass db -dir {{pad/naar/database_map}} -d {{domeinnaam}} -enum {{indexlijst}} -names` - -- Toon een samenvatting van de gevonden subdomeinen binnen de opsomming: - -`amass db -dir {{pad/naar/database_map}} -d {{domeinnaam}} -enum {{indexlijst}} -summary` diff --git a/pages.nl/common/amass-enum.md b/pages.nl/common/amass-enum.md index aa487b67c..4bc8064f0 100644 --- a/pages.nl/common/amass-enum.md +++ b/pages.nl/common/amass-enum.md @@ -1,17 +1,17 @@ # amass enum > Vind subdomeinen van een domein. -> Meer informatie: . +> Meer informatie: . -- Vind, passief, subdomeinen van een domein: +- Vind, passief, subdomeinen van een [d]omein: -`amass enum -passive -d {{domeinnaam}}` +`amass enum -d {{domeinnaam}}` -- Zoek subdomeinen van een domein en verifieer ze actief in een poging de gevonden subdomeinen op te lossen: +- Zoek subdomeinen van een [d]omein en verifieer ze actief in een poging de gevonden subdomeinen op te lossen: `amass enum -active -d {{domeinnaam}} -p {{80,443,8080}}` -- Doe een brute force zoekopdracht op een subdomein: +- Doe een brute force zoekopdracht op een sub[d]omein: `amass enum -brute -d {{domeinnaam}}` @@ -19,6 +19,10 @@ `amass enum -o {{uitvoer_bestand}} -d {{domeinnaam}}` -- Sla de resultaten op in een database: +- Sla de resultaten op in een database en andere gedetailleerde output naar een map: -`amass enum -o {{uitvoer_bestand}} -dir {{pad/naar/database_map}}` +`amass enum -o {{uitvoer_bestand}} -dir {{pad/naar/database_map}} -d {{domeinnaam}}` + +- Toon alle beschikbare databronnen: + +`amass enum -list` diff --git a/pages.nl/common/amass-intel.md b/pages.nl/common/amass-intel.md index d448dd5fe..6c9cecd4c 100644 --- a/pages.nl/common/amass-intel.md +++ b/pages.nl/common/amass-intel.md @@ -1,7 +1,7 @@ # amass intel > Verzamel open source informatie over een organisatie, zoals hoofddomeinen en ASN's. -> Meer informatie: . +> Meer informatie: . - Vind hoofddomeinen in een range van IP adressen: @@ -15,7 +15,7 @@ `amass intel -whois -d {{domeinnaam}}` -- Vind ASN's die bij een organisatie horen: +- Vind ASN's die bij een [org]anisatie horen: `amass intel -org {{organisatienaam}}` @@ -26,3 +26,7 @@ - Sla de resultaten op in een tekstbestand: `amass intel -o {{uitvoer_bestand}} -whois -d {{domeinnaam}}` + +- Toon alle beschikbare databronnen: + +`amass intel -list` diff --git a/pages.nl/common/amass.md b/pages.nl/common/amass.md index 65b05ac45..71675301a 100644 --- a/pages.nl/common/amass.md +++ b/pages.nl/common/amass.md @@ -1,20 +1,20 @@ # amass > Uitgebreide tool voor Attack Surface Mapping en Asset Discovery. -> Sommige subcommando's zoals `amass db` hebben hun eigen documentatie. -> Meer informatie: . +> Sommige subcommando's zoals `amass intel` hebben hun eigen documentatie. +> Meer informatie: . - Voer een Amass subcommando uit: -`amass {{subcommando}}` +`amass {{intel|enum}} {{opties}}` - Toon de generieke help pagina: `amass -help` -- Toon de help pagina van een subcommando (zoals `intel`, `enum` etc.): +- Toon de help pagina van een subcommando: -`amass -help {{subcommando}}` +`amass {{intel|enum}} -help` - Toon de huidige versie: diff --git a/pages.nl/common/arch.md b/pages.nl/common/arch.md index 4fe42be5c..359dc7e41 100644 --- a/pages.nl/common/arch.md +++ b/pages.nl/common/arch.md @@ -1,7 +1,7 @@ # arch > Geef de naam van de systeemarchitectuur weer. -> Zie ook `uname`. +> Bekijk ook `uname`. > Meer informatie: . - Geef de architectuur van het systeem weer: diff --git a/pages.nl/common/azure-cli.md b/pages.nl/common/azure-cli.md index 0c16467fd..3a3d5bbaf 100644 --- a/pages.nl/common/azure-cli.md +++ b/pages.nl/common/azure-cli.md @@ -1,4 +1,4 @@ -# azure cli +# azure-cli > Dit commando is een alias van `az`. > Meer informatie: . diff --git a/pages.nl/common/base32.md b/pages.nl/common/base32.md index df86d8a88..d1e8b6751 100644 --- a/pages.nl/common/base32.md +++ b/pages.nl/common/base32.md @@ -7,6 +7,10 @@ `base32 {{pad/naar/bestand}}` +- Zet gecodeerde uitvoer naar een specifieke breedte (`0` schakelt het uit): + +`base32 --wrap {{0|76|...}} {{pad/naar/bestand}}` + - Decodeer een bestand: `base32 --decode {{pad/naar/bestand}}` diff --git a/pages.nl/common/base64.md b/pages.nl/common/base64.md index 00a9a7d40..a786fccf2 100644 --- a/pages.nl/common/base64.md +++ b/pages.nl/common/base64.md @@ -7,6 +7,10 @@ `base64 {{bestandsnaam}}` +- Zet gecodeerde uitvoer naar een specifieke breedte (`0` schakelt het uit): + +`base64 --wrap {{0|76|...}} {{pad/naar/bestand}}` + - Decodeer een bestand: `base64 --decode {{bestandsnaam}}` diff --git a/pages.nl/common/bat.md b/pages.nl/common/bat.md index 7d0ee92d7..039163002 100644 --- a/pages.nl/common/bat.md +++ b/pages.nl/common/bat.md @@ -10,20 +10,28 @@ - Voeg verschillende bestanden samen in het doelbestand: -`bat {{pad/naar/bestand1 pad/naar/bestand2 ...}} > {{doelbestand}}` +`bat {{pad/naar/bestand1 pad/naar/bestand2 ...}} > {{pad/naar/doelbestand}}` -- Voeg verschillende bestanden toe aan het doelbestand: +- Verwijder decoraties en schakel paging uit (`--style plain` kan vervangen worden met `-p` of beide opties met `-pp`): -`bat {{pad/naar/bestand1 pad/naar/bestand2 ...}} >> {{doelbestand}}` +`bat --style plain --pager never {{pad/naar/bestand}}` + +- Highlight een specifieke regel of een reeks van regels met een andere achtergrondkleur: + +`bat {{--highlight-line|-H}} {{10|5:10|:10|10:|10:+5}} {{pad/naar/bestand}}` + +- Toon niet-printbare karakters zoals spatie, tab of witregel: + +`bat {{--show-all|-A}} {{pad/naar/bestand}}` - Nummer alle uitvoerregels: -`bat --number {{pad/naar/bestand}}` +`bat {{--number|-n}} {{pad/naar/bestand}}` - Highlight de syntax van een JSON-bestand: -`bat --language json {{pad/naar/bestand.json}}` +`bat {{--language|-l}} json {{pad/naar/bestand.json}}` - Toon alle ondersteunde talen: -`bat --list-languages` +`bat {{--list-languages|-L}}` diff --git a/pages.nl/common/bmptopnm.md b/pages.nl/common/bmptopnm.md new file mode 100644 index 000000000..abf98cdc9 --- /dev/null +++ b/pages.nl/common/bmptopnm.md @@ -0,0 +1,16 @@ +# bmptopnm + +> Converteer een BMP bestand naar een PBM, PGM of PNM afbeelding. +> Meer informatie: . + +- Genereer de PBM, PGM of PNM afbeelding als output, vanuit een Windows of OS/2 BMP afbeelding als input: + +`bmptopnm {{pad/naar/bestand.bmp}}` + +- Rapporteer de inhoud van een BMP header naar `stderr`: + +`bmptopnm -verbose {{pad/naar/bestand.bmp}}` + +- Toon de versie: + +`bmptopnm -version` diff --git a/pages.nl/common/bmptoppm.md b/pages.nl/common/bmptoppm.md new file mode 100644 index 000000000..6127ae32b --- /dev/null +++ b/pages.nl/common/bmptoppm.md @@ -0,0 +1,8 @@ +# bmptoppm + +> Dit commando is vervangen door `bmptopnm`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr bmptopnm` diff --git a/pages.nl/common/cal.md b/pages.nl/common/cal.md new file mode 100644 index 000000000..28a42154c --- /dev/null +++ b/pages.nl/common/cal.md @@ -0,0 +1,17 @@ +# cal + +> Toon een kalender met de huidige dag gemarkeerd. +> Bekijk ook: `gcal`. +> Meer informatie: . + +- Toon een kalender voor de huidige maand: + +`cal` + +- Toon een kalender voor een specifiek jaar: + +`cal {{jaar}}` + +- Toon een kalender voor een specifieke maand en jaar: + +`cal {{maand}} {{jaar}}` diff --git a/pages.nl/common/cat.md b/pages.nl/common/cat.md index cff255372..865de82dc 100644 --- a/pages.nl/common/cat.md +++ b/pages.nl/common/cat.md @@ -1,7 +1,7 @@ # cat > Toon en voeg bestanden samen. -> Meer informatie: . +> Meer informatie: . - Toon de inhoud van een bestand in `stdout`: diff --git a/pages.nl/common/chgrp.md b/pages.nl/common/chgrp.md index a5c4778bc..d62787eb2 100644 --- a/pages.nl/common/chgrp.md +++ b/pages.nl/common/chgrp.md @@ -17,4 +17,4 @@ - Verander de beheerdersgroep van een bestand/map naar de permissies van een referentiebestand: -`chgrp --reference={{pad/naar/referentiebestand}} {{pad/naar/bestand_of_map}}` +`chgrp --reference {{pad/naar/referentiebestand}} {{pad/naar/bestand_of_map}}` diff --git a/pages.nl/common/chown.md b/pages.nl/common/chown.md index b6dfa1ad1..7cd1e7569 100644 --- a/pages.nl/common/chown.md +++ b/pages.nl/common/chown.md @@ -11,6 +11,10 @@ `chown {{gebruiker}}:{{groep}} {{pad/naar/bestand_of_map}}` +- Verander de gebruikersbeheerder en -groep zodat beiden de naam `user` krijgen: + +`chown {{user}}: {{pad/naar/bestand_of_map}}` + - Verander recursief de beheerder van een map en alle inhoud: `chown -R {{gebruiker}} {{pad/naar/bestand_of_map}}` @@ -21,4 +25,4 @@ - Verander de beheerder van een bestand of map naar dezelfde als een referentiebestand: -`chown --reference={{pad/naar/referentiebestand}} {{pad/naar/bestand_of_map}}` +`chown --reference {{pad/naar/referentiebestand}} {{pad/naar/bestand_of_map}}` diff --git a/pages.nl/common/cksum.md b/pages.nl/common/cksum.md index ffdbb07f7..85fdf2120 100644 --- a/pages.nl/common/cksum.md +++ b/pages.nl/common/cksum.md @@ -1,7 +1,7 @@ # cksum > Bereken de CRC checksums en het aantal bytes van een bestand. -> Opmerking: op oudere UNIX systemen kan de CRC implementatie verschillen. +> Let op: op oudere UNIX systemen kan de CRC implementatie verschillen. > Meer informatie: . - Toon een 32-bit checksum, grootte in bytes en bestandsnaam: diff --git a/pages.nl/common/clang++.md b/pages.nl/common/clang++.md index e86df37bd..315cb113e 100644 --- a/pages.nl/common/clang++.md +++ b/pages.nl/common/clang++.md @@ -22,7 +22,7 @@ - Compileer broncode naar LLVM Intermediate Representation (IR): -`clang++ -S -emit-llvm {{pad/naar/bron.cpp}} -o {{pad/naar/output.ll}}` +`clang++ -S -emit-llvm {{pad/naar/bron.cpp}} -o {{pad/naar/uitvoer.ll}}` - Optimaliseer het gecompileerde programma voor prestaties: diff --git a/pages.nl/common/compare.md b/pages.nl/common/compare.md new file mode 100644 index 000000000..aec28648e --- /dev/null +++ b/pages.nl/common/compare.md @@ -0,0 +1,7 @@ +# compare + +> Dit commando is een alias van `magick compare`. + +- Bekijk de documentatie van het originele commando: + +`tldr magick compare` diff --git a/pages.nl/common/convert.md b/pages.nl/common/convert.md new file mode 100644 index 000000000..5e4c83c20 --- /dev/null +++ b/pages.nl/common/convert.md @@ -0,0 +1,9 @@ +# convert + +> Dit commando is een alias van `magick convert`. +> Let op: deze alias is verouderd sinds ImageMagick 7. Het is vervangen door `magick`. +> Gebruik `magick convert` als je de oude tool wilt gebruiken in versies 7+. + +- Bekijk de documentatie van het originele commando: + +`tldr magick convert` diff --git a/pages.nl/common/cut.md b/pages.nl/common/cut.md index c1de718f4..15f13e775 100644 --- a/pages.nl/common/cut.md +++ b/pages.nl/common/cut.md @@ -5,12 +5,16 @@ - Toon een specifiek karakter/veldbereik voor iedere regel: -`{{commando}} | cut --{{characters|fields}}={{1|1,10|1-10|1-|-10}}` +`{{commando}} | cut --{{characters|fields}} {{1|1,10|1-10|1-|-10}}` - Toon een bereik voor iedere regel met een specifieke scheiding: -`{{commando}} | cut --delimiter="{{,}}" --fields={{1}}` +`{{commando}} | cut --delimiter "{{,}}" --fields {{1}}` - Toon een bereik van iedere regel voor een specifiek bestand: -`cut --characters={{1}} {{pad/naar/bestand}}` +`cut --characters {{1}} {{pad/naar/bestand}}` + +- Toon specifieke velden van `NUL` afgesloten regels (bijv. zoals in `find . -print0`) in plaats van nieuwe regels: + +`{{command}} | cut --zero-terminated --fields {{1}}` diff --git a/pages.nl/common/date.md b/pages.nl/common/date.md new file mode 100644 index 000000000..c1cb49b08 --- /dev/null +++ b/pages.nl/common/date.md @@ -0,0 +1,36 @@ +# date + +> Stel de systeemdatum in of toon deze. +> Meer informatie: . + +- Toon de huidige datum in het standaardformaat van de locale: + +`date +%c` + +- Toon de huidige datum in UTC, in het ISO 8601-formaat: + +`date -u +%Y-%m-%dT%H:%M:%S%Z` + +- Toon de huidige datum als een Unix timestamp (seconden sinds de Unix-epoch): + +`date +%s` + +- Converteer een datum gespecificeerd als een Unix timestamp naar het standaard formaat: + +`date -d @{{1473305798}}` + +- Converteer een opgegeven datum naar het Unix timestamp formaat: + +`date -d "{{2018-09-01 00:00}}" +%s --utc` + +- Toon de huidige datum in het RFC-3339 formaat (`YYYY-MM-DD hh:mm:ss TZ`): + +`date --rfc-3339 s` + +- Stel de huidige datum in met het formaat `MMDDhhmmYYYY.ss` (`YYYY` en `.ss` zijn optioneel): + +`date {{093023592021.59}}` + +- Toon het huidige ISO-weeknummer: + +`date +%V` diff --git a/pages.nl/common/dd.md b/pages.nl/common/dd.md new file mode 100644 index 000000000..c617fb3d3 --- /dev/null +++ b/pages.nl/common/dd.md @@ -0,0 +1,24 @@ +# dd + +> Converteer en kopieer een bestand. +> Meer informatie: . + +- Maak een opstartbare USB-schijf van een isohybrid-bestand (zoals `archlinux-xxx.iso`) en toon de voortgang: + +`dd if={{pad/naar/bestand.iso}} of={{/dev/usb_schijf}} status=progress` + +- Kopieer een schijf naar een andere schijf met een blokgrootte van 4 MiB en schrijf alle gegevens voordat het commando eindigt: + +`dd bs=4194304 conv=fsync if={{/dev/bron_schijf}} of={{/dev/doel_schijf}}` + +- Genereer een bestand met een specifiek aantal willekeurige bytes met behulp van de kernel random driver: + +`dd bs={{100}} count={{1}} if=/dev/urandom of={{pad/naar/willekeurig_bestand}}` + +- Benchmark de sequentiële schrijfsnelheid van een schijf: + +`dd bs={{1024}} count={{1000000}} if=/dev/zero of={{pad/naar/bestand_1GB}}` + +- Maak een systeemback-up, sla deze op in een IMG bestand (kan later worden hersteld door `if` en `of` om te wisselen) en toon de voortgang: + +`dd if={{/dev/schijf_apparaat}} of={{pad/naar/bestand.img}} status=progress` diff --git a/pages.nl/common/dircolors.md b/pages.nl/common/dircolors.md new file mode 100644 index 000000000..9363fa300 --- /dev/null +++ b/pages.nl/common/dircolors.md @@ -0,0 +1,24 @@ +# dircolors + +> Geef commando's weer om de LS_COLOR-omgevingsvariabele in te stellen en style `ls`, `dir` enz. +> Meer informatie: . + +- Geef commando's weer om LS_COLOR in te stellen met standaardkleuren: + +`dircolors` + +- Geef commando's weer om LS_COLOR in te stellen met kleuren uit een bestand: + +`dircolors {{pad/naar/bestand}}` + +- Geef commando's weer voor de Bourne-shell: + +`dircolors --bourne-shell` + +- Geef commando's weer voor de C-shell: + +`dircolors --c-shell` + +- Bekijk de standaardkleuren voor bestandstypen en extensies: + +`dircolors --print-data` diff --git a/pages.nl/common/dirname.md b/pages.nl/common/dirname.md new file mode 100644 index 000000000..001669a97 --- /dev/null +++ b/pages.nl/common/dirname.md @@ -0,0 +1,16 @@ +# dirname + +> Berekent de bovenliggende map van een bestand of map. +> Meer informatie: . + +- Bereken de bovenliggende map van een opgegeven pad: + +`dirname {{pad/naar/bestand_of_map}}` + +- Bereken de bovenliggende map van meerdere paden: + +`dirname {{pad/naar/bestand_of_map1 pad/naar/bestand_of_map2 ...}}` + +- Scheid de uitvoer met een NUL-teken in plaats van een nieuwe regel (handig bij gebruik met `xargs`): + +`dirname --zero {{pad/naar/bestand_of_map1 pad/naar/bestand_of_map2 ...}}` diff --git a/pages.nl/common/docker-rm.md b/pages.nl/common/docker-rm.md index 8ce5c0765..33cf278d0 100644 --- a/pages.nl/common/docker-rm.md +++ b/pages.nl/common/docker-rm.md @@ -17,4 +17,4 @@ - Toon de help: -`docker rm` +`docker rm --help` diff --git a/pages.nl/common/docker.md b/pages.nl/common/docker.md index 124ef4948..50dd63b58 100644 --- a/pages.nl/common/docker.md +++ b/pages.nl/common/docker.md @@ -4,7 +4,7 @@ > Sommige subcommando's zoals `docker run` hebben hun eigen documentatie. > Meer informatie: . -- Toon alle docker containers (actief en gestopte): +- Toon alle Docker containers (actief en gestopte): `docker ps --all` @@ -16,7 +16,7 @@ `docker {{start|stop}} {{container_naam}}` -- Download een image uit een docker register: +- Download een image uit een Docker register: `docker pull {{image}}` diff --git a/pages.nl/common/du.md b/pages.nl/common/du.md index c3281e529..b011bc9bd 100644 --- a/pages.nl/common/du.md +++ b/pages.nl/common/du.md @@ -26,3 +26,7 @@ - Toont de grootte in leesbare vorm van alle `.jpg` bestanden in sub-mappen van de huidige map en laat een cumulatief totaal zien op het eind: `du -ch {{*/*.jpg}}` + +- Toont alle bestanden en mappen (inclusief verborgen) boven een bepaalde drempelwaarde ([t]hreshold) (bruikbaar om te onderzoeken wat veel ruimte in neemt): + +`du --all --human-readable --threshold {{1G|1024M|1048576K}} .[^.]* *` diff --git a/pages.nl/common/echo.md b/pages.nl/common/echo.md index bd30688da..3b82fd6a7 100644 --- a/pages.nl/common/echo.md +++ b/pages.nl/common/echo.md @@ -1,17 +1,17 @@ # echo -> Drukt gegeven argumenten af. +> Toont gegeven argumenten. > Meer informatie: . -- Druk een tekstbericht af. Let op: aanhalingstekens zijn optimaal: +- Toon een tekstbericht. Let op: aanhalingstekens zijn optioneel: `echo "{{Hallo Wereld}}"` -- Druk een bericht af met omgevingsvariabelen: +- Toon een bericht met omgevingsvariabelen: `echo "{{Mijn pad is $PATH}}"` -- Drukt een bericht af zonder te volgen met een nieuwe regel: +- Toont een bericht zonder te volgen met een nieuwe regel: `echo -n "{{Hallo Wereld}}"` @@ -23,6 +23,6 @@ `echo -e "{{kolom 1\kolom 2}}"` -- Druk de afsluitstatus van de laatst uitgevoerde opdracht af (Opmerking: in Windows Command Prompt en PowerShell zijn de equivalente opdrachten respectievelijk `echo %errorlevel%` en `$lastexitcode`): +- Toon de afsluitstatus van de laatst uitgevoerde opdracht (Let op: in Windows Command Prompt en PowerShell zijn de equivalente opdrachten respectievelijk `echo %errorlevel%` en `$lastexitcode`): `echo $?` diff --git a/pages.nl/common/ed.md b/pages.nl/common/ed.md new file mode 100644 index 000000000..72126605a --- /dev/null +++ b/pages.nl/common/ed.md @@ -0,0 +1,33 @@ +# ed + +> De originele Unix tekst editor. +> Bekijk ook: `awk`, `sed`. +> Meer informatie: . + +- Start een interactieve editor sessie met een leeg document: + +`ed` + +- Start een interactieve editor sessie met een leeg document en een specifieke prompt: + +`ed --prompt='> '` + +- Start een interactieve editor sessie met gebruiksvriendelijke foutmeldingen: + +`ed --verbose` + +- Start een interactieve editor sessie met een leeg document en zonder diagnostics, het aantal bytes en de '!' prompt: + +`ed --quiet` + +- Start een interactieve editor sessie zonder exit status change als het commando faalt: + +`ed --loose-exit-status` + +- Pas een specifiek bestand aan (dit toont het aantal bytes van het geladen bestand): + +`ed {{pad/naar/bestand}}` + +- Vervang een string met een specifieke vervanging voor alle regels: + +`,s/{{reguliere_expressie}}/{{vervanging}}/g` diff --git a/pages.nl/common/expand.md b/pages.nl/common/expand.md new file mode 100644 index 000000000..a8ef0676b --- /dev/null +++ b/pages.nl/common/expand.md @@ -0,0 +1,24 @@ +# expand + +> Vervang tabs met spaties. +> Meer informatie: . + +- Vervang tabs in ieder bestand met spaties en schrijf het naar `stdout`: + +`expand {{pad/naar/bestand}}` + +- Vervang tabs met spaties, lezend vanaf `stdin`: + +`expand` + +- Vervang geen tabs na een karakter: + +`expand -i {{pad/naar/bestand}}` + +- Laat tabs een bepaald aantal tekens uit elkaar staan, niet 8: + +`expand -t {{nummer}} {{pad/naar/bestand}}` + +- Gebruik een door komma's gescheiden lijst met expliciete tabposities: + +`expand -t {{1,4,6}}` diff --git a/pages.nl/common/expr.md b/pages.nl/common/expr.md new file mode 100644 index 000000000..ae33a367f --- /dev/null +++ b/pages.nl/common/expr.md @@ -0,0 +1,32 @@ +# expr + +> Evalueer expressies en manipuleer string. +> Meer informatie: . + +- Krijg de lengte van een specifieke string: + +`expr length "{{string}}"` + +- Krijg de substring van een string met een specifieke lengte: + +`expr substr "{{string}}" {{van}} {{lengte}}` + +- Vergelijk een specifieke substring met een verankerd patroon: + +`expr match "{{string}}" '{{patroon}}'` + +- Verkrijg de eerste karakterpositie van een specifieke set in een tekenreeks: + +`expr index "{{string}}" "{{karakters}}"` + +- Bereken een specifieke mathematische expressie: + +`expr {{expressie1}} {{+|-|*|/|%}} {{expressie2}}` + +- Bekijk de eerste expressie als de waarde niet nul is en niet null, anders de tweede: + +`expr {{expressie1}} \| {{expressie2}}` + +- Bekijk de eerste expressie als beide expressies niet nul zijn en niet null, anders 0: + +`expr {{expressie1}} \& {{expressie2}}` diff --git a/pages.nl/common/factor.md b/pages.nl/common/factor.md new file mode 100644 index 000000000..9fc9128db --- /dev/null +++ b/pages.nl/common/factor.md @@ -0,0 +1,12 @@ +# factor + +> Toon de priemfactor van een getal. +> Meer informatie: . + +- Toon de priemfactor van een getal: + +`factor {{nummer}}` + +- Neem de invoer van `stdin` als er geen argument is opgegeven: + +`echo {{nummer}} | factor` diff --git a/pages.nl/common/fmt.md b/pages.nl/common/fmt.md new file mode 100644 index 000000000..4d9dd4f4c --- /dev/null +++ b/pages.nl/common/fmt.md @@ -0,0 +1,20 @@ +# fmt + +> Herformatteer een tekstbestand door de alinea's samen te voegen en de regelbreedte te beperken tot een aantal tekens (standaard 75). +> Meer informatie: . + +- Herformatteer een bestand: + +`fmt {{pad/naar/bestand}}` + +- Herformatteer een bestand met uitvoerregels van (hoogstens) `n` tekens: + +`fmt -w {{n}} {{pad/naar/bestand}}` + +- Herformatteer een bestand zonder regels die korter zijn dan de opgegeven breedte samen te voegen: + +`fmt -s {{pad/naar/bestand}}` + +- Herformatteer een bestand met uniforme spatiëring (1 spatie tussen woorden en 2 spaties tussen alinea's): + +`fmt -u {{pad/naar/bestand}}` diff --git a/pages.nl/common/fold.md b/pages.nl/common/fold.md new file mode 100644 index 000000000..c568e5f08 --- /dev/null +++ b/pages.nl/common/fold.md @@ -0,0 +1,16 @@ +# fold + +> Breek elke regel in een invoerbestand af om in een gespecificeerde breedte te passen en toon het in `stdout`. +> Meer informatie: . + +- Breek elke regel af op de standaard breedte (80 tekens): + +`fold {{pad/naar/bestand}}` + +- Breek elke regel af op een breedte van "30": + +`fold -w30 {{pad/naar/bestand}}` + +- Breek elke regel af op een breedte van "5" en breek de regel bij spaties (zet elk door spaties gescheiden woord op een nieuwe regel, woorden langer dan 5 tekens worden afgebroken): + +`fold -w5 -s {{pad/naar/bestand}}` diff --git a/pages.nl/common/fossil-ci.md b/pages.nl/common/fossil-ci.md index 5a2a6dc71..784980cae 100644 --- a/pages.nl/common/fossil-ci.md +++ b/pages.nl/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> Dit commando is een alias van `fossil-commit`. +> Dit commando is een alias van `fossil commit`. > Meer informatie: . - Bekijk de documentatie van het originele commando: diff --git a/pages.nl/common/fossil-delete.md b/pages.nl/common/fossil-delete.md index c6324d599..9e7ef3878 100644 --- a/pages.nl/common/fossil-delete.md +++ b/pages.nl/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > Dit commando is een alias van `fossil rm`. > Meer informatie: . diff --git a/pages.nl/common/fossil-forget.md b/pages.nl/common/fossil-forget.md index 1f50db65a..073077373 100644 --- a/pages.nl/common/fossil-forget.md +++ b/pages.nl/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > Dit commando is een alias van `fossil rm`. > Meer informatie: . diff --git a/pages.nl/common/fossil-init.md b/pages.nl/common/fossil-init.md index 0f9e649ff..d001b1487 100644 --- a/pages.nl/common/fossil-init.md +++ b/pages.nl/common/fossil-init.md @@ -1,7 +1,7 @@ # fossil init > Initialiseer een nieuwe repository voor een project. -> Zie ook: `fossil clone`. +> Bekijk ook: `fossil clone`. > Meer informatie: . - Maak een nieuwe repository in een opgegeven bestand: diff --git a/pages.nl/common/fossil-new.md b/pages.nl/common/fossil-new.md index d257d8ef6..ac4561e4a 100644 --- a/pages.nl/common/fossil-new.md +++ b/pages.nl/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> Dit commando is een alias van `fossil-init`. +> Dit commando is een alias van `fossil init`. > Meer informatie: . - Bekijk de documentatie van het originele commando: diff --git a/pages.nl/common/fossil-rm.md b/pages.nl/common/fossil-rm.md index ec0543fc8..0ddbaa8eb 100644 --- a/pages.nl/common/fossil-rm.md +++ b/pages.nl/common/fossil-rm.md @@ -1,7 +1,7 @@ # fossil rm > Verwijder bestanden of mappen uit Fossil versiebeheer. -> Zie ook: `fossil forget`. +> Bekijk ook: `fossil forget`. > Meer informatie: . - Verwijder een bestand of map uit Fossil versiebeheer: diff --git a/pages.nl/common/frp.md b/pages.nl/common/frp.md new file mode 100644 index 000000000..7c6cb8527 --- /dev/null +++ b/pages.nl/common/frp.md @@ -0,0 +1,12 @@ +# frp + +> Fast Reverse Proxy: snel netwerktunnels opzetten om bepaalde services bloot te stellen aan het internet of andere externe netwerken. +> Meer informatie: . + +- Bekijk de documentatie voor `frpc`, het `frp`-clientcomponent: + +`tldr frpc` + +- Bekijk de documentatie voor `frps`, het `frp`-servercomponent: + +`tldr frps` diff --git a/pages.nl/common/frpc.md b/pages.nl/common/frpc.md new file mode 100644 index 000000000..f77c215c8 --- /dev/null +++ b/pages.nl/common/frpc.md @@ -0,0 +1,29 @@ +# frpc + +> Maak verbinding met een `frps`-server om verbindingen op de huidige host te proxyen. +> Onderdeel van `frp`. +> Meer informatie: . + +- Start de service met het standaardconfiguratiebestand (aangenomen wordt dat dit `frps.ini` is in de huidige map): + +`frpc` + +- Start de service met het nieuwere TOML-configuratiebestand (`frps.toml` in plaats van `frps.ini`) in de huidige map: + +`frpc {{-c|--config}} ./frps.toml` + +- Start de service met een specifiek configuratiebestand: + +`frpc {{-c|--config}} {{pad/naar/bestand}}` + +- Controleer of het configuratiebestand geldig is: + +`frpc verify {{-c|--config}} {{pad/naar/bestand}}` + +- Toon het script om autocompletion op te zetten voor Bash, fish, PowerShell of Zsh: + +`frpc completion {{bash|fish|powershell|zsh}}` + +- Toon de versie: + +`frpc {{-v|--version}}` diff --git a/pages.nl/common/frps.md b/pages.nl/common/frps.md new file mode 100644 index 000000000..3509af12e --- /dev/null +++ b/pages.nl/common/frps.md @@ -0,0 +1,29 @@ +# frps + +> Stel snel een reverse proxy-service in. +> Onderdeel van `frp`. +> Meer informatie: . + +- Start de service met het standaardconfiguratiebestand (aangenomen wordt dat dit `frps.ini` is in de huidige map): + +`frps` + +- Start de service met het nieuwere TOML-configuratiebestand (`frps.toml` in plaats van `frps.ini`) in de huidige map: + +`frps {{-c|--config}} ./frps.toml` + +- Start de service met een specifiek configuratiebestand: + +`frps {{-c|--config}} {{pad/naar/bestand}}` + +- Controleer of het configuratiebestand geldig is: + +`frps verify {{-c|--config}} {{pad/naar/bestand}}` + +- Toon het script om autocompletion op te zetten voor Bash, fish, PowerShell of Zsh: + +`frps completion {{bash|fish|powershell|zsh}}` + +- Toon de versie: + +`frps {{-v|--version}}` diff --git a/pages.nl/common/ftp.md b/pages.nl/common/ftp.md new file mode 100644 index 000000000..5939beb50 --- /dev/null +++ b/pages.nl/common/ftp.md @@ -0,0 +1,36 @@ +# ftp + +> Hulpmiddelen om via het File Transfer Protocol met een server te communiceren. +> Meer informatie: . + +- Verbinden met een FTP-server: + +`ftp {{ftp.voorbeeld.com}}` + +- Verbinden met een FTP-server met opgave van IP-adres en poort: + +`ftp {{ip_adres}} {{poort}}` + +- Omschakelen naar binaire overdrachtsmodus (grafische bestanden, gecomprimeerde bestanden, etc): + +`binary` + +- Meerdere bestanden overdragen zonder bevestiging voor elk bestand: + +`prompt off` + +- Meerdere bestanden downloaden (glob-expressie): + +`mget {{*.png}}` + +- Meerdere bestanden uploaden (glob-expressie): + +`mput {{*.zip}}` + +- Meerdere bestanden verwijderen op de externe server: + +`mdelete {{*.txt}}` + +- Een bestand hernoemen op de externe server: + +`rename {{originele_bestandsnaam}} {{nieuwe_bestandsnaam}}` diff --git a/pages.nl/common/gcal.md b/pages.nl/common/gcal.md new file mode 100644 index 000000000..e372020d4 --- /dev/null +++ b/pages.nl/common/gcal.md @@ -0,0 +1,24 @@ +# gcal + +> Toon een kalender. +> Meer informatie: . + +- Toon een kalender voor de huidige maand: + +`gcal` + +- Toon de kalender voor de maand februari van het jaar 2010: + +`gcal 2 2010` + +- Toon een kalender met weeknummers: + +`gcal --with-week-number` + +- Verander de startdag van de week naar de eerste dag van de week (maandag): + +`gcal --starting-day=1` + +- Toon de vorige, huidige en volgende maand rondom vandaag: + +`gcal .` diff --git a/pages.nl/common/gcc.md b/pages.nl/common/gcc.md index ef5dbcf9b..13e5de53f 100644 --- a/pages.nl/common/gcc.md +++ b/pages.nl/common/gcc.md @@ -5,15 +5,15 @@ - Meerdere bronbestanden compileren in een uitvoerbaar bestand: -`gcc {{pad/naar/source1.c pad/naar/source2.c ...}} -o {{pad/naar/output_executable}}` +`gcc {{pad/naar/source1.c pad/naar/source2.c ...}} -o {{pad/naar/uitvoer_executable}}` - Toon gemeenschappelijke waarschuwingen, foutopsporingssymbolen in output en optimaliseer zonder debuggen te beïnvloeden: -`gcc {{pad/naar/bron.c}} -Wall -g -Og -o {{pad/naar/output_executable}}` +`gcc {{pad/naar/bron.c}} -Wall -g -Og -o {{pad/naar/uitvoer_executable}}` - Neem bibliotheken op vanuit een ander pad: -`gcc {{pad/naar/bron.c}} -o {{pad/naar/output_executable}} -I{{pad/naar/header}} -L{{pad/naar/library}} -l{{library_name}}` +`gcc {{pad/naar/bron.c}} -o {{pad/naar/uitvoer_executable}} -I{{pad/naar/header}} -L{{pad/naar/library}} -l{{library_name}}` - Compileer broncode naar Assembler instructies: diff --git a/pages.nl/common/gh-cs.md b/pages.nl/common/gh-cs.md index cb1ed361e..eefa0d2e7 100644 --- a/pages.nl/common/gh-cs.md +++ b/pages.nl/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> Dit commando is een alias van `gh-codespace`. +> Dit commando is een alias van `gh codespace`. > Meer informatie: . - Bekijk de documentatie van het originele commando: diff --git a/pages.nl/common/git-add.md b/pages.nl/common/git-add.md index 01385b2ae..57386a837 100644 --- a/pages.nl/common/git-add.md +++ b/pages.nl/common/git-add.md @@ -11,6 +11,10 @@ `git add -A` +- Voeg alle bestanden toe in de huidige map: + +`git add .` + - Voeg alleen al bijgehouden bestanden toe: `git add -u` diff --git a/pages.nl/common/git-stage.md b/pages.nl/common/git-stage.md index 7a5385d82..dd69544c1 100644 --- a/pages.nl/common/git-stage.md +++ b/pages.nl/common/git-stage.md @@ -1,4 +1,4 @@ -# git-stage +# git stage > Dit commando is een alias van `git add`. > Meer informatie: . diff --git a/pages.nl/common/gnmic-sub.md b/pages.nl/common/gnmic-sub.md index cfb551b28..0b9dd9acf 100644 --- a/pages.nl/common/gnmic-sub.md +++ b/pages.nl/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > Dit commando is een alias van `gnmic subscribe`. > Meer informatie: . diff --git a/pages.nl/common/grep.md b/pages.nl/common/grep.md new file mode 100644 index 000000000..2deb2c55b --- /dev/null +++ b/pages.nl/common/grep.md @@ -0,0 +1,36 @@ +# grep + +> Zoek patronen in bestanden met behulp van reguliere expressies. +> Meer informatie: . + +- Zoek naar een patroon in een bestand: + +`grep "{{zoekpatroon}}" {{pad/naar/bestand}}` + +- Zoek naar een exacte string (schakelt reguliere expressies uit): + +`grep {{-F|--fixed-strings}} "{{exacte_string}}" {{pad/naar/bestand}}` + +- Zoek naar een patroon in alle bestanden in een map, recursief, toon regelnummers van overeenkomsten, negeer binaire bestanden: + +`grep {{-r|--recursive}} {{-n|--line-number}} --binary-files {{without-match}} "{{zoekpatroon}}" {{pad/naar/map}}` + +- Gebruik uitgebreide reguliere expressies (ondersteunt `?`, `+`, `{}`, `()` en `|`), in hoofdletterongevoelige modus: + +`grep {{-E|--extended-regexp}} {{-i|--ignore-case}} "{{zoekpatroon}}" {{pad/naar/bestand}}` + +- Print 3 regels context rondom, voor of na elke overeenkomst: + +`grep --{{context|before-context|after-context}} 3 "{{zoekpatroon}}" {{pad/naar/bestand}}` + +- Print bestandsnaam en regelnummers voor elke overeenkomst met kleuruitvoer: + +`grep {{-H|--with-filename}} {{-n|--line-number}} --color=always "{{zoekpatroon}}" {{pad/naar/bestand}}` + +- Zoek naar regels die overeenkomen met een patroon en print alleen de overeenkomstige tekst: + +`grep {{-o|--only-matching}} "{{zoekpatroon}}" {{pad/naar/bestand}}` + +- Zoek in `stdin` naar regels die niet overeenkomen met een patroon: + +`cat {{pad/naar/bestand}} | grep {{-v|--invert-match}} "{{zoekpatroon}}"` diff --git a/pages.nl/common/groups.md b/pages.nl/common/groups.md new file mode 100644 index 000000000..58da1dfb8 --- /dev/null +++ b/pages.nl/common/groups.md @@ -0,0 +1,13 @@ +# groups + +> Toon groepslidmaatschappen voor een gebruiker. +> Bekijk ook: `groupadd`, `groupdel`, `groupmod`. +> Meer informatie: . + +- Toon groepslidmaatschappen voor de huidige gebruiker: + +`groups` + +- Toon groepslidmaatschappen voor een lijst van gebruikers: + +`groups {{gebruikersnaam1 gebruikersnaam2 ...}}` diff --git a/pages.nl/common/hostid.md b/pages.nl/common/hostid.md new file mode 100644 index 000000000..1f106f790 --- /dev/null +++ b/pages.nl/common/hostid.md @@ -0,0 +1,8 @@ +# hostid + +> Toon het numerieke identificatienummer voor de huidige host (niet noodzakelijkerwijs het IP-adres). +> Meer informatie: . + +- Toon het numerieke identificatienummer voor de huidige host in hexadecimale notatie: + +`hostid` diff --git a/pages.nl/common/hostname.md b/pages.nl/common/hostname.md new file mode 100644 index 000000000..fa8e09822 --- /dev/null +++ b/pages.nl/common/hostname.md @@ -0,0 +1,24 @@ +# hostname + +> Toon of stel de hostnaam van het systeem in. +> Meer informatie: . + +- Toon de huidige hostnaam: + +`hostname` + +- Toon het netwerkadres van de hostnaam: + +`hostname -i` + +- Toon alle netwerkadressen van de host: + +`hostname -I` + +- Toon de FQDN (Fully Qualified Domain Name): + +`hostname --fqdn` + +- Stel een nieuwe hostnaam in: + +`hostname {{nieuwe_hostnaam}}` diff --git a/pages.nl/common/icontopbm.md b/pages.nl/common/icontopbm.md new file mode 100644 index 000000000..2654a4c35 --- /dev/null +++ b/pages.nl/common/icontopbm.md @@ -0,0 +1,8 @@ +# icontopbm + +> Dit commando is vervangen door `sunicontopnm`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr sunicontopnm` diff --git a/pages.nl/common/id.md b/pages.nl/common/id.md new file mode 100644 index 000000000..c8a325e45 --- /dev/null +++ b/pages.nl/common/id.md @@ -0,0 +1,20 @@ +# id + +> Toon de huidige gebruikers- en groepsidentiteit. +> Meer informatie: . + +- Toon de ID (UID), groep-ID (GID) en groepen waartoe de huidige gebruiker behoort: + +`id` + +- Toon de identiteit van de huidige gebruiker als een nummer: + +`id -u` + +- Toon de identiteit van de huidige groep als een nummer: + +`id -g` + +- Toon de ID (UID), groep-ID (GID) en groepen waartoe een willekeurige gebruiker behoort: + +`id {{gebruikersnaam}}` diff --git a/pages.nl/common/identify.md b/pages.nl/common/identify.md new file mode 100644 index 000000000..3ed389437 --- /dev/null +++ b/pages.nl/common/identify.md @@ -0,0 +1,7 @@ +# identify + +> Dit commando is een alias van `magick identify`. + +- Bekijk de documentatie van het originele commando: + +`tldr magick identify` diff --git a/pages.nl/common/ifconfig.md b/pages.nl/common/ifconfig.md new file mode 100644 index 000000000..96fccded2 --- /dev/null +++ b/pages.nl/common/ifconfig.md @@ -0,0 +1,24 @@ +# ifconfig + +> Netwerkinterface-configurator. +> Meer informatie: . + +- Bekijk netwerkinstellingen van een Ethernet-adapter: + +`ifconfig eth0` + +- Toon details van alle interfaces, inclusief uitgeschakelde interfaces: + +`ifconfig -a` + +- Schakel de eth0-interface uit: + +`ifconfig eth0 down` + +- Schakel de eth0-interface in: + +`ifconfig eth0 up` + +- Ken een IP-adres toe aan de eth0-interface: + +`ifconfig eth0 {{ip_adres}}` diff --git a/pages.nl/common/import.md b/pages.nl/common/import.md new file mode 100644 index 000000000..06ff636f9 --- /dev/null +++ b/pages.nl/common/import.md @@ -0,0 +1,7 @@ +# import + +> Dit commando is een alias van `magick import`. + +- Bekijk de documentatie van het originele commando: + +`tldr magick import` diff --git a/pages.nl/common/indent.md b/pages.nl/common/indent.md new file mode 100644 index 000000000..d9b92f9be --- /dev/null +++ b/pages.nl/common/indent.md @@ -0,0 +1,16 @@ +# indent + +> Wijzig het uiterlijk van een C/C++-programma door spaties in te voegen of te verwijderen. +> Meer informatie: . + +- Formatteer C/C++-broncode volgens de Linux style guide, maak automatisch een back-up van de originele bestanden en vervang deze door de ingesprongen versies: + +`indent --linux-style {{pad/naar/bron.c}} {{pad/naar/andere_bron.c}}` + +- Formatteer C/C++-broncode volgens de GNU-stijl en sla de ingesprongen versie op in een ander bestand: + +`indent --gnu-style {{pad/naar/bron.c}} -o {{pad/naar/indented_source.c}}` + +- Formatteer C/C++-broncode volgens de stijl van Kernighan & Ritchie (K&R), geen tabs, 3 spaties per inspringing en breek regels af op 120 tekens: + +`indent --k-and-r-style --indent-level3 --no-tabs --line-length120 {{pad/naar/bron.c}} -o {{pad/naar/indented_source.c}}` diff --git a/pages.nl/common/install.md b/pages.nl/common/install.md new file mode 100644 index 000000000..2d4ed339d --- /dev/null +++ b/pages.nl/common/install.md @@ -0,0 +1,29 @@ +# install + +> Kopieer bestanden en stel attributen in. +> Kopieer bestanden (vaak uitvoerbare) naar een systeemlocatie zoals `/usr/local/bin` en geef ze de juiste permissies/eigendom. +> Meer informatie: . + +- Kopieer bestanden naar de bestemming: + +`install {{pad/naar/bronbestand1 pad/naar/bronbestand2 ...}} {{pad/naar/bestemming}}` + +- Kopieer bestanden naar de bestemming en stel hun eigendom in: + +`install --owner {{gebruiker}} {{pad/naar/bronbestand1 pad/naar/bronbestand2 ...}} {{pad/naar/bestemming}}` + +- Kopieer bestanden naar de bestemming en stel hun groepseigendom in: + +`install --group {{gebruiker}} {{pad/naar/bronbestand1 pad/naar/bronbestand2 ...}} {{pad/naar/bestemming}}` + +- Kopieer bestanden naar de bestemming en stel hun `modus` in: + +`install --mode {{+x}} {{pad/naar/bronbestand1 pad/naar/bronbestand2 ...}} {{pad/naar/bestemming}}` + +- Kopieer bestanden en pas toegangstijden/wijzigingstijden van de bron toe op de bestemming: + +`install --preserve-timestamps {{pad/naar/bronbestand1 pad/naar/bronbestand2 ...}} {{pad/naar/bestemming}}` + +- Kopieer bestanden en maak de mappen op de bestemming aan als ze niet bestaan: + +`install -D {{pad/naar/bronbestand1 pad/naar/bronbestand2 ...}} {{pad/naar/bestemming}}` diff --git a/pages.nl/common/jf.md b/pages.nl/common/jf.md new file mode 100644 index 000000000..6025286d2 --- /dev/null +++ b/pages.nl/common/jf.md @@ -0,0 +1,16 @@ +# jf + +> Werk met JFrog producten zoals Artifactory, Xray, Distribution, Pipelines en Mission Control. +> Meer informatie: . + +- Voeg een nieuwe configuratie toe: + +`jf config add` + +- Toon de huidige configuratie: + +`jf config show` + +- Zoek naar artifacts binnen de opgegeven repository en map: + +`jf rt search --recursive {{repostiory_naam}}/{{pad}}/` diff --git a/pages.nl/common/join.md b/pages.nl/common/join.md new file mode 100644 index 000000000..d818d9a5c --- /dev/null +++ b/pages.nl/common/join.md @@ -0,0 +1,24 @@ +# join + +> Voeg regels van twee gesorteerde bestanden samen op een gemeenschappelijk veld. +> Meer informatie: . + +- Voeg twee bestanden samen op het eerste (standaard) veld: + +`join {{pad/naar/bestand1}} {{pad/naar/bestand2}}` + +- Voeg twee bestanden samen met een komma (in plaats van een spatie) als veldscheidingsteken: + +`join -t {{','}} {{pad/naar/bestand1}} {{pad/naar/bestand2}}` + +- Voeg veld 3 van bestand 1 samen met veld 1 van bestand 2: + +`join -1 {{3}} -2 {{1}} {{pad/naar/bestand1}} {{pad/naar/bestand2}}` + +- Produceer een regel voor elke niet-koppelbare regel van bestand 1: + +`join -a {{1}} {{pad/naar/bestand1}} {{pad/naar/bestand2}}` + +- Voeg een bestand samen vanaf `stdin`: + +`cat {{pad/naar/bestand1}} | join - {{pad/naar/bestand2}}` diff --git a/pages.nl/common/just.1.md b/pages.nl/common/just.1.md index b1dd6ff83..1bec08a1b 100644 --- a/pages.nl/common/just.1.md +++ b/pages.nl/common/just.1.md @@ -19,6 +19,6 @@ `just -l` -- Print de justfile: +- Toon de justfile: `just --dump` diff --git a/pages.nl/common/kill.md b/pages.nl/common/kill.md new file mode 100644 index 000000000..3ae4da706 --- /dev/null +++ b/pages.nl/common/kill.md @@ -0,0 +1,33 @@ +# kill + +> Stuurt een signaal naar een proces, meestal om het proces te stoppen. +> Alle signalen behalve SIGKILL en SIGSTOP kunnen door het proces worden onderschept om een nette afsluiting uit te voeren. +> Meer informatie: . + +- Beëindig een programma met behulp van het standaard SIGTERM (terminate) signaal: + +`kill {{proces_id}}` + +- Lijst beschikbare signalen op (te gebruiken zonder het `SIG` voorvoegsel): + +`kill -l` + +- Beëindig een programma met behulp van het SIGHUP (hang up) signaal. Veel daemons zullen herladen in plaats van beëindigen: + +`kill -{{1|HUP}} {{proces_id}}` + +- Beëindig een programma met behulp van het SIGINT (interrupt) signaal. Dit wordt meestal geïnitieerd door de gebruiker die `Ctrl + C` indrukt: + +`kill -{{2|INT}} {{proces_id}}` + +- Signaleer het besturingssysteem om een programma onmiddellijk te beëindigen (het programma krijgt geen kans om het signaal te onderscheppen): + +`kill -{{9|KILL}} {{proces_id}}` + +- Signaleer het besturingssysteem om een programma te pauzeren totdat een SIGCONT ("continue") signaal wordt ontvangen: + +`kill -{{17|STOP}} {{proces_id}}` + +- Stuur een `SIGUSR1` signaal naar alle processen met de gegeven GID (groeps-ID): + +`kill -{{SIGUSR1}} -{{groep_id}}` diff --git a/pages.nl/common/link.md b/pages.nl/common/link.md new file mode 100644 index 000000000..5f637ceaf --- /dev/null +++ b/pages.nl/common/link.md @@ -0,0 +1,9 @@ +# link + +> Maak een harde koppeling naar een bestaand bestand. +> Voor meer opties, zie het `ln` commando. +> Meer informatie: . + +- Maak een harde koppeling van een nieuw bestand naar een bestaand bestand: + +`link {{pad/naar/bestaand_bestand}} {{pad/naar/nieuw_bestand}}` diff --git a/pages.nl/common/linode-cli-nodebalancers.md b/pages.nl/common/linode-cli-nodebalancers.md index 715b835f7..9c3150ef5 100644 --- a/pages.nl/common/linode-cli-nodebalancers.md +++ b/pages.nl/common/linode-cli-nodebalancers.md @@ -10,7 +10,7 @@ - Maak een nieuwe NodeBalancer: -`linode-cli nodebalancers create --region {{region}}` +`linode-cli nodebalancers create --region {{regio}}` - Toon details van een specifieke NodeBalancer: @@ -18,7 +18,7 @@ - Update een bestaande NodeBalancer: -`linode-cli nodebalancers update {{nodebalancer_id}} --label {{new_label}}` +`linode-cli nodebalancers update {{nodebalancer_id}} --label {{nieuw_label}}` - Verwijder een NodeBalancer: @@ -30,4 +30,4 @@ - Voeg een nieuwe configuratie toe aan een NodeBalancer: -`linode-cli nodebalancers configs create {{nodebalancer_id}} --port {{port}} --protocol {{protocol}}` +`linode-cli nodebalancers configs create {{nodebalancer_id}} --port {{poort}} --protocol {{protocol}}` diff --git a/pages.nl/common/logger.md b/pages.nl/common/logger.md new file mode 100644 index 000000000..b2595b0b8 --- /dev/null +++ b/pages.nl/common/logger.md @@ -0,0 +1,24 @@ +# logger + +> Voeg berichten toe aan syslog (/var/log/syslog). +> Meer informatie: . + +- Log een bericht naar syslog: + +`logger {{bericht}}` + +- Neem invoer van `stdin` en log naar syslog: + +`echo {{log_entry}} | logger` + +- Stuur de uitvoer naar een externe syslog-server die op een bepaalde poort draait. Standaardpoort is 514: + +`echo {{log_entry}} | logger --server {{hostname}} --port {{poort}}` + +- Gebruik een specifieke tag voor elke gelogde regel. Standaard is de naam van de ingelogde gebruiker: + +`echo {{log_entry}} | logger --tag {{tag}}` + +- Log berichten met een gegeven prioriteit. Standaard is `user.notice`. Zie `man logger` voor alle prioriteitsopties: + +`echo {{log_entry}} | logger --priority {{user.warning}}` diff --git a/pages.nl/common/look.md b/pages.nl/common/look.md new file mode 100644 index 000000000..81d381b5d --- /dev/null +++ b/pages.nl/common/look.md @@ -0,0 +1,22 @@ +# look + +> Toon regels die beginnen met een prefix in een gesorteerd bestand. +> Let op: de regels in het bestand moeten gesorteerd zijn. +> Bekijk ook: `grep`, `sort`. +> Meer informatie: . + +- Zoek naar regels die beginnen met een specifieke prefix in een specifiek bestand: + +`look {{prefix}} {{pad/naar/bestand}}` + +- Zoek hoofdletterongevoelig ([f]) alleen op alfanumerieke tekens ([d]): + +`look -f -d {{prefix}} {{pad/naar/bestand}}` + +- Specificeer een string-[t]erminatiekarakter (standaard is spatie): + +`look -t {{,}}` + +- Zoek in `/usr/share/dict/words` (`--ignore-case` en `--alphanum` worden aangenomen): + +`look {{prefix}}` diff --git a/pages.nl/common/lp.md b/pages.nl/common/lp.md index 11b61e490..3324e10fb 100644 --- a/pages.nl/common/lp.md +++ b/pages.nl/common/lp.md @@ -3,23 +3,23 @@ > Print bestanden. > Meer informatie: . -- Print de output van een commando met de standaard printer (bekijk het `lpstat` commando): +- Toon de output van een commando met de standaard printer (bekijk het `lpstat` commando): `echo "test" | lp` -- Print een bestand met de standaard printer: +- Toon een bestand met de standaard printer: `lp {{pad/naar/bestandsnaam}}` -- Print een bestand met een printer met naam (bekijk het `lpstat` commando): +- Toon een bestand met een printer met naam (bekijk het `lpstat` commando): `lp -d {{printer_naam}} {{pad/naar/bestandsnaam}}` -- Print N kopieën van een bestand met de standaard printer (vervang N met het gewenste aantal kopieën): +- Toon N kopieën van een bestand met de standaard printer (vervang N met het gewenste aantal kopieën): `lp -n {{N}} {{pad/naar/bestandsnaam}}` -- Print alleen specifieke pagina's met de standaard printer (print pagina's 1, 3-5, and 16): +- Toon alleen specifieke pagina's met de standaard printer (print pagina's 1, 3-5, and 16): `lp -P 1,3-5,16 {{pad/naar/bestandsnaam}}` diff --git a/pages.nl/common/ls.md b/pages.nl/common/ls.md new file mode 100644 index 000000000..0c1ac9714 --- /dev/null +++ b/pages.nl/common/ls.md @@ -0,0 +1,36 @@ +# ls + +> Toon de inhoud van een map. +> Meer informatie: . + +- Toon één bestand per regel: + +`ls -1` + +- Toon alle bestanden, inclusief verborgen bestanden: + +`ls -a` + +- Toon alle bestanden, met een `/` achter de namen van mappen: + +`ls -F` + +- Lange lijstweergave (permissies, eigendom, grootte en wijzigingsdatum) van alle bestanden: + +`ls -la` + +- Lange lijstweergave met grootte weergegeven in leesbare eenheden (KiB, MiB, GiB): + +`ls -lh` + +- Lange lijstweergave gesorteerd op grootte (aflopend) recursief: + +`ls -lSR` + +- Lange lijstweergave van alle bestanden, gesorteerd op wijzigingsdatum (oudste eerst): + +`ls -ltr` + +- Toon alleen mappen: + +`ls -d */` diff --git a/pages.nl/common/magick-compare.md b/pages.nl/common/magick-compare.md new file mode 100644 index 000000000..e7ed238ea --- /dev/null +++ b/pages.nl/common/magick-compare.md @@ -0,0 +1,13 @@ +# magick compare + +> Maak een vergelijkingsafbeelding om visueel de verschillen te zien tussen twee afbeeldingen. +> Bekijk ook: `magick`. +> Meer informatie: . + +- Vergelijk twee afbeeldingen: + +`magick compare {{pad/naar/afbeelding1.png}} {{pad/naar/afbeelding2.png}} {{pad/naar/diff.png}}` + +- Vergelijk twee afbeelding door gebruik te maken van de gespecificeerde metriek: + +`magick compare -verbose -metric {{PSNR}} {{pad/naar/afbeelding1.png}} {{pad/naar/afbeelding2.png}} {{pad/naar/diff.png}}` diff --git a/pages.nl/common/magick-convert.md b/pages.nl/common/magick-convert.md new file mode 100644 index 000000000..a36d3605c --- /dev/null +++ b/pages.nl/common/magick-convert.md @@ -0,0 +1,37 @@ +# magick convert + +> Converteer tussen afbeeldingsformaten, schaal, voeg samen, maak afbeeldingen en nog veel meer. +> Let op: deze tool (voorheen `convert`) is vervangen door `magick` in ImageMagick 7+. +> Meer informatie: . + +- Converteer een afbeelding van JPEG naar PNG: + +`magick convert {{pad/naar/invoer_afbeelding.jpg}} {{pad/naar/uitvoer_afbeelding.png}}` + +- Schaal een afbeelding naar 50% van zijn originele grootte: + +`magick convert {{pad/naar/invoer_afbeelding.png}} -resize 50% {{pad/naar/uitvoer_afbeelding.png}}` + +- Schaal een afbeelding en behoud de originele aspect ratio tot een maximale dimensie van 640x480: + +`magick convert {{pad/naar/invoer_afbeelding.png}} -resize 640x480 {{pad/naar/uitvoer_afbeelding.png}}` + +- Schaal een afbeelding zodat deze een gespecificeerde bestandsgrootte heeft: + +`magick convert {{pad/naar/invoer_afbeelding.png}} -define jpeg:extent=512kb {{pad/naar/uitvoer_afbeelding.jpg}}` + +- Verticaal/horizontaal toevoegen van afbeeldingen: + +`magick convert {{pad/naar/afbeelding1.png pad/naar/afbeelding2.png ...}} {{-append|+append}} {{pad/naar/uitvoer_afbeelding.png}}` + +- Maak een GIF van een series van afbeeldingen met 100ms pauze ertusen: + +`magick convert {{pad/naar/afbeelding1.png pad/naar/afbeelding2.png ...}} -delay {{10}} {{pad/naar/animation.gif}}` + +- Maak een afbeelding met niets anders dan een volledig rode achtergrond: + +`magick convert -size {{800x600}} "xc:{{#ff0000}}" {{pad/naar/afbeelding.png}}` + +- Maak een favicon van verschillende afbeeldingen met verschillende groottes: + +`magick convert {{pad/naar/afbeelding1.png pad/naar/afbeelding2.png ...}} {{pad/naar/favicon.ico}}` diff --git a/pages.nl/common/magick-identify.md b/pages.nl/common/magick-identify.md new file mode 100644 index 000000000..f125001e4 --- /dev/null +++ b/pages.nl/common/magick-identify.md @@ -0,0 +1,17 @@ +# magick identify + +> Beschrijf het formaat en eigenschappen van afbeeldingen. +> Bekijk ook: `magick`. +> Meer informatie: . + +- Beschrijf het formaat en basis eigenschappen van een afbeelding: + +`magick identify {{pad/naar/afbeelding}}` + +- Beschrijf het formaat en uitgebreide eigenschappen van een afbeelding: + +`magick identify -verbose {{pad/naar/afbeelding}}` + +- Verzamel de dimensies van alle JPEG bestanden in de huidige map en sla ze op naar een CSV-bestand: + +`magick identify -format "{{%f,%w,%h\n}}" {{*.jpg}} > {{pad/naar/bestandslijst.csv}}` diff --git a/pages.nl/common/magick-import.md b/pages.nl/common/magick-import.md new file mode 100644 index 000000000..2ee9c98a4 --- /dev/null +++ b/pages.nl/common/magick-import.md @@ -0,0 +1,17 @@ +# magick import + +> Leg een deel of het geheel van een X server scherm vast en sla de afbeelding op in een bestand. +> Bekijk ook: `magick`. +> Meer informatie: . + +- Leg het hele X server scherm vast in een PostScript bestand: + +`magick import -window root {{pad/naar/uitvoer.ps}}` + +- Leg de inhoud van een extern X server scherm vast in een PNG afbeelding: + +`magick import -window root -display {{externe_host}}:{{scherm}}.{{display}} {{pad/naar/uitvoer.png}}` + +- Leg een specifiek venster vast op basis van zijn ID zoals weergegeven door `xwininfo` in een JPEG-afbeelding: + +`magick import -window {{window_id}} {{pad/naar/uitvoer.jpg}}` diff --git a/pages.nl/common/magick-mogrify.md b/pages.nl/common/magick-mogrify.md new file mode 100644 index 000000000..250a85add --- /dev/null +++ b/pages.nl/common/magick-mogrify.md @@ -0,0 +1,26 @@ +# magick mogrify + +> Voer bewerkingen uit op meerdere afbeeldingen, zoals het wijzigen van de grootte, bijsnijden, omkeren en effecten toevoegen. +> Wijzigingen worden direct toegepast op het originele bestand. +> Bekijk ook: `magick`. +> Meer informatie: . + +- Wijzig de grootte van alle JPEG afbeeldingen in de map naar 50% van hun oorspronkelijke grootte: + +`magick mogrify -resize {{50%}} {{*.jpg}}` + +- Wijzig de grootte van alle afbeeldingen die beginnen met `DSC` naar 800x600: + +`magick mogrify -resize {{800x600}} {{DSC*}}` + +- Converteer alle PNG's in de map naar JPEG: + +`magick mogrify -format {{jpg}} {{*.png}}` + +- Halveer de verzadiging van alle afbeeldingsbestanden in de huidige map: + +`magick mogrify -modulate {{100,50}} {{*}}` + +- Verdubbel de helderheid van alle afbeeldingsbestanden in de huidige map: + +`magick mogrify -modulate {{200}} {{*}}` diff --git a/pages.nl/common/magick-montage.md b/pages.nl/common/magick-montage.md new file mode 100644 index 000000000..2322d2a20 --- /dev/null +++ b/pages.nl/common/magick-montage.md @@ -0,0 +1,25 @@ +# magick montage + +> Plaats afbeeldingen in een aanpasbaar raster. +> Bekijk ook: `magick`. +> Meer informatie: . + +- Plaats afbeeldingen in een raster, waarbij afbeeldingen die groter zijn dan de rastercelgrootte automatisch worden aangepast: + +`magick montage {{pad/naar/afbeelding1.jpg pad/naar/afbeelding2.jpg ...}} {{pad/naar/montage.jpg}}` + +- Plaats afbeeldingen in een raster, waarbij de rastercelgrootte automatisch wordt berekend op basis van de grootste afbeelding: + +`magick montage {{pad/naar/afbeelding1.jpg pad/naar/afbeelding2.jpg ...}} -geometry {{+0+0}} {{pad/naar/montage.jpg}}` + +- Specificeer de rastercelgrootte en pas de afbeeldingen aan om hierin te passen voordat ze worden geplaatst: + +`magick montage {{pad/naar/afbeelding1.jpg pad/naar/afbeelding2.jpg ...}} -geometry {{640x480+0+0}} {{pad/naar/montage.jpg}}` + +- Beperk het aantal rijen en kolommen in het raster, waardoor invoerafbeeldingen over meerdere output-montages worden verdeeld: + +`magick montage {{pad/naar/afbeelding1.jpg pad/naar/afbeelding2.jpg ...}} -geometry {{+0+0}} -tile {{2x3}} {{montage_%d.jpg}}` + +- Wijzig de grootte en snijd afbeeldingen bij om hun rastercellen te vullen voordat ze worden geplaatst: + +`magick montage {{pad/naar/afbeelding1.jpg pad/naar/afbeelding2.jpg ...}} -geometry {{+0+0}} -resize {{640x480^}} -gravity {{center}} -crop {{640x480+0+0}} {{pad/naar/montage.jpg}}` diff --git a/pages.nl/common/magick.md b/pages.nl/common/magick.md index d6461ac9c..f8b434389 100644 --- a/pages.nl/common/magick.md +++ b/pages.nl/common/magick.md @@ -1,18 +1,19 @@ # magick -> Creër, bewerk, vorm, of converteer bitmapafbeeldingen. -> ImageMagick versie 7+. Bekijk `convert` voor versies 6 en lager. -> Meer informatie: . +> Creër, bewerk, vorm of converteer bitmapafbeeldingen. +> Deze tool vervangt `convert` in ImageMagick 7+. Bekijk `magick convert` om de oude tool te gebruiken in versies 7+. +> Sommige subcommando's zoals `mogrify` hebben hun eigen documentatie. +> Meer informatie: . -- Converteer bestandstype: +- Converteer tussen afbeeldingsformaten: `magick {{pad/naar/invoer_afbeelding.png}} {{pad/naar/uitvoer_afbeelding.jpg}}` -- Formaat van een afbeelding wijzigen, maak een nieuw kopie: +- Wijzig de grootte van een afbeelding en maak een nieuwe kopie: `magick {{pad/naar/invoer_afbeelding.png}} -resize {{100x100}} {{pad/naar/uitvoer_afbeelding.jpg}}` -- Creër een GIF door middel van afbeeldingen: +- Maak een GIF van alle JPEG-afbeeldingen uit de huidige map: `magick {{*.jpg}} {{pad/naar/uitvoer_afbeelding.gif}}` @@ -20,6 +21,6 @@ `magick -size {{640x480}} pattern:checkerboard {{pad/naar/dambordpatroon.png}}` -- Converteer afbeeldingen naar individuele PDF-pagina's: +- Maak een PDF van alle JPEG-afbeeldingen uit de huidige map: `magick {{*.jpg}} -adjoin {{pad/naar/pagina-%d.pdf}}` diff --git a/pages.nl/common/make.md b/pages.nl/common/make.md new file mode 100644 index 000000000..ea313dc2f --- /dev/null +++ b/pages.nl/common/make.md @@ -0,0 +1,37 @@ +# make + +> Taakuitvoerder voor doelen beschreven in Makefile. +> Wordt meestal gebruikt om de compilatie van een uitvoerbaar bestand uit broncode te beheren. +> Meer informatie: . + +- Roep het eerste doel aan dat in de Makefile is gespecificeerd (meestal "all" genoemd): + +`make` + +- Roep een specifiek doel aan: + +`make {{doel}}` + +- Roep een specifiek doel aan en voer 4 taken tegelijk uit in parallel: + +`make -j{{4}} {{doel}}` + +- Gebruik een specifieke Makefile: + +`make --file {{pad/naar/bestand}}` + +- Voer make uit vanuit een andere map: + +`make --directory {{pad/naar/map}}` + +- Forceer het maken van een doel, zelfs als bronbestanden ongewijzigd zijn: + +`make --always-make {{doel}}` + +- Overschrijf een variabele die in de Makefile is gedefinieerd: + +`make {{doel}} {{variabele}}={{nieuwe_waarde}}` + +- Overschrijf variabelen die in de Makefile zijn gedefinieerd door de omgeving: + +`make --environment-overrides {{doel}}` diff --git a/pages.nl/common/md5sum.md b/pages.nl/common/md5sum.md new file mode 100644 index 000000000..5d2cb9023 --- /dev/null +++ b/pages.nl/common/md5sum.md @@ -0,0 +1,28 @@ +# md5sum + +> Bereken MD5 cryptografische checksums. +> Meer informatie: . + +- Bereken de MD5 checksum voor één of meer bestanden: + +`md5sum {{pad/naar/bestand1 pad/naar/bestand2 ...}}` + +- Bereken en sla de lijst van MD5 checksums op in een bestand: + +`md5sum {{pad/naar/bestand1 pad/naar/bestand2 ...}} > {{pad/naar/bestand.md5}}` + +- Bereken een MD5 checksum van `stdin`: + +`{{commando}} | md5sum` + +- Lees een bestand met MD5 checksums en bestandsnamen en verifieer dat alle bestanden overeenkomende checksums hebben: + +`md5sum --check {{pad/naar/bestand.md5}}` + +- Toon alleen een bericht voor ontbrekende bestanden of wanneer verificatie mislukt: + +`md5sum --check --quiet {{pad/naar/bestand.md5}}` + +- Toon alleen een bericht wanneer verificatie mislukt, negeer ontbrekende bestanden: + +`md5sum --ignore-missing --check --quiet {{pad/naar/bestand.md5}}` diff --git a/pages.nl/common/mkdir.md b/pages.nl/common/mkdir.md new file mode 100644 index 000000000..a191668aa --- /dev/null +++ b/pages.nl/common/mkdir.md @@ -0,0 +1,16 @@ +# mkdir + +> Maak mappen aan en stel hun permissies in. +> Meer informatie: . + +- Maak specifieke mappen aan: + +`mkdir {{pad/naar/map1 pad/naar/map2 ...}}` + +- Maak specifieke mappen en hun ouders ([p]) aan indien nodig: + +`mkdir -p {{pad/naar/map1 pad/naar/map2 ...}}` + +- Maak mappen aan met specifieke permissies: + +`mkdir -m {{rwxrw-r--}} {{pad/naar/map1 pad/naar/map2 ...}}` diff --git a/pages.nl/common/mktemp.md b/pages.nl/common/mktemp.md new file mode 100644 index 000000000..6a2416a90 --- /dev/null +++ b/pages.nl/common/mktemp.md @@ -0,0 +1,24 @@ +# mktemp + +> Maak een tijdelijk bestand of een tijdelijke map aan. +> Meer informatie: . + +- Maak een leeg tijdelijk bestand en toon het absolute pad: + +`mktemp` + +- Gebruik een aangepaste map als `$TMPDIR` niet is ingesteld (de standaard is platformafhankelijk, maar meestal `/tmp`): + +`mktemp -p {{/pad/naar/tempdir}}` + +- Gebruik een aangepast pad-sjabloon (`X`en worden vervangen door willekeurige alfanumerieke tekens): + +`mktemp {{/tmp/voorbeeld.XXXXXXXX}}` + +- Gebruik een aangepast bestandsnaam-sjabloon: + +`mktemp -t {{voorbeeld.XXXXXXXX}}` + +- Maak een lege tijdelijke map aan en toon het absolute pad: + +`mktemp -d` diff --git a/pages.nl/common/mogrify.md b/pages.nl/common/mogrify.md new file mode 100644 index 000000000..51e833821 --- /dev/null +++ b/pages.nl/common/mogrify.md @@ -0,0 +1,7 @@ +# mogrify + +> Dit commando is een alias van `magick mogrify`. + +- Bekijk de documentatie van het originele commando: + +`tldr magick mogrify` diff --git a/pages.nl/common/montage.md b/pages.nl/common/montage.md new file mode 100644 index 000000000..3bfe3ea43 --- /dev/null +++ b/pages.nl/common/montage.md @@ -0,0 +1,7 @@ +# montage + +> Dit commando is een alias van `magick montage`. + +- Bekijk de documentatie van het originele commando: + +`tldr magick montage` diff --git a/pages.nl/common/musescore.md b/pages.nl/common/musescore.md index 0bbcf14ab..6eafef9ef 100644 --- a/pages.nl/common/musescore.md +++ b/pages.nl/common/musescore.md @@ -7,7 +7,7 @@ `musescore --audio-driver {{jack|alsa|portaudio|pulse}}` -- Stel de MP3 uitvoer bitsnelheid in in kbit/s: +- Stel de MP3 uitvoer bitsnelheid in kbit/s: `musescore --bitrate {{bitsnelheid}}` diff --git a/pages.nl/common/nc.md b/pages.nl/common/nc.md index 065487b7a..f3cd42322 100644 --- a/pages.nl/common/nc.md +++ b/pages.nl/common/nc.md @@ -1,7 +1,7 @@ # nc > Netcat is een veelzijdig hulpprogramma voor het omleiden van IO naar een netwerkstream. -> Meer informatie: . +> Meer informatie: . - Start een luisteraar op de opgegeven TCP poort en stuur er een bestand in: diff --git a/pages.nl/common/open.fish.md b/pages.nl/common/open.fish.md index b9303eb9a..fd08b6c8b 100644 --- a/pages.nl/common/open.fish.md +++ b/pages.nl/common/open.fish.md @@ -1,7 +1,7 @@ # open > Opent bestanden, mappen en URI's met standaardtoepassingen. -> Deze commando is beschikbaar via `fish` op besturingssystemen zonder het ingebouwde `open`-commando (bijv. Haiku en macOS). +> Deze commando is beschikbaar via fish op besturingssystemen zonder het ingebouwde `open`-commando (bijv. Haiku en macOS). > Meer informatie: . - Open een bestand met de bijbehorende applicatie: diff --git a/pages.nl/common/open.md b/pages.nl/common/open.md index f81d6d60e..6b2cbe693 100644 --- a/pages.nl/common/open.md +++ b/pages.nl/common/open.md @@ -6,6 +6,6 @@ `tldr open -p osx` -- Bekijk de documentatie voor het command beschikbaar via `fish`: +- Bekijk de documentatie voor het command beschikbaar via fish: `tldr open.fish` diff --git a/pages.nl/common/pamarith.md b/pages.nl/common/pamarith.md new file mode 100644 index 000000000..45855d30b --- /dev/null +++ b/pages.nl/common/pamarith.md @@ -0,0 +1,9 @@ +# pamarith + +> Pas een binaire functie toe op twee Netpbm afbeeldingen. +> Bekijk ook: `pamfunc`. +> Meer informatie: . + +- Pas de gespecificeerde binaire functie pixel-gewijs toe op twee gespecificeerde afbeeldingen (welke hetzelfde formaat dienen te hebben): + +`pamarith -{{add|subtract|multiply|divide|difference|minimum|maximum|...}} {{pad/naar/afbeelding1.pam|pbm|pgm|ppm}} {{pad/naar/afbeelding2.pam|pbm|pgm|ppm}}` diff --git a/pages.nl/common/pambrighten.md b/pages.nl/common/pambrighten.md new file mode 100644 index 000000000..968589aa5 --- /dev/null +++ b/pages.nl/common/pambrighten.md @@ -0,0 +1,12 @@ +# pambrighten + +> Verander de saturatie en waarde van een PAM afbeelding. +> Meer informatie: . + +- Verhoog de verzadiging van elke pixel met het gespecificeerde percentage: + +`pambrighten -saturation {{percentage}} {{pad/naar/afbeelding.pam}} > {{pad/naar/uitvoer.pam}}` + +- Verhoog de waarde (van de HSV kleurruimte) van elke pixel met het gespecificeerde percentage: + +`pambrighten -value {{percentage}} {{pad/naar/afbeelding.pam}} > {{pad/naar/uitvoer.pam}}` diff --git a/pages.nl/common/pamcomp.md b/pages.nl/common/pamcomp.md new file mode 100644 index 000000000..b13959ba0 --- /dev/null +++ b/pages.nl/common/pamcomp.md @@ -0,0 +1,20 @@ +# pamcomp + +> Leg twee PAM afbeeldingen over elkaar. +> Meer informatie: . + +- Leg twee afbeeldingen over elkaar zodat de bovenlaag delen van de onderlaag blokeert: + +`pamcomp {{pad/naar/bovenlaag.pam}} {{pad/naar/onderlaag.pam}} > {{pad/naar/uitvoer.pam}}` + +- Zet de horizontale uitlijning van de bovenlaag: + +`pamcomp -align {{left|center|right|beyondleft|beyondright}} -xoff {{x_offset}} {{pad/naar/bovenlaag.pam}} {{pad/naar/onderlaag.pam}} > {{pad/naar/uitvoer.pam}}` + +- Zet de verticale uitlijning van de bovenlaag: + +`pamcomp -valign {{top|middle|bottom|above|below}} -yoff {{y_offset}} {{pad/naar/bovenlaag.pam}} {{pad/naar/onderlaag.pam}} > {{pad/naar/uitvoer.pam}}` + +- Zet de dekking van de bovenlaag: + +`pamcomp -opacity {{0.7}} {{pad/naar/bovenlaag.pam}} {{pad/naar/onderlaag.pam}} > {{pad/naar/uitvoer.pam}}` diff --git a/pages.nl/common/pamcrater.md b/pages.nl/common/pamcrater.md new file mode 100644 index 000000000..6d508ec13 --- /dev/null +++ b/pages.nl/common/pamcrater.md @@ -0,0 +1,13 @@ +# pamcrater + +> Maak een PAM afbeelding van een krater terrein. +> Bekijk ook: `pamshadedrelief`, `ppmrelief`. +> Meer informatie: . + +- Maak een afbeelding van een krater terrein met de gespecificeerde dimensies: + +`pamcrater -height {{hoogte}} -width {{breedte}} > {{pad/naar/uitvoer.pam}}` + +- Maak een afbeelding met het gespecificeerde nummer van kraters: + +`pamcrater -number {{n_kraters}} > {{pad/naar/uitvoer.pam}}` diff --git a/pages.nl/common/pamcut.md b/pages.nl/common/pamcut.md new file mode 100644 index 000000000..7c3d72e64 --- /dev/null +++ b/pages.nl/common/pamcut.md @@ -0,0 +1,17 @@ +# pamcut + +> Snij een rechthoekig gebied uit van een Netpbm afbeelding. +> Bekijk ook: `pamcrop`, `pamdice`, `pamcomp`. +> Meer informatie: . + +- Verwijder het gespecificeerde nummer van kolommen/rijen van iedere zijde van de afbeelding: + +`pamcut -cropleft {{waarde}} -cropright {{waarde}} -croptop {{waarde}} -cropbottom {{waarde}} {{pad/naar/afbeelding.ppm}} > {{pad/naar/uitvoer.ppm}}` + +- Behoud alleen de kolommen tussen de gespecificeerde kolommen (inclusief de gespecificeerde): + +`pamcut -left {{waarde}} -right {{waarde}} {{pad/naar/afbeelding.ppm}} > {{pad/naar/uitvoer.ppm}}` + +- Vul missende gebieden met zwarte pixels als de gespecificeerde rechthoek niet volledig ligt in de invoer-afbeelding: + +`pamcut -top {{waarde}} -bottom {{waarde}} -pad {{pad/naar/afbeelding.ppm}} > {{pad/naar/uitvoer.ppm}}` diff --git a/pages.nl/common/pamditherbw.md b/pages.nl/common/pamditherbw.md new file mode 100644 index 000000000..8a73df093 --- /dev/null +++ b/pages.nl/common/pamditherbw.md @@ -0,0 +1,21 @@ +# pamditherbw + +> Pas dithering toe op een grijze afbeelding, zet het bijvoorbeeld om in een patroon van een zwarte en witte pixels die eruitzien als de originele grijstinten. +> Bekijk ook: `pbmreduce`. +> Meer informatie: . + +- Lees een PGM afbeelding, pas dithering toe en sla het op naar een bestand: + +`ppmditherbw {{pad/naar/afbeelding.pgm}} > {{pad/naar/bestand.pgm}}` + +- Gebruik de gespecificeerde kwantificering methode: + +`ppmditherbw -{{floyd|fs|atkinson|threshold|hilbert|...}} {{pad/naar/afbeelding.pgm}} > {{pad/naar/bestand.pgm}}` + +- Gebruik de atkinson kwantificering methode en de gespecifieerde seed voor een pseudo-random nummer generator: + +`ppmditherbw -atkinson -randomseed {{1337}} {{pad/naar/afbeelding.pgm}} > {{pad/naar/bestand.pgm}}` + +- Specificeer de drempel waarde van de kwantificering methodes die een vorm van drempels uitvoeren: + +`ppmditherbw -{{fs|atkinson|thresholding}} -value {{0.3}} {{pad/naar/afbeelding.pgm}} > {{pad/naar/bestand.pgm}}` diff --git a/pages.nl/common/pamedge.md b/pages.nl/common/pamedge.md new file mode 100644 index 000000000..7d0b5f68c --- /dev/null +++ b/pages.nl/common/pamedge.md @@ -0,0 +1,8 @@ +# pamedge + +> Voer randdetectie uit op een Netpbm afbeelding. +> Meer informatie: . + +- Voer randdetectie uit op een Netpbm afbeelding: + +`pamedge {{pad/naar/invoer.pam}} > {{pad/naar/uitvoer.pam}}` diff --git a/pages.nl/common/pamenlarge.md b/pages.nl/common/pamenlarge.md new file mode 100644 index 000000000..59411f409 --- /dev/null +++ b/pages.nl/common/pamenlarge.md @@ -0,0 +1,13 @@ +# pamenlarge + +> Vergroot een PAM afbeelding door de pixels te dupliceren. +> Bekijk ook: `pbmreduce`, `pamditherbw`, `pbmpscale`. +> Meer informatie: . + +- Vergroot de gespecificeerde afbeelding met de gespecificeerde factor: + +`pamenlarge -scale {{N}} {{pad/naar/afbeelding.pam}} > {{pad/naar/uitvoer.pam}}` + +- Vergroot de gespecificeerde afbeelding met de gespecificeerde factors horizontaal en verticaal: + +`pamenlarge -xscale {{XN}} -yscale {{YN}} {{pad/naar/afbeelding.pam}} > {{pad/naar/uitvoer.pam}}` diff --git a/pages.nl/common/pamfile.md b/pages.nl/common/pamfile.md new file mode 100644 index 000000000..3b379b3d1 --- /dev/null +++ b/pages.nl/common/pamfile.md @@ -0,0 +1,16 @@ +# pamfile + +> Beschrijf Netpbm (PAM or PNM) bestanden. +> Meer informatie: . + +- Beschrijf de gespecificeerde Netpbm bestanden: + +`pamfile {{pad/naar/bestand1 pad/naar/bestand2 ...}}` + +- Beschrijf iedere afbeelding in ieder invoerbestand (in tegenstelling tot alleen de eerste afbeelding in elk bestand) in een machine-leesbaar formaat: + +`pamfile -allimages -machine {{pad/naar/bestand}}` + +- Toon hoeveel afbeeldingen de invoerbestanden bevatten: + +`pamfile -count {{pad/naar/bestand}}` diff --git a/pages.nl/common/pamfix.md b/pages.nl/common/pamfix.md new file mode 100644 index 000000000..3b1652a8a --- /dev/null +++ b/pages.nl/common/pamfix.md @@ -0,0 +1,17 @@ +# pamfix + +> Repareer errors in PAM, PBM, PGM en PPM bestanden. +> Bekijk ook: `pamfile`, `pamvalidate`. +> Meer informatie: . + +- Repareer een Netpbm bestand dat zijn laatste deel mist: + +`pamfix -truncate {{pad/naar/corrupt.ext}} > {{pad/naar/uitvoer.ext}}` + +- Repareer een Netpbm bestand waar de pixel waardes de afbeelding's `maxval` overschrijden door de overtredende pixels te verlagen in waarde: + +`pamfix -clip {{pad/naar/corrupt.ext}} > {{pad/naar/uitvoer.ext}}` + +- Repareer een Netpbm bestand waar de pixel waardes de afbeelding's `maxval` overschrijden door deze te verhogen: + +`pamfix -changemaxval {{pad/naar/corrupt.pam|pbm|pgm|ppm}} > {{pad/naar/uitvoer.pam|pbm|pgm|ppm}}` diff --git a/pages.nl/common/pamfixtrunc.md b/pages.nl/common/pamfixtrunc.md new file mode 100644 index 000000000..11174839a --- /dev/null +++ b/pages.nl/common/pamfixtrunc.md @@ -0,0 +1,8 @@ +# pamfixtrunc + +> Dit commando is vervangen door `pamfix -truncate`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pamfix` diff --git a/pages.nl/common/pamflip.md b/pages.nl/common/pamflip.md new file mode 100644 index 000000000..ff0af50d9 --- /dev/null +++ b/pages.nl/common/pamflip.md @@ -0,0 +1,20 @@ +# pamflip + +> Flip of draai een PAM of PNM afbeelding. +> Meer informatie: . + +- Draai de invoer-afbeelding tegen de klok in met de gespecificeerde graden:: + +`pamflip -rotate{{90|180|270}} {{pad/naar/invoer.pam}} > {{pad/naar/uitvoer.pam}}` + +- Flip links met rechts: + +`pamflip -leftright {{pad/naar/invoer.pam}} > {{pad/naar/uitvoer.pam}}` + +- Flip boven met onder: + +`pamflip -topbottom {{pad/naar/invoer.pam}} > {{pad/naar/uitvoer.pam}}` + +- Flip de invoer-afbeelding met de diagonaal: + +`pamflip -transpose {{pad/naar/invoer.pam}} > {{pad/naar/uitvoer.pam}}` diff --git a/pages.nl/common/pamrgbatopng.md b/pages.nl/common/pamrgbatopng.md new file mode 100644 index 000000000..48669160c --- /dev/null +++ b/pages.nl/common/pamrgbatopng.md @@ -0,0 +1,8 @@ +# pamrgbatopng + +> Dit commando is vervangen door `pamtopng`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pamtopng` diff --git a/pages.nl/common/pamscale.md b/pages.nl/common/pamscale.md index 50bd0539c..f2d014d5a 100644 --- a/pages.nl/common/pamscale.md +++ b/pages.nl/common/pamscale.md @@ -1,6 +1,6 @@ # pamscale -> Schaal een Netpbm image. +> Schaal een Netpbm afbeelding. > Meer informatie: . - Schaal een afbeelding zodat het resultaat de gespecificeerde verhoudingen heeft: diff --git a/pages.nl/common/pamshadedrelief.md b/pages.nl/common/pamshadedrelief.md new file mode 100644 index 000000000..34ea286f7 --- /dev/null +++ b/pages.nl/common/pamshadedrelief.md @@ -0,0 +1,13 @@ +# pamshadedrelief + +> Genereer een schaduwwerking van een hoogtekaart. +> Bekijk ook: `pamcrater`, `ppmrelief`. +> Meer informatie: . + +- Genereer een schaduwwerking afbeelding met de invoer-afbeelding als een hoogtekaart: + +`pamshadedrelief < {{pad/naar/invoer.pam}} > {{pad/naar/uitvoer.pam}}` + +- Pas de gamma aan van een afbeelding met de gespecificeerde factor: + +`pamshadedrelief -gamma {{factor}} < {{pad/naar/invoer.pam}} > {{pad/naar/uitvoer.pam}}` diff --git a/pages.nl/common/pamslice.md b/pages.nl/common/pamslice.md new file mode 100644 index 000000000..33062ef49 --- /dev/null +++ b/pages.nl/common/pamslice.md @@ -0,0 +1,20 @@ +# pamslice + +> Haal een regel van waarden uit een PAM afbeelding. +> Meer informatie: . + +- Toon de waarden van de pixels in de opgegeven rij in een tabel: + +`pamslice -row {{n}} {{pad/naar/afbeelding.pam}}` + +- Toon de waarden van de pixels in de opgegeven kolom in een tabel: + +`pamslice -column {{n}} {{pad/naar/afbeelding.pam}}` + +- Beschouw alleen het opgegeven vlak (m) van de invoer-afbeelding: + +`pamslice -row {{n}} -plane {{m}} {{pad/naar/afbeelding.pam}}` + +- Produceer uitvoer in een formaat dat geschikt is voor invoer naar een `xmgr` voor visualisatie: + +`pamslice -row {{n}} -xmgr {{pad/naar/afbeelding.pam}}` diff --git a/pages.nl/common/pamsplit.md b/pages.nl/common/pamsplit.md new file mode 100644 index 000000000..8b3f89191 --- /dev/null +++ b/pages.nl/common/pamsplit.md @@ -0,0 +1,13 @@ +# pamsplit + +> Split een Netpbm bestand met meerdere afbeeldingen in meerdere Netpbm bestanden met een enkele afbeelding. +> Bekijk ook: `pamfile`, `pampick`, `pamexec`. +> Meer informatie: . + +- Split een Netpbm bestand met meerdere afbeeldingen in meerdere Netpbm bestanden met een enkele afbeelding: + +`pamsplit {{pad/naar/afbeelding.pam}}` + +- Specificeer een patroon voor de benaming van de uitvoerbestanden: + +`pamsplit {{pad/naar/afbeelding.pam}} {{file_%d.pam}}` diff --git a/pages.nl/common/pamstretch.md b/pages.nl/common/pamstretch.md new file mode 100644 index 000000000..67689e408 --- /dev/null +++ b/pages.nl/common/pamstretch.md @@ -0,0 +1,13 @@ +# pamstretch + +> Vergroot een PAM afbeelding door te interpoleren tussen pixels. +> Bekijk ook: `pamstretch-gen`, `pamenlarge`, `pamscale`. +> Meer informatie: . + +- Vergroot een PAM afbeelding met een gehele factor: + +`pamstretch {{N}} {{pad/naar/afbeelding.pam}} > {{pad/naar/uitvoer.pam}}` + +- Vergroot een PAM afbeelding met de gespecificeerde factoren in de horizontale en verticale richtingen: + +`pamstretch -xscale {{XN}} -yscale {{YN}} {{pad/naar/afbeelding.pam}} > {{pad/naar/uitvoer.pam}}` diff --git a/pages.nl/common/pamtofits.md b/pages.nl/common/pamtofits.md new file mode 100644 index 000000000..6595d68e4 --- /dev/null +++ b/pages.nl/common/pamtofits.md @@ -0,0 +1,9 @@ +# pamtofits + +> Converteer een Netpbm afbeelding naar het Flexible afbeelding Transport System (FITS) formaat. +> Bekijk ook: `fitstopnm`. +> Meer informatie: . + +- Converteer een Netpbm afbeelding naar het FITS formaat: + +`pamtofits {{pad/naar/afbeelding.pam}} > {{pad/naar/uitvoer.fits}}` diff --git a/pages.nl/common/pamtogif.md b/pages.nl/common/pamtogif.md new file mode 100644 index 000000000..eed73bd4e --- /dev/null +++ b/pages.nl/common/pamtogif.md @@ -0,0 +1,17 @@ +# pamtogif + +> Converteer een Netpbm afbeelding naar een ongeanimeerde GIF afbeelding. +> Bekijk ook: `giftopnm`, `gifsicle`. +> Meer informatie: . + +- Converteer een Netpbm afbeelding naar een ongeanimeerde GIF afbeelding: + +`pamtogif {{pad/naar/afbeelding.pam}} > {{pad/naar/uitvoer.gif}}` + +- Markeer de gespecificeerde kleur als transparent in het uitvoer GIF bestand: + +`pamtogif -transparent {{kleur}} {{pad/naar/afbeelding.pam}} > {{pad/naar/uitvoer.gif}}` + +- Voeg de gespecificeerde tekst toe als commentaar in het uitvoer GIF bestand: + +`pamtogif -comment "{{Hallo Wereld!}}" {{pad/naar/afbeelding.pam}} > {{pad/naar/uitvoer.gif}}` diff --git a/pages.nl/common/pamtopng.md b/pages.nl/common/pamtopng.md new file mode 100644 index 000000000..02d15c91c --- /dev/null +++ b/pages.nl/common/pamtopng.md @@ -0,0 +1,21 @@ +# pamtopng + +> Converteer een PAM afbeelding naar PNG. +> Bekijk ook: `pnmtopng`, `pngtopam`. +> Meer informatie: . + +- Converteer de gespecificeerde PAM afbeelding naar PNG: + +`pamtopng {{pad/naar/afbeelding.pam}} > {{pad/naar/uitvoer.png}}` + +- Markeer de gespecificeerde kleur als transparent in de uitvoer-afbeelding: + +`pamtopng -transparent {{kleur}} {{pad/naar/afbeelding.pam}} > {{pad/naar/uitvoer.png}}` + +- Voeg de tekst in gespecificeerde bestand toe als tEXt chunks in de uitvoer: + +`pamtopng -text {{pad/naar/bestand.txt}} {{pad/naar/afbeelding.pam}} > {{pad/naar/uitvoer.png}}` + +- Zorg ervoor dat het uitvoerbestand geïnterlaced is in Adam7-formaat: + +`pamtopng -interlace {{pad/naar/afbeelding.pam}} > {{pad/naar/uitvoer.png}}` diff --git a/pages.nl/common/pamtopnm.md b/pages.nl/common/pamtopnm.md index 2015b5b04..7eb2823e7 100644 --- a/pages.nl/common/pamtopnm.md +++ b/pages.nl/common/pamtopnm.md @@ -7,6 +7,6 @@ `pamtopnm {{pad/naar/afbeelding.pam}} > {{pad/naar/uitvoer.pbm|pgm|ppm}}` -- Toon versie: +- Toon de versie: `pamtopnm -version` diff --git a/pages.nl/common/pamtouil.md b/pages.nl/common/pamtouil.md new file mode 100644 index 000000000..7b7ea7ddc --- /dev/null +++ b/pages.nl/common/pamtouil.md @@ -0,0 +1,12 @@ +# pamtouil + +> Converteer een PNM of PAM bestand naar een Motif UIL icon bestand. +> Meer informatie: . + +- Converteer een PNM of PAM bestand naar een Motif UIL icon bestand: + +`pamtouil {{pad/naar/invoer.pnm|pam}} > {{pad/naar/uitvoer.uil}}` + +- Specificeer een voorvoegsel dat in het uitvoer-UIL-bestand moet worden afgedrukt: + +`pamtouil -name {{uilname}} {{pad/naar/invoer.pnm|pam}} > {{pad/naar/uitvoer.uil}}` diff --git a/pages.nl/common/pbmtoicon.md b/pages.nl/common/pbmtoicon.md new file mode 100644 index 000000000..69fca2e8f --- /dev/null +++ b/pages.nl/common/pbmtoicon.md @@ -0,0 +1,8 @@ +# pbmtoicon + +> Dit commando is vervangen door `pbmtosunicon`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pbmtosunicon` diff --git a/pages.nl/common/pbmtosunicon.md b/pages.nl/common/pbmtosunicon.md new file mode 100644 index 000000000..06b4fc9ea --- /dev/null +++ b/pages.nl/common/pbmtosunicon.md @@ -0,0 +1,8 @@ +# pbmtosunicon + +> Converteer een PBM afbeelding naar een Sun icon. +> Meer informatie: . + +- Converteer een PBM afbeelding naar een Sun icon: + +`pbmtosunicon {{pad/naar/invoer.pbm}} > {{pad/naar/uitvoer.ico}}` diff --git a/pages.nl/common/pbmtoxbm.md b/pages.nl/common/pbmtoxbm.md index 8950cb454..775e84aac 100644 --- a/pages.nl/common/pbmtoxbm.md +++ b/pages.nl/common/pbmtoxbm.md @@ -1,9 +1,9 @@ # pbmtoxbm -> Converteer een PBM image naar een X11 of X10 bitmap. +> Converteer een PBM afbeelding naar een X11 of X10 bitmap. > Meer informatie: . -- Converteer een PPM image naar een X11 XBM bestand: +- Converteer een PPM afbeelding naar een X11 XBM bestand: `pbmtoxbm {{pad/naar/invoer_bestand.pbm}} > {{pad/naar/uitvoer_bestand.xbm}}` diff --git a/pages.nl/common/pcdindex.md b/pages.nl/common/pcdindex.md new file mode 100644 index 000000000..e509fae96 --- /dev/null +++ b/pages.nl/common/pcdindex.md @@ -0,0 +1,8 @@ +# pcdindex + +> Dit commando is hernoemd naar `pcdovtoppm`. +> Meer informatie: . + +- Bekijk de documentatie voor het commando onder zijn huidige naam: + +`tldr pcdovtoppm` diff --git a/pages.nl/common/pcdovtoppm.md b/pages.nl/common/pcdovtoppm.md new file mode 100644 index 000000000..bd0ba74c4 --- /dev/null +++ b/pages.nl/common/pcdovtoppm.md @@ -0,0 +1,20 @@ +# pcdovtoppm + +> Maak een indexafbeelding voor een fotocd op basis van het overzichtsbestand. +> Meer informatie: . + +- Maak een PPM-indexafbeelding van een PCD-overzichtsbestand: + +`pcdovtoppm {{pad/naar/bestand.pcd}} > {{pad/naar/uitvoer.ppm}}` + +- Specificeer de [m]aximale breedte van de uitvoer-afbeelding en de maximale grootte ([s]) van elke afbeelding die in de uitvoer wordt opgenomen: + +`pcdovtoppm -m {{breedte}} -s {{grootte}} {{pad/naar/bestand.pcd}} > {{pad/naar/uitvoer.ppm}}` + +- Specificeer het maximale [a]antal afbeeldingen en het maximale aantal kleuren ([c]): + +`pcdovtoppm -a {{n_afbeeldingen}} -c {{n_kleuren}} {{pad/naar/bestand.pcd}} > {{pad/naar/uitvoer.ppm}}` + +- Gebruik het gespecificeerde lettertype ([f]) voor annotaties en kleur de achtergrond [w]it: + +`pcdovtoppm -f {{lettertype}} -w {{pad/naar/bestand.pcd}} > {{pad/naar/uitvoer.ppm}}` diff --git a/pages.nl/common/pgmcrater.md b/pages.nl/common/pgmcrater.md new file mode 100644 index 000000000..abaaf650f --- /dev/null +++ b/pages.nl/common/pgmcrater.md @@ -0,0 +1,16 @@ +# pgmcrater + +> Dit commando is vervangen door `pamcrater`, `pamshadedrelief` en `pamtopnm`. +> Meer informatie: . + +- Bekijk de documentatie voor `pamcrater`: + +`tldr pamcrater` + +- Bekijk de documentatie voor `pamshadedrelief`: + +`tldr pamshadedrelief` + +- Bekijk de documentatie voor `pamtopnm`: + +`tldr pamtopnm` diff --git a/pages.nl/common/pgmedge.md b/pages.nl/common/pgmedge.md new file mode 100644 index 000000000..14d5dcebc --- /dev/null +++ b/pages.nl/common/pgmedge.md @@ -0,0 +1,8 @@ +# pgmedge + +> Dit commando is vervangen door `pamedge`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pamedge` diff --git a/pages.nl/common/pgmnorm.md b/pages.nl/common/pgmnorm.md new file mode 100644 index 000000000..aa2bdf498 --- /dev/null +++ b/pages.nl/common/pgmnorm.md @@ -0,0 +1,8 @@ +# pgmnorm + +> Dit commando is vervangen door `pnmnorm`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pnmnorm` diff --git a/pages.nl/common/pgmslice.md b/pages.nl/common/pgmslice.md new file mode 100644 index 000000000..04a6bbd88 --- /dev/null +++ b/pages.nl/common/pgmslice.md @@ -0,0 +1,8 @@ +# pgmslice + +> Dit commando is vervangen door `pamslice`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pamslice` diff --git a/pages.nl/common/pgmtopbm.md b/pages.nl/common/pgmtopbm.md new file mode 100644 index 000000000..fff37f263 --- /dev/null +++ b/pages.nl/common/pgmtopbm.md @@ -0,0 +1,8 @@ +# pgmtopbm + +> Dit commando is vervangen door `pamditherbw`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pamditherbw` diff --git a/pages.nl/common/ping.md b/pages.nl/common/ping.md new file mode 100644 index 000000000..7cfb4a694 --- /dev/null +++ b/pages.nl/common/ping.md @@ -0,0 +1,28 @@ +# ping + +> Verstuur ICMP ECHO_REQUEST-pakketten naar netwerkhosts. +> Meer informatie: . + +- Ping host: + +`ping {{host}}` + +- Ping een host een specifiek aantal keren: + +`ping -c {{aantal}} {{host}}` + +- Ping host met een specifiek interval in seconden tussen verzoeken (standaard is 1 seconde): + +`ping -i {{seconden}} {{host}}` + +- Ping host zonder te proberen symbolische namen voor adressen op te zoeken: + +`ping -n {{host}}` + +- Ping host en laat een bel afgaan wanneer een pakket wordt ontvangen (als je terminal dit ondersteunt): + +`ping -a {{host}}` + +- Toon ook een bericht als er geen reactie is ontvangen: + +`ping -O {{host}}` diff --git a/pages.nl/common/ping6.md b/pages.nl/common/ping6.md new file mode 100644 index 000000000..de2db5a9f --- /dev/null +++ b/pages.nl/common/ping6.md @@ -0,0 +1,24 @@ +# ping6 + +> Verstuur ICMP ECHO_REQUEST-pakketten naar netwerkhosts via een IPv6-adres. +> Meer informatie: . + +- Ping een host: + +`ping6 {{host}}` + +- Ping een host een specifiek aantal keren: + +`ping6 -c {{aantal}} {{host}}` + +- Ping een host met een specifiek interval in seconden tussen verzoeken (standaard is 1 seconde): + +`ping6 -i {{seconden}} {{host}}` + +- Ping een host zonder te proberen symbolische namen voor adressen op te zoeken: + +`ping6 -n {{host}}` + +- Ping een host en laat een bel afgaan wanneer een pakket wordt ontvangen (als je terminal dit ondersteunt): + +`ping6 -a {{host}}` diff --git a/pages.nl/common/pio-init.md b/pages.nl/common/pio-init.md index 9f17782cf..df40e16f1 100644 --- a/pages.nl/common/pio-init.md +++ b/pages.nl/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > Dit commando is een alias van `pio project`. diff --git a/pages.nl/common/pio-system.md b/pages.nl/common/pio-system.md index 3fcba0c31..31432fe85 100644 --- a/pages.nl/common/pio-system.md +++ b/pages.nl/common/pio-system.md @@ -3,7 +3,7 @@ > Gemengde systeem commando's voor PlatformIO. > Meer informatie: . -- Installeer shell completion voor de huidige shell (ondersteund Bash, Fish, Zsh en PowerShell): +- Installeer shell completion voor de huidige shell (ondersteund Bash, fish, Zsh en PowerShell): `pio system completion install` diff --git a/pages.nl/common/pngtopam.md b/pages.nl/common/pngtopam.md new file mode 100644 index 000000000..1a85ddd36 --- /dev/null +++ b/pages.nl/common/pngtopam.md @@ -0,0 +1,21 @@ +# pngtopam + +> Converteer een PNG afbeelding naar een Netpbm afbeelding. +> Bekijk ook: `pamtopng`. +> Meer informatie: . + +- Converteer de gespecificeerde PNG afbeelding naar een Netpbm afbeelding: + +`pngtopam {{pad/naar/afbeelding.png}} > {{pad/naar/uitvoer.pam}}` + +- Maak een uitvoerafbeelding die zowel de hoofdafbeelding als de transparantiemasker van de invoerafbeelding bevat: + +`pngtopam -alphapam {{pad/naar/afbeelding.png}} > {{pad/naar/uitvoer.pam}}` + +- Vervang transparente pixels door de gespecificeerde kleur: + +`pngtopam -mix -background {{kleur}} {{pad/naar/afbeelding.png}} > {{pad/naar/uitvoer.pam}}` + +- Schrijf tEXt chunks gevonden in de invoer-afbeelding naar het gespecificeerde tekstbestand: + +`pngtopam -text {{pad/naar/bestand.txt}} {{pad/naar/afbeelding.png}} > {{pad/naar/uitvoer.pam}}` diff --git a/pages.nl/common/pngtopnm.md b/pages.nl/common/pngtopnm.md new file mode 100644 index 000000000..1bc404e48 --- /dev/null +++ b/pages.nl/common/pngtopnm.md @@ -0,0 +1,8 @@ +# pngtopnm + +> Dit commando is vervangen door `pngtopam`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pngtopam` diff --git a/pages.nl/common/pnmarith.md b/pages.nl/common/pnmarith.md new file mode 100644 index 000000000..98a61bcca --- /dev/null +++ b/pages.nl/common/pnmarith.md @@ -0,0 +1,8 @@ +# pnmarith + +> Dit commando is vervangen door `pamarith`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pamarith` diff --git a/pages.nl/common/pnmcolormap.md b/pages.nl/common/pnmcolormap.md new file mode 100644 index 000000000..2475f01b6 --- /dev/null +++ b/pages.nl/common/pnmcolormap.md @@ -0,0 +1,16 @@ +# pnmcolormap + +> Maak een kwantisatiekleurkaart voor een PNM afbeelding. +> Meer informatie: . + +- Genereer een afbeelding met alleen `n_kleuren` of minder kleuren, zo dicht als mogelijk bij de invoer-afbeelding: + +`pnmcolormap {{n_kleuren}} {{pad/naar/invoer.pnm}} > {{pad/naar/uitvoer.ppm}}` + +- Gebruik de splitspread strategie voor het bepalen van de uitvoer-kleuren, welke waarschijnlijk een beter resultaat oplevert met afbeeldingen met kleine details: + +`pnmcolormap -splitspread {{n_kleuren}} {{pad/naar/invoer.pnm}} > {{pad/naar/uitvoer.ppm}}` + +- Sorteer de resulteerde kleurkaart, welke nuttig is voor het vergelijken van kleurkaarten: + +`pnmcolormap -sort {{pad/naar/invoer.pnm}} > {{pad/naar/uitvoer.ppm}}` diff --git a/pages.nl/common/pnmcut.md b/pages.nl/common/pnmcut.md new file mode 100644 index 000000000..a25981a89 --- /dev/null +++ b/pages.nl/common/pnmcut.md @@ -0,0 +1,8 @@ +# pnmcut + +> Dit commando is vervangen door `pamcut`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pamcut` diff --git a/pages.nl/common/pnmenlarge.md b/pages.nl/common/pnmenlarge.md new file mode 100644 index 000000000..f6560a9c2 --- /dev/null +++ b/pages.nl/common/pnmenlarge.md @@ -0,0 +1,8 @@ +# pnmenlarge + +> Dit commando is vervangen door `pamenlarge`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pamenlarge` diff --git a/pages.nl/common/pnmfile.md b/pages.nl/common/pnmfile.md new file mode 100644 index 000000000..0b478b98d --- /dev/null +++ b/pages.nl/common/pnmfile.md @@ -0,0 +1,8 @@ +# pnmfile + +> Dit commando is vervangen door `pamfile`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pamfile` diff --git a/pages.nl/common/pnmflip.md b/pages.nl/common/pnmflip.md new file mode 100644 index 000000000..f7c476dd9 --- /dev/null +++ b/pages.nl/common/pnmflip.md @@ -0,0 +1,8 @@ +# pnmflip + +> Dit commando is vervangen door `pamflip`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pamflip` diff --git a/pages.nl/common/pnminterp.md b/pages.nl/common/pnminterp.md new file mode 100644 index 000000000..5973e4690 --- /dev/null +++ b/pages.nl/common/pnminterp.md @@ -0,0 +1,8 @@ +# pnminterp + +> Dit commando is vervangen door `pamstretch`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pamstretch` diff --git a/pages.nl/common/pnmnorm.md b/pages.nl/common/pnmnorm.md new file mode 100644 index 000000000..c1ac803e4 --- /dev/null +++ b/pages.nl/common/pnmnorm.md @@ -0,0 +1,21 @@ +# pnmnorm + +> Normaliseer het contrast in een PNM afbeelding. +> Bekijk ook: `pnmhisteq`. +> Meer informatie: . + +- Forceer de helderste pixels om wit te zijn, de donkerste pixels om zwart te zijn en verspreid de tussenliggende pixels lineair: + +`pnmnorm {{pad/naar/afbeelding.pnm}} > {{pad/naar/uitvoer.pnm}}` + +- Forceer de helderste pixels om wit te zijn, de donkerste pixels om zwart te zijn en verspreid de tussenliggende pixels kwadratisch zodat pixels met een helderheid van `n` 50% helderder worden: + +`pnmnorm -midvalue {{n}} {{pad/naar/afbeelding.pnm}} > {{pad/naar/uitvoer.pnm}}` + +- Behoud de tint van de pixels, pas alleen de helderheid aan: + +`pnmnorm -keephues {{pad/naar/afbeelding.pnm}} > {{pad/naar/uitvoer.pnm}}` + +- Specificeer een methode om de helderheid van een pixel te berekenen: + +`pnmnorm -{{luminosity|colorvalue|saturation}} {{pad/naar/afbeelding.pnm}} > {{pad/naar/uitvoer.pnm}}` diff --git a/pages.nl/common/pnmquantall.md b/pages.nl/common/pnmquantall.md new file mode 100644 index 000000000..ecd7710f7 --- /dev/null +++ b/pages.nl/common/pnmquantall.md @@ -0,0 +1,13 @@ +# pnmquantall + +> Voer `pnmquant` tegelijk uit op meerdere bestanden zodat deze een kleurkaart delen. +> Bekijk ook: `pnmquant`. +> Meer informatie: . + +- Voer `pnmquant` uit op meerdere bestanden met de gespecificeerde parameters en overschrijf de originele bestanden: + +`pnmquantall {{n_kleuren}} {{pad/naar/invoer1.pnm pad/naar/invoer2.pnm ...}}` + +- Sla de gekwantificeerde afbeeldingen op naar bestanden met dezelfde namen als de invoerbestanden, maar met de gespecificeerde extensie: + +`pnmquantall -ext {{extensie}} {{n_kleuren}} {{pad/naar/invoer1.pnm pad/naar/invoer2.pnm ...}}` diff --git a/pages.nl/common/pnmsplit.md b/pages.nl/common/pnmsplit.md new file mode 100644 index 000000000..8e7643322 --- /dev/null +++ b/pages.nl/common/pnmsplit.md @@ -0,0 +1,8 @@ +# pnmsplit + +> Dit commando is vervangen door `pamsplit`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pamsplit` diff --git a/pages.nl/common/pnmtofits.md b/pages.nl/common/pnmtofits.md new file mode 100644 index 000000000..80c5f6293 --- /dev/null +++ b/pages.nl/common/pnmtofits.md @@ -0,0 +1,8 @@ +# pnmtofits + +> Dit commando is vervangen door `pamtofits`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pamtofits` diff --git a/pages.nl/common/pnmtojpeg.md b/pages.nl/common/pnmtojpeg.md new file mode 100644 index 000000000..6f89e5717 --- /dev/null +++ b/pages.nl/common/pnmtojpeg.md @@ -0,0 +1,12 @@ +# pnmtojpeg + +> Converteer een PNM afbeelding naar het JPEG/JFIF/EXIF afbeeldingsformaat. +> Meer informatie: . + +- Lees een PNM afbeelding als invoer en produceer een JPEG/JFIF/EXIF afbeelding als uitvoer: + +`pnmtojpeg {{pad/naar/bestand.pnm}} > {{pad/naar/bestand.jpg}}` + +- Toon de versie: + +`pnmtojpeg -version` diff --git a/pages.nl/common/ppmbrighten.md b/pages.nl/common/ppmbrighten.md new file mode 100644 index 000000000..1b013a345 --- /dev/null +++ b/pages.nl/common/ppmbrighten.md @@ -0,0 +1,8 @@ +# ppmbrighten + +> Dit commando is vervangen door `pambrighten`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pambrighten` diff --git a/pages.nl/common/ppmnorm.md b/pages.nl/common/ppmnorm.md new file mode 100644 index 000000000..523f49df5 --- /dev/null +++ b/pages.nl/common/ppmnorm.md @@ -0,0 +1,8 @@ +# ppmnorm + +> Dit commando is vervangen door `pnmnorm`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pnmnorm` diff --git a/pages.nl/common/ppmquantall.md b/pages.nl/common/ppmquantall.md new file mode 100644 index 000000000..54095a594 --- /dev/null +++ b/pages.nl/common/ppmquantall.md @@ -0,0 +1,8 @@ +# ppmquantall + +> Dit commando is vervangen door `pnmquantall`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pnmquantall` diff --git a/pages.nl/common/ppmtogif.md b/pages.nl/common/ppmtogif.md new file mode 100644 index 000000000..987efabdc --- /dev/null +++ b/pages.nl/common/ppmtogif.md @@ -0,0 +1,8 @@ +# ppmtogif + +> Dit commando is vervangen door `pamtogif`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pamtogif` diff --git a/pages.nl/common/ppmtojpeg.md b/pages.nl/common/ppmtojpeg.md new file mode 100644 index 000000000..5f956e9c9 --- /dev/null +++ b/pages.nl/common/ppmtojpeg.md @@ -0,0 +1,8 @@ +# ppmtojpeg + +> Dit commando is vervangen door `pnmtojpeg`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pnmtojpeg` diff --git a/pages.nl/common/ppmtomap.md b/pages.nl/common/ppmtomap.md new file mode 100644 index 000000000..a61518490 --- /dev/null +++ b/pages.nl/common/ppmtomap.md @@ -0,0 +1,8 @@ +# ppmtomap + +> Dit commando is vervangen door `pnmcolormap`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pnmcolormap` diff --git a/pages.nl/common/ppmtouil.md b/pages.nl/common/ppmtouil.md new file mode 100644 index 000000000..2cbc7a670 --- /dev/null +++ b/pages.nl/common/ppmtouil.md @@ -0,0 +1,8 @@ +# ppmtouil + +> Dit commando is vervangen door `pamtouil`. +> Meer informatie: . + +- Bekijk de documentatie van het huidige commando: + +`tldr pamtouil` diff --git a/pages.nl/common/readlink.md b/pages.nl/common/readlink.md new file mode 100644 index 000000000..eb608afa1 --- /dev/null +++ b/pages.nl/common/readlink.md @@ -0,0 +1,12 @@ +# readlink + +> Volg symlinks en verkrijg symlink-informatie. +> Meer informatie: . + +- Toon het werkelijke bestand waarnaar de symlink verwijst: + +`readlink {{pad/naar/bestand}}` + +- Toon het absolute pad naar een bestand: + +`readlink -f {{pad/naar/bestand}}` diff --git a/pages.nl/common/rm.md b/pages.nl/common/rm.md index e386b3e14..0605d543f 100644 --- a/pages.nl/common/rm.md +++ b/pages.nl/common/rm.md @@ -1,7 +1,7 @@ # rm > Verwijder bestanden of mappen. -> Zie ook: `rmdir`. +> Bekijk ook: `rmdir`. > Meer informatie: . - Verwijder specifieke bestanden: diff --git a/pages.nl/common/ruff-check.md b/pages.nl/common/ruff-check.md new file mode 100644 index 000000000..c19f3d15b --- /dev/null +++ b/pages.nl/common/ruff-check.md @@ -0,0 +1,33 @@ +# ruff check + +> Een extreem snelle Python linter. `check` is het standaard commando - het kan overal weggelaten worden. +> Als geen bestanden of mappen zijn gespecificeerd, wordt de huidige map gebruikt. +> Meer informatie: . + +- Voer de linter uit op de opgegeven bestanden of mappen: + +`ruff check {{pad/naar/bestand_of_map1 pad/naar/bestand_of_map2 ...}}` + +- Voer de gesuggereerde fixes uit en pas de bestanden in-place aan: + +`ruff check --fix` + +- Voer de linter uit en re-lint op iedere wijziging: + +`ruff check --watch` + +- Zet alleen de gespecificeerde regels (of alle regels) aan en negeer het configuratie bestand: + +`ruff check --select {{ALL|regelcode1,regelcode2,...}}` + +- Zet additioneel de gespecificeerde regels aan: + +`ruff check --extend-select {{regelcode1,regelcode2,...}}` + +- Zet de gespecificeerde regels uit: + +`ruff check --ignore {{regelcode1,regelcode2,...}}` + +- Negeer alle bestaande schendingen van een regel door `# noqa` toe te voegen aan alle regels die de regel breken: + +`ruff check --select {{regelcode}} --add-noqa` diff --git a/pages.nl/common/ruff-format.md b/pages.nl/common/ruff-format.md new file mode 100644 index 000000000..904036709 --- /dev/null +++ b/pages.nl/common/ruff-format.md @@ -0,0 +1,17 @@ +# ruff format + +> Een extreem snelle Python code formatter. +> Als geen bestanden of mappen zijn gespecificeerd, wordt de huidige map gebruikt. +> Meer informatie: . + +- Formateer opgegeven bestanden of mappen in-place: + +`ruff format {{pad/naar/bestand_of_map1 pad/naar/bestand_of_map2 ...}}` + +- Toon welke bestanden aangepast zouden worden en return een niet-nul exit code als er bestanden zijn om te formatteren en anders nul: + +`ruff format --check` + +- Toon welke veranderingen er gemaakt zouden worden zonder de bestanden aan te passen: + +`ruff format --diff` diff --git a/pages.nl/common/ruff.md b/pages.nl/common/ruff.md new file mode 100644 index 000000000..e70f3d1ff --- /dev/null +++ b/pages.nl/common/ruff.md @@ -0,0 +1,12 @@ +# ruff + +> Een extreem snelle Python linter en code formatter, geschreven in Rust. +> Meer informatie: . + +- Bekijk de documentatie voor de Ruff linter: + +`tldr ruff check` + +- Bekijk de documentatie voor de Ruff code formatter: + +`tldr ruff format` diff --git a/pages.nl/common/sed.md b/pages.nl/common/sed.md index d420863b0..aba621326 100644 --- a/pages.nl/common/sed.md +++ b/pages.nl/common/sed.md @@ -2,7 +2,7 @@ > Pas tekst aan in een op een scriptbare manier. > Bekijk ook: `awk`, `ed`. -> Meer informatie: . +> Meer informatie: . - Vervang alle `apple` (basis regex) met `mango` (basis regex) in alle invoerregels en toon het resultaat in `stdout`: diff --git a/pages.nl/common/shuf.md b/pages.nl/common/shuf.md new file mode 100644 index 000000000..8e81a5b6a --- /dev/null +++ b/pages.nl/common/shuf.md @@ -0,0 +1,20 @@ +# shuf + +> Genereer willekeurige permutaties. +> Meer informatie: . + +- Wijzig willekeurig de volgorde van regels in een bestand en toon het resultaat: + +`shuf {{pad/naar/bestand}}` + +- Toon alleen de eerste 5 regels van het resultaat: + +`shuf --head-count=5 {{pad/naar/bestand}}` + +- Schrijf de uitvoer naar een ander bestand: + +`shuf {{pad/naar/invoer_bestand}} --output={{pad/naar/uitvoer_bestand}}` + +- Genereer 3 willekeurige getallen in het bereik van 1 tot 10 (inclusief): + +`shuf --head-count=3 --input-range=1-10 --repeat` diff --git a/pages.nl/common/sleep.md b/pages.nl/common/sleep.md new file mode 100644 index 000000000..22d4df69f --- /dev/null +++ b/pages.nl/common/sleep.md @@ -0,0 +1,12 @@ +# sleep + +> Wacht voor een gespecificeerde hoeveelheid tijd. +> Meer informatie: . + +- Wacht in seconden: + +`sleep {{seconden}}` + +- Voer een specifiek commando uit na een wachttijd van 20 seconden: + +`sleep 20 && {{commando}}` diff --git a/pages.nl/common/split.md b/pages.nl/common/split.md new file mode 100644 index 000000000..e7f936032 --- /dev/null +++ b/pages.nl/common/split.md @@ -0,0 +1,20 @@ +# split + +> Split een bestand in stukken. +> Meer informatie: . + +- Split een bestand, elk deel heeft 10 regels (behalve het laatste deel): + +`split -l 10 {{pad/naar/bestand}}` + +- Split een bestand in 5 bestanden. Het bestand wordt zo gesplitst dat elk deel dezelfde grootte heeft (behalve het laatste deel): + +`split -n 5 {{pad/naar/bestand}}` + +- Split een bestand met 512 bytes in elk deel (behalve het laatste deel; gebruik 512k voor kilobytes en 512m voor megabytes): + +`split -b 512 {{pad/naar/bestand}}` + +- Splits een bestand met maximaal 512 bytes in elk deel zonder regels te breken: + +`split -C 512 {{pad/naar/bestand}}` diff --git a/pages.nl/common/stat.md b/pages.nl/common/stat.md new file mode 100644 index 000000000..25e30ba66 --- /dev/null +++ b/pages.nl/common/stat.md @@ -0,0 +1,28 @@ +# stat + +> Toon bestands- en bestandssysteeminformatie. +> Meer informatie: . + +- Toon eigenschappen van een specifiek bestand zoals grootte, permissies, aanmaak- en toegangsdatums en meer: + +`stat {{pad/naar/bestand}}` + +- Toon eigenschappen van een specifiek bestand zoals grootte, permissies, aanmaak- en toegangsdatums en meer zonder labels: + +`stat --terse {{pad/naar/bestand}}` + +- Toon informatie over het bestandssysteem waar een specifiek bestand zich bevindt: + +`stat --file-system {{pad/naar/bestand}}` + +- Toon alleen octale bestandspermissies: + +`stat --format="%a %n" {{pad/naar/bestand}}` + +- Toon de eigenaar en groep van een specifiek bestand: + +`stat --format="%U %G" {{pad/naar/bestand}}` + +- Toon de grootte van een specifiek bestand in bytes: + +`stat --format="%s %n" {{pad/naar/bestand}}` diff --git a/pages.nl/common/strings.md b/pages.nl/common/strings.md index cf12d10b0..9dd56a808 100644 --- a/pages.nl/common/strings.md +++ b/pages.nl/common/strings.md @@ -3,7 +3,7 @@ > Vind printbare strings in een object bestand of binary. > Meer informatie: . -- Print alle strings in een binary: +- Toon alle strings in een binary: `strings {{pad/naar/bestand}}` diff --git a/pages.nl/common/sunicontopnm.md b/pages.nl/common/sunicontopnm.md new file mode 100644 index 000000000..d0688574a --- /dev/null +++ b/pages.nl/common/sunicontopnm.md @@ -0,0 +1,8 @@ +# sunicontopnm + +> Converteer een Sun icon naar een Netpbm afbeelding. +> Meer informatie: . + +- Converteer een Sun icon naar een Netpbm afbeelding: + +`sunicontopnm {{pad/naar/invoer.ico}} > {{pad/naar/uitvoer.pbm}}` diff --git a/pages.nl/common/tac.md b/pages.nl/common/tac.md new file mode 100644 index 000000000..a67b55bf9 --- /dev/null +++ b/pages.nl/common/tac.md @@ -0,0 +1,25 @@ +# tac + +> Toon en voeg bestanden samen met regels in omgekeerde volgorde. +> Bekijk ook: `cat`. +> Meer informatie: . + +- Voeg specifieke bestanden samen in omgekeerde volgorde: + +`tac {{pad/naar/bestand1 pad/naar/bestand2 ...}}` + +- Toon `stdin` in omgekeerde volgorde: + +`{{cat pad/naar/bestand}} | tac` + +- Gebruik een specifiek [s]cheidingsteken: + +`tac -s {{scheidingsteken}} {{pad/naar/bestand1 pad/naar/bestand2 ...}}` + +- Gebruik een specifieke [r]egex als [s]cheidingsteken: + +`tac -r -s {{scheidingsteken}} {{pad/naar/bestand1 pad/naar/bestand2 ...}}` + +- Gebruik een scheidingsteken vóór ([b]) elk bestand: + +`tac -b {{pad/naar/bestand1 pad/naar/bestand2 ...}}` diff --git a/pages.nl/common/time.md b/pages.nl/common/time.md index 78c9dd910..22945575d 100644 --- a/pages.nl/common/time.md +++ b/pages.nl/common/time.md @@ -1,7 +1,7 @@ # time > Meet hoe lang het uitvoeren van een commando duurt. -> Opmerking: `time` kan ofwel bestaan als een shell builtin, een op zichzelf staand programma of beide. +> Let op: `time` kan ofwel bestaan als een shell builtin, een op zichzelf staand programma of beide. > Meer informatie: . - Voer het `commando` uit en print de tijdmetingen naar `stdout`:: diff --git a/pages.nl/common/tlmgr-arch.md b/pages.nl/common/tlmgr-arch.md index 1f26ef864..6a6abc902 100644 --- a/pages.nl/common/tlmgr-arch.md +++ b/pages.nl/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > Dit commando is een alias van `tlmgr platform`. > Meer informatie: . diff --git a/pages.nl/common/transmission-cli.md b/pages.nl/common/transmission-cli.md index b7859389f..6dd993531 100644 --- a/pages.nl/common/transmission-cli.md +++ b/pages.nl/common/transmission-cli.md @@ -14,7 +14,7 @@ - Maak een torrent bestand van een specifiek bestand of map: -`transmission-cli --new {{pad/naar/bron_bestand_of_map}}` +`transmission-cli --new {{pad/naar/bronbestand_of_map}}` - Zet de download snelheid limiet naar 50 KB/s: diff --git a/pages.nl/common/tty.md b/pages.nl/common/tty.md index 934aca1e9..148c7fe0a 100644 --- a/pages.nl/common/tty.md +++ b/pages.nl/common/tty.md @@ -3,6 +3,6 @@ > Geeft de naam van de terminal terug. > Meer informatie: . -- Druk de bestandsnaam van deze terminal af: +- Toon de bestandsnaam van deze terminal: `tty` diff --git a/pages.nl/common/uname.md b/pages.nl/common/uname.md new file mode 100644 index 000000000..69bc43df2 --- /dev/null +++ b/pages.nl/common/uname.md @@ -0,0 +1,25 @@ +# uname + +> Toon details over de huidige machine en het besturingssysteem dat erop draait. +> Zie ook `lsb_release`. +> Meer informatie: . + +- Toon de kernelnaam: + +`uname` + +- Toon systeemarchitectuur en processorinformatie: + +`uname --machine --processor` + +- Toon kernelnaam, kernelrelease en kernelversie: + +`uname --kernel-name --kernel-release --kernel-version` + +- Toon de systeemhostname: + +`uname --nodename` + +- Toon alle beschikbare systeeminformatie: + +`uname --all` diff --git a/pages.nl/common/uptime.md b/pages.nl/common/uptime.md new file mode 100644 index 000000000..41cbbd49d --- /dev/null +++ b/pages.nl/common/uptime.md @@ -0,0 +1,20 @@ +# uptime + +> Toon hoe lang het systeem actief is en andere informatie. +> Meer informatie: . + +- Toon de huidige tijd, uptime, aantal ingelogde gebruikers en andere informatie: + +`uptime` + +- Toon alleen de tijd dat het systeem is opgestart: + +`uptime --pretty` + +- Toon de datum en tijd waarop het systeem is opgestart: + +`uptime --since` + +- Toon de versie: + +`uptime --version` diff --git a/pages.nl/common/vim.md b/pages.nl/common/vim.md index 10259fbcd..ec98225dd 100644 --- a/pages.nl/common/vim.md +++ b/pages.nl/common/vim.md @@ -11,7 +11,7 @@ - Open een bestand bij een bepaald regelnummer: -`vim +{{regel_nummer}} {{pad/naar/bestand}}` +`vim +{{regelnummer}} {{pad/naar/bestand}}` - Bekijk de handleiding van Vim: diff --git a/pages.nl/common/visudo.md b/pages.nl/common/visudo.md index f62fc33a9..7101e86f0 100644 --- a/pages.nl/common/visudo.md +++ b/pages.nl/common/visudo.md @@ -15,6 +15,6 @@ `sudo EDITOR={{editor}} visudo` -- Toon versie informatie: +- Toon de versie: `visudo --version` diff --git a/pages.nl/common/wc.md b/pages.nl/common/wc.md new file mode 100644 index 000000000..a46fd0ebc --- /dev/null +++ b/pages.nl/common/wc.md @@ -0,0 +1,28 @@ +# wc + +> Tel regels, woorden en bytes. +> Meer informatie: . + +- Tel alle regels in een bestand: + +`wc --lines {{pad/naar/bestand}}` + +- Tel alle woorden in een bestand: + +`wc --words {{pad/naar/bestand}}` + +- Tel alle bytes in een bestand: + +`wc --bytes {{pad/naar/bestand}}` + +- Tel alle karakters in een bestand (rekening houdend met multi-byte karakters): + +`wc --chars {{pad/naar/bestand}}` + +- Tel alle regels, woorden en bytes van `stdin`: + +`{{find .}} | wc` + +- Tel de lengte van de langste regel in aantal karakters: + +`wc --max-line-length {{pad/naar/bestand}}` diff --git a/pages.nl/common/whoami.md b/pages.nl/common/whoami.md new file mode 100644 index 000000000..e5b432c0f --- /dev/null +++ b/pages.nl/common/whoami.md @@ -0,0 +1,12 @@ +# whoami + +> Toon de gebruikersnaam die is gekoppeld aan de huidige effectieve gebruikers-ID. +> Meer informatie: . + +- Toon de momenteel ingelogde gebruikersnaam: + +`whoami` + +- Toon de gebruikersnaam na een wijziging in de gebruikers-ID: + +`sudo whoami` diff --git a/pages.nl/common/xz.md b/pages.nl/common/xz.md index 51a415ad4..c21cd1f92 100644 --- a/pages.nl/common/xz.md +++ b/pages.nl/common/xz.md @@ -1,6 +1,6 @@ # xz -> Comprimeren of decomprimeren van `.xz` en `.lzma` bestanden. +> Comprimeren of decomprimeren van XZ en LZMA bestanden. > Meer informatie: . - Comprimeer een bestand gebruik makend van xz file: @@ -15,7 +15,7 @@ `xz --format=lzma {{pad/naar/bestand}}` -- Decomprimer een lzma bestand: +- Decomprimer een LZMA bestand: `xz --decompress --format=lzma {{pad/naar/bestand.lzma}}` diff --git a/pages.nl/common/xzgrep.md b/pages.nl/common/xzgrep.md index 0f56bb689..eb51f426b 100644 --- a/pages.nl/common/xzgrep.md +++ b/pages.nl/common/xzgrep.md @@ -1,7 +1,7 @@ # xzgrep > Zoek bestanden die mogelijk worden gecomprimeerd met `xz`, `lzma`, `gzip`, `bzip2`, `lzop`, of `zstd` met behulp van reguliere expressies. -> Zie ook: `grep`. +> Bekijk ook: `grep`. > Meer informatie: . - Zoek naar een patroon in een bestand: diff --git a/pages.nl/common/xzless.md b/pages.nl/common/xzless.md index 8ef53a846..4909d8342 100644 --- a/pages.nl/common/xzless.md +++ b/pages.nl/common/xzless.md @@ -1,7 +1,7 @@ # xzless > Tekst weergeven van `xz` en `lzma` gecomprimeerde bestanden. -> Zie ook: `less`. +> Bekijk ook: `less`. > Meer informatie: . - Bekijk een gecomprimeerd bestand: diff --git a/pages.nl/common/yapf.md b/pages.nl/common/yapf.md index 088450697..5f4a1584a 100644 --- a/pages.nl/common/yapf.md +++ b/pages.nl/common/yapf.md @@ -3,11 +3,11 @@ > Python stijlgidschecker. > Meer informatie: . -- Print de geformateerde diff die zal optreden uit: +- Toon de geformateerde diff die zal optreden uit: `yapf --diff {{pad/naar/bestand}}` -- Print de geformateerde diff uit en breng de wijzigingen aan in het bestand: +- Toon de geformateerde diff uit en breng de wijzigingen aan in het bestand: `yapf --diff --in-place {{pad/naar/bestand}}` diff --git a/pages.nl/common/yes.md b/pages.nl/common/yes.md index bf80b6fbe..a6d27a1b4 100644 --- a/pages.nl/common/yes.md +++ b/pages.nl/common/yes.md @@ -4,11 +4,11 @@ > Deze opdracht wordt vaak gebruikt om ja te beantwoorden op elke prompt door installatieopdrachten (zoals apt-get). > Meer informatie: . -- Print herhaaldelijk "bericht": +- Toon herhaaldelijk "bericht": `yes {{bericht}}` -- Print herhaaldelijk "y": +- Toon herhaaldelijk "y": `yes` @@ -16,6 +16,6 @@ `yes | sudo apt-get install {{programma}}` -- Print herhaaldelijk een nieuwe regel om altijd de standaard optie van een vraag te accepteren: +- Toon herhaaldelijk een nieuwe regel om altijd de standaard optie van een vraag te accepteren: `yes ''` diff --git a/pages.nl/common/ykman-config.md b/pages.nl/common/ykman-config.md index 67007446a..88d0c69c3 100644 --- a/pages.nl/common/ykman-config.md +++ b/pages.nl/common/ykman-config.md @@ -1,7 +1,7 @@ # ykman config > In- of uitschakelen van YubiKey applicaties. -> Opmerking: je kan `ykman info` gebruiken om de huidige ingeschakelde applicaties te zien. +> Let op: je kan `ykman info` gebruiken om de huidige ingeschakelde applicaties te zien. > Meer informatie: . - Schakel een applicatie in via USB of NFC (`--enable` kan meerdere keren gebruikt worden om meerdere applicaties te specificeren): diff --git a/pages.nl/common/ykman-openpgp.md b/pages.nl/common/ykman-openpgp.md index ef3583b2d..220285c81 100644 --- a/pages.nl/common/ykman-openpgp.md +++ b/pages.nl/common/ykman-openpgp.md @@ -1,7 +1,7 @@ # ykman openpgp > Beheer de OpenPGP YubiKey applicatie. -> Opmerking: je dient `gpg --card-edit` te gebruiken voor sommige instellingen. +> Let op: je dient `gpg --card-edit` te gebruiken voor sommige instellingen. > Meer informatie: . - Toon algemene informatie over de OpenPGP applicatie: diff --git a/pages.nl/freebsd/cal.md b/pages.nl/freebsd/cal.md new file mode 100644 index 000000000..455420d1d --- /dev/null +++ b/pages.nl/freebsd/cal.md @@ -0,0 +1,32 @@ +# cal + +> Toon een kalender met de huidige dag gemarkeerd. +> Meer informatie: . + +- Toon een kalender voor de huidige maand: + +`cal` + +- Toon een kalender voor een specifiek jaar: + +`cal {{jaar}}` + +- Toon een kalender voor een specifieke maand en jaar: + +`cal {{maand}} {{jaar}}` + +- Toon de volledige kalender voor het huidige jaar: + +`cal -y` + +- Markeer ([h]) vandaag niet en toon [3] maanden rondom de datum: + +`cal -h -3 {{maand}} {{jaar}}` + +- Toon de 2 maanden voor ([B]) en 3 maanden na ([A]) een specifieke [m]aand van het huidige jaar: + +`cal -A 3 -B 2 {{maand}}` + +- Toon [j]ulian dagen (beginnend vanaf één, genummerd vanaf 1 januari): + +`cal -j` diff --git a/pages.nl/freebsd/chpass.md b/pages.nl/freebsd/chpass.md new file mode 100644 index 000000000..be918d141 --- /dev/null +++ b/pages.nl/freebsd/chpass.md @@ -0,0 +1,33 @@ +# chpass + +> Gebruikersdatabase informatie toevoegen of wijzigen, inclusief login shell en wachtwoord. +> Bekijk ook: `passwd`. +> Meer informatie: . + +- Voeg toe of pas interactief de gebruikersdatabase informatie aan voor de huidige gebruiker: + +`su -c chpass` + +- Stel een specifieke login [s]hell in voor de huidige gebruiker: + +`chpass -s {{pad/naar/shell}}` + +- Stel een login [s]hell in voor een specifieke gebruiker: + +`chpass -s {{pad/naar/shell}} {{gebruikersnaam}}` + +- Pas de account v[e]rloop tijd aan (in seconden vanaf de epoch, UTC): + +`su -c 'chpass -e {{tijd}} {{gebruikersnaam}}'` + +- Pas een gebruikerswachtwoord aan:: + +`su -c 'chpass -p {{gecodeerd_wachtwoord}} {{gebruikersnaam}}'` + +- Specificeer een [h]ostnaam of adres van een NIS server: + +`su -c 'chpass -h {{hostnaam}} {{gebruikersnaam}}'` + +- Specificeer een specifiek [d]omein (standaard systeem domein naam): + +`su -c 'chpass -d {{domein}} {{gebruikersnaam}}'` diff --git a/pages.nl/freebsd/look.md b/pages.nl/freebsd/look.md new file mode 100644 index 000000000..5fa59cbcf --- /dev/null +++ b/pages.nl/freebsd/look.md @@ -0,0 +1,21 @@ +# look + +> Toon regels die beginnen met een prefix in een gesorteerd bestand. +> Bekijk ook: `grep`, `sort`. +> Meer informatie: . + +- Zoek naar regels die beginnen met een specifieke prefix in een specifiek bestand: + +`look {{prefix}} {{pad/naar/bestand}}` + +- Zoek hoofdletterongevoelig alleen op alfanumerieke tekens: + +`look {{-f|--ignore-case}} {{-d|--alphanum}} {{prefix}} {{pad/naar/bestand}}` + +- Specificeer een string-terminatiekarakter (standaard is spatie): + +`look {{-t|--terminate}} {{,}}` + +- Zoek in `/usr/share/dict/words` (`--ignore-case` en `--alphanum` worden aangenomen): + +`look {{prefix}}` diff --git a/pages.nl/freebsd/sockstat.md b/pages.nl/freebsd/sockstat.md new file mode 100644 index 000000000..58ca156d8 --- /dev/null +++ b/pages.nl/freebsd/sockstat.md @@ -0,0 +1,36 @@ +# sockstat + +> Toon open Internet- of UNIX-domeinsockets. +> Meer informatie: . + +- Bekijk welke gebruikers/processen [l]uisteren op welke poorten: + +`sockstat -l` + +- Toon informatie voor IPv[4]/IPv[6] sockets die [l]uisteren op specifieke [p]oorten met een specifiek [P]rotocol: + +`sockstat -{{4|6}} -l -P {{tcp|udp|sctp|divert}} -p {{poort1,poort2...}}` + +- Toon ook verbonden ([c]) sockets zonder [n]umerieke UID's om te zetten naar gebruikersnamen en met een [w]ijder veldformaat: + +`sockstat -cnw` + +- Toon alleen sockets die behoren tot een specifieke [j]ail ID of naam in [v]erbose modus: + +`sockstat -jv` + +- Toon de protocol[s]tatus en het externe [U]DP-encapsulatiepoortnummer, indien van toepassing (deze zijn momenteel alleen geïmplementeerd voor SCTP en TCP): + +`sockstat -sU` + +- Toon het [C]ongestiecontrolemodule en de protocol[S]tack, indien van toepassing (deze zijn momenteel alleen geïmplementeerd voor TCP): + +`sockstat -CS` + +- Toon alleen internetsockets als de lokale en buitenlandse adressen niet in het loopback-netwerkprefix 127.0.0.0/8 zitten, of niet het IPv6-loopbackadres ::1 bevatten: + +`sockstat -L` + +- Toon de koptekst niet ([q]uiet modus), toon [u]nix-sockets en geef de `inp_gencnt` weer: + +`sockstat -qui` diff --git a/pages.nl/linux/bspc.md b/pages.nl/linux/bspc.md index e32cf4d48..623cc3f7e 100644 --- a/pages.nl/linux/bspc.md +++ b/pages.nl/linux/bspc.md @@ -9,16 +9,20 @@ - Focus op het gegeven bureaublad: -`bspc desktop --focus {{number}}` +`bspc desktop --focus {{nummer}}` -- Sluit de vensters die afgetakt zijn van het geselecteerde knooppunt: +- Sluit de vensters die afgetakt zijn van de geselecteerde node: `bspc node --close` -- Stuur het geselecteerde knooppunt naar het opgegeven bureaublad: +- Stuur de geselecteerde node naar het opgegeven bureaublad: -`bspc node --to-desktop {{number}}` +`bspc node --to-desktop {{nummer}}` -- Schakel de modus volledig scherm in voor het geselecteerde knooppunt: +- Schakel de modus volledig scherm in voor de geselecteerde node: `bspc node --state ~fullscreen` + +- Zet de waarde van een specifieke instelling: + +`bspc config {{instelling}} {{waarde}}` diff --git a/pages.nl/linux/bspwm.md b/pages.nl/linux/bspwm.md index d48ccb0f5..b96f92583 100644 --- a/pages.nl/linux/bspwm.md +++ b/pages.nl/linux/bspwm.md @@ -1,12 +1,9 @@ # bspwm > Een tegelvensterbeheerder gebaseerd op binaire ruimtepartitionering. +> Bekijk ook: `bspc`, voor het aansturen. > Meer informatie: . - Start `bspwm` (houd er rekening mee dat een reeds bestaande vensterbeheerder niet geopend mag zijn wanneer dit commando wordt uitgevoerd): `bspwm -c {{pad/naar/config}}` - -- Bekijk de documentatie van `bspc`: - -`tldr bspc` diff --git a/pages.nl/linux/cgcreate.md b/pages.nl/linux/cgcreate.md index 76776a190..61da7fd1f 100644 --- a/pages.nl/linux/cgcreate.md +++ b/pages.nl/linux/cgcreate.md @@ -6,12 +6,12 @@ - Maak een nieuwe groep: -`cgcreate -g {{group_type}}:{{group_name}}` +`cgcreate -g {{groep_type}}:{{groepsnaam}}` - Maak een nieuwe groep met meerdere cgroep typen: -`cgcreate -g {{group_type1}},{{group_type2}}:{{group_name}}` +`cgcreate -g {{groep_type1}},{{groep_type2}}:{{groepsnaam}}` - Maak een subgroep: -`mkdir /sys/fs/cgroup/{{group_type}}/{{group_name}}/{{subgroup_name}}` +`mkdir /sys/fs/cgroup/{{groep_type}}/{{groepsnaam}}/{{subgroep_naam}}` diff --git a/pages.nl/linux/cp.md b/pages.nl/linux/cp.md index 0de7304a9..3eda35846 100644 --- a/pages.nl/linux/cp.md +++ b/pages.nl/linux/cp.md @@ -5,11 +5,11 @@ - Kopieer een bestand naar een andere locatie: -`cp {{pad/naar/bron_bestand.ext}} {{pad/naar/doel_bestand.ext}}` +`cp {{pad/naar/bronbestand.ext}} {{pad/naar/doel_bestand.ext}}` - Kopieer een bestand naar een andere map, maar behoud de bestandsnaam: -`cp {{pad/naar/bron_bestand.ext}} {{pad/naar/doel_map}}` +`cp {{pad/naar/bronbestand.ext}} {{pad/naar/doel_map}}` - Kopieer de inhoud van een map recursief naar een andere locatie (als de doelmap bestaat, dan wordt de map hierin gekopieerd): @@ -33,4 +33,4 @@ - Gebruik het volledige pad van de bron bestanden, creëer missende tussenliggende mappen tijdens het kopieëren: -`cp --parents {{pad/naar/bron_bestand}} {{pad/naar/doel_bestand}}` +`cp --parents {{pad/naar/bronbestand}} {{pad/naar/doel_bestand}}` diff --git a/pages.nl/linux/dd.md b/pages.nl/linux/dd.md new file mode 100644 index 000000000..4be608d6b --- /dev/null +++ b/pages.nl/linux/dd.md @@ -0,0 +1,28 @@ +# dd + +> Converteer en kopieer een bestand. +> Meer informatie: . + +- Maak een opstartbare USB-schijf van een isohybrid-bestand (zoals `archlinux-xxx.iso`) en toon de voortgang: + +`dd if={{pad/naar/bestand.iso}} of={{/dev/usb_schijf}} status=progress` + +- Kopieer een schijf naar een andere schijf met een blokgrootte van 4 MiB en schrijf alle gegevens voordat het commando eindigt: + +`dd bs=4M conv=fsync if={{/dev/bron_schijf}} of={{/dev/doel_schijf}}` + +- Genereer een bestand met een specifiek aantal willekeurige bytes met behulp van de kernel random driver: + +`dd bs={{100}} count={{1}} if=/dev/urandom of={{pad/naar/willekeurig_bestand}}` + +- Benchmark de sequentiële schrijfsnelheid van een schijf: + +`dd bs={{1M}} count={{1024}} if=/dev/zero of={{pad/naar/bestand_1GB}}` + +- Maak een systeemback-up, sla deze op in een IMG bestand (kan later worden hersteld door `if` en `of` om te wisselen) en toon de voortgang: + +`dd if={{/dev/schijf_apparaat}} of={{pad/naar/bestand.img}} status=progress` + +- Bekijk de voortgang van een lopende `dd` operatie (voer dit commando uit vanaf een andere shell): + +`kill -USR1 $(pgrep -x dd)` diff --git a/pages.nl/linux/dnsdomainname.md b/pages.nl/linux/dnsdomainname.md new file mode 100644 index 000000000..87a87ada7 --- /dev/null +++ b/pages.nl/linux/dnsdomainname.md @@ -0,0 +1,9 @@ +# dnsdomainname + +> Toon de DNS-domeinnaam van het systeem. +> Let op: de tool gebruikt `gethostname` om de hostnaam van het systeem op te halen en vervolgens `getaddrinfo` om deze om te zetten in een gecanoniseerde naam. +> Meer informatie: . + +- Toon de DNS-domeinnaam van het systeem: + +`dnsdomainname` diff --git a/pages.nl/linux/fold.md b/pages.nl/linux/fold.md new file mode 100644 index 000000000..36ddde297 --- /dev/null +++ b/pages.nl/linux/fold.md @@ -0,0 +1,16 @@ +# fold + +> Breek lange regels af voor uitvoerapparaten met vaste breedte. +> Meer informatie: . + +- Breek regels af met een vaste breedte: + +`fold --width {{breedte}} {{pad/naar/bestand}}` + +- Tel breedte in bytes (standaard is het tellen in kolommen): + +`fold --bytes --width {{breedte_in_bytes}} {{pad/naar/bestand}}` + +- Breek de regel na de meest rechtse spatie binnen de breedtelimiet: + +`fold --spaces --width {{breedte}} {{pad/naar/bestand}}` diff --git a/pages.nl/linux/groupadd.md b/pages.nl/linux/groupadd.md new file mode 100644 index 000000000..df3130e19 --- /dev/null +++ b/pages.nl/linux/groupadd.md @@ -0,0 +1,17 @@ +# groupadd + +> Voeg gebruikersgroepen toe aan het systeem. +> Bekijk ook: `groups`, `groupdel`, `groupmod`. +> Meer informatie: . + +- Maak een nieuwe groep aan: + +`sudo groupadd {{groepsnaam}}` + +- Maak een nieuwe systeemgroep aan: + +`sudo groupadd --system {{groepsnaam}}` + +- Maak een nieuwe groep aan met een specifieke groeps-ID: + +`sudo groupadd --gid {{id}} {{groepsnaam}}` diff --git a/pages.nl/linux/groupdel.md b/pages.nl/linux/groupdel.md new file mode 100644 index 000000000..0c41c8314 --- /dev/null +++ b/pages.nl/linux/groupdel.md @@ -0,0 +1,9 @@ +# groupdel + +> Verwijder bestaande gebruikersgroepen van het systeem. +> Bekijk ook: `groups`, `groupadd`, `groupmod`. +> Meer informatie: . + +- Verwijder een bestaande groep: + +`sudo groupdel {{groepsnaam}}` diff --git a/pages.nl/linux/groupmod.md b/pages.nl/linux/groupmod.md new file mode 100644 index 000000000..a0975037a --- /dev/null +++ b/pages.nl/linux/groupmod.md @@ -0,0 +1,13 @@ +# groupmod + +> Wijzig bestaande gebruikersgroepen in het systeem. +> Zie ook: `groups`, `groupadd`, `groupdel`. +> Meer informatie: . + +- Wijzig de groepsnaam: + +`sudo groupmod --new-name {{nieuwe_groep}} {{groepsnaam}}` + +- Wijzig het groeps-ID: + +`sudo groupmod --gid {{nieuwe_id}} {{groepsnaam}}` diff --git a/pages.nl/linux/ip-route-list.md b/pages.nl/linux/ip-route-list.md index b7fb6dc22..1d92977fb 100644 --- a/pages.nl/linux/ip-route-list.md +++ b/pages.nl/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> Dit commando is een alias van `ip-route-show`. +> Dit commando is een alias van `ip route show`. - Bekijk de documentatie van het originele commando: diff --git a/pages.nl/linux/iptables.md b/pages.nl/linux/iptables.md index 6810b45e1..1638779a8 100644 --- a/pages.nl/linux/iptables.md +++ b/pages.nl/linux/iptables.md @@ -18,12 +18,12 @@ - Voeg regel toe aan keten policy voor IP met [p]rotocol en poort in overweging: -`sudo iptables --append {{keten}} --source {{ip}} --protocol {{tcp|udp|icmp|...}} --dport {{port}} --jump {{regel}}` +`sudo iptables --append {{keten}} --source {{ip}} --protocol {{tcp|udp|icmp|...}} --dport {{poort}} --jump {{regel}}` - Voeg een NAT regel toe om al het verkeer van `192.168.0.0/24` subnet te vertalen naar de host's publieke IP: `sudo iptables --table {{nat}} --append {{POSTROUTING}} --source {{192.168.0.0/24}} --jump {{MASQUERADE}}` -- Verwijder keten regel: +- Verwij[D]er keten regel: -`sudo iptables --delete {{keten}} {{regel_line_number}}` +`sudo iptables --delete {{keten}} {{regelnummer}}` diff --git a/pages.nl/linux/kill.md b/pages.nl/linux/kill.md new file mode 100644 index 000000000..b91bbefb7 --- /dev/null +++ b/pages.nl/linux/kill.md @@ -0,0 +1,37 @@ +# kill + +> Stuurt een signaal naar een proces, meestal om het proces te stoppen. +> Alle signalen behalve SIGKILL en SIGSTOP kunnen door het proces worden onderschept om een nette afsluiting uit te voeren. +> Meer informatie: . + +- Beëindig een programma met behulp van het standaard SIGTERM (terminate) signaal: + +`kill {{proces_id}}` + +- Lijst signaalwaarden en hun overeenkomstige namen op (te gebruiken zonder het `SIG` voorvoegsel): + +`kill {{-L|--table}}` + +- Beëindig een achtergrondtaak: + +`kill %{{taak_id}}` + +- Beëindig een programma met behulp van het SIGHUP (hang up) signaal. Veel daemons zullen herladen in plaats van beëindigen: + +`kill -{{1|HUP}} {{proces_id}}` + +- Beëindig een programma met behulp van het SIGINT (interrupt) signaal. Dit wordt meestal geïnitieerd door de gebruiker die `Ctrl + C` indrukt: + +`kill -{{2|INT}} {{proces_id}}` + +- Signaleer het besturingssysteem om een programma onmiddellijk te beëindigen (het programma krijgt geen kans om het signaal te onderscheppen): + +`kill -{{9|KILL}} {{proces_id}}` + +- Signaleer het besturingssysteem om een programma te pauzeren totdat een SIGCONT ("continue") signaal wordt ontvangen: + +`kill -{{17|STOP}} {{proces_id}}` + +- Stuur een `SIGUSR1` signaal naar alle processen met de gegeven GID (groeps-ID): + +`kill -{{SIGUSR1}} -{{groep_id}}` diff --git a/pages.nl/linux/libtool.md b/pages.nl/linux/libtool.md new file mode 100644 index 000000000..f87fef1bb --- /dev/null +++ b/pages.nl/linux/libtool.md @@ -0,0 +1,32 @@ +# libtool + +> Een generiek script voor bibliotheekondersteuning dat de complexiteit van het gebruik van gedeelde bibliotheken verbergt achter een consistente, draagbare interface. +> Meer informatie: . + +- Compileer een bronbestand naar een `libtool`-object: + +`libtool --mode=compile gcc -c {{pad/naar/bron.c}} -o {{pad/naar/bron.lo}}` + +- Maak een bibliotheek of een uitvoerbaar bestand: + +`libtool --mode=link gcc -o {{pad/naar/bibliotheek.lo}} {{pad/naar/bron.lo}}` + +- Stel automatisch het bibliotheekpad in zodat een ander programma niet-geïnstalleerde door `libtool` gegenereerde programma's of bibliotheken kan gebruiken: + +`libtool --mode=execute gdb {{pad/naar/programma}}` + +- Installeer een gedeelde bibliotheek: + +`libtool --mode=install cp {{pad/naar/bibliotheek.la}} {{pad/naar/installatiemap}}` + +- Voltooi de installatie van `libtool`-bibliotheken op het systeem: + +`libtool --mode=finish {{pad/naar/installatiemap}}` + +- Verwijder geïnstalleerde bibliotheken of uitvoerbare bestanden: + +`libtool --mode=uninstall {{pad/naar/geïnstalleerde_bibliotheek.la}}` + +- Verwijder niet-geïnstalleerde bibliotheken of uitvoerbare bestanden: + +`libtool --mode=clean rm {{pad/naar/bron.lo}} {{pad/naar/bibliotheek.la}}` diff --git a/pages.nl/linux/libtoolize.md b/pages.nl/linux/libtoolize.md new file mode 100644 index 000000000..2058f5fd3 --- /dev/null +++ b/pages.nl/linux/libtoolize.md @@ -0,0 +1,9 @@ +# libtoolize + +> Een `autotools` tool om een pakket voor te bereiden voor het gebruik van `libtool`. +> Het voert verschillende taken uit, waaronder het genereren van de benodigde bestanden en directories om `libtool` naadloos in een project te integreren. +> Meer informatie: . + +- Initialiseer een project voor `libtool` door de benodigde bestanden te kopiëren (symbolische links vermijden) en bestaande bestanden indien nodig te overschrijven: + +`libtoolize --copy --force` diff --git a/pages.nl/linux/locate.md b/pages.nl/linux/locate.md new file mode 100644 index 000000000..df02359dc --- /dev/null +++ b/pages.nl/linux/locate.md @@ -0,0 +1,16 @@ +# locate + +> Vind snel bestandsnamen. +> Meer informatie: . + +- Zoek naar een patroon in de database. Opmerking: de database wordt periodiek herberekend (meestal wekelijks of dagelijks): + +`locate {{patroon}}` + +- Zoek naar een bestand op basis van de exacte bestandsnaam (een patroon zonder glob-tekens wordt geïnterpreteerd als `*patroon*`): + +`locate '*/{{bestandsnaam}}'` + +- Herbereken de database. Dit moet je doen als je recent toegevoegde bestanden wilt vinden: + +`sudo updatedb` diff --git a/pages.nl/linux/look.md b/pages.nl/linux/look.md new file mode 100644 index 000000000..fd4068122 --- /dev/null +++ b/pages.nl/linux/look.md @@ -0,0 +1,26 @@ +# look + +> Toon regels die beginnen met een prefix in een gesorteerd bestand. +> Let op: de regels in het bestand moeten gesorteerd zijn. +> Bekijk ook: `grep`, `sort`. +> Meer informatie: . + +- Zoek naar regels die beginnen met een specifieke prefix in een specifiek bestand: + +`look {{prefix}} {{pad/naar/bestand}}` + +- Zoek hoofdletterongevoeling alleen op lege en alfanumerieke tekens: + +`look {{-f|--ignore-case}} {{-d|--alphanum}} {{prefix}} {{pad/naar/bestand}}` + +- Specificeer een string-terminatiekarakter (standaard is spatie): + +`look {{-t|--terminate}} {{,}}` + +- Zoek in `/usr/share/dict/words` (`--ignore-case` en `--alphanum` worden aangenomen): + +`look {{prefix}}` + +- Zoek in `/usr/share/dict/web2` (`--ignore-case` en `--alphanum` worden aangenomen): + +`look {{-a|--alternative}} {{prefix}}` diff --git a/pages.nl/linux/mknod.md b/pages.nl/linux/mknod.md new file mode 100644 index 000000000..e97ae3f3e --- /dev/null +++ b/pages.nl/linux/mknod.md @@ -0,0 +1,20 @@ +# mknod + +> Maak speciale bestanden voor blok- of tekenapparaten aan. +> Meer informatie: . + +- Maak een blokapparaat aan: + +`sudo mknod {{pad/naar/apparaat_bestand}} b {{groot_apparaatnummer}} {{klein_apparaatnummer}}` + +- Maak een tekenapparaat aan: + +`sudo mknod {{pad/naar/apparaat_bestand}} c {{groot_apparaatnummer}} {{klein_apparaatnummer}}` + +- Maak een FIFO (queue) apparaat aan: + +`sudo mknod {{pad/naar/apparaat_bestand}} p` + +- Maak een apparaatbestand aan met de standaard SELinux-beveiligingscontext: + +`sudo mknod -Z {{pad/naar/apparaat_bestand}} {{type}} {{groot_apparaatnummer}} {{klein_apparaatnummer}}` diff --git a/pages.nl/linux/mktemp.md b/pages.nl/linux/mktemp.md new file mode 100644 index 000000000..17b29bc5d --- /dev/null +++ b/pages.nl/linux/mktemp.md @@ -0,0 +1,28 @@ +# mktemp + +> Maak een tijdelijk bestand of een tijdelijke map aan. +> Meer informatie: . + +- Maak een leeg tijdelijk bestand en toon het absolute pad: + +`mktemp` + +- Gebruik een aangepaste map (standaard is `$TMPDIR`, of `/tmp`): + +`mktemp --tmpdir={{/pad/naar/tempdir}}` + +- Gebruik een aangepast pad-sjabloon (`X`en worden vervangen door willekeurige alfanumerieke tekens): + +`mktemp {{/tmp/voorbeeld.XXXXXXXX}}` + +- Gebruik een aangepast bestandsnaam-sjabloon: + +`mktemp -t {{voorbeeld.XXXXXXXX}}` + +- Maak een leeg tijdelijk bestand met de opgegeven extensie en toon het absolute pad: + +`mktemp --suffix {{.ext}}` + +- Maak een lege tijdelijke map aan en toon het absolute pad: + +`mktemp --directory` diff --git a/pages.nl/linux/mount.cifs.md b/pages.nl/linux/mount.cifs.md index 327931c33..863f88d21 100644 --- a/pages.nl/linux/mount.cifs.md +++ b/pages.nl/linux/mount.cifs.md @@ -1,7 +1,7 @@ # mount.cifs > Mount SMB (Server Message Block) of CIFS (Common Internet File System) shares. -> Opmerking: u kunt ook hetzelfde doen door de optie `-t cifs` door te geven aan `mount`. +> Let op: u kunt ook hetzelfde doen door de optie `-t cifs` door te geven aan `mount`. > Meer informatie: . - Verbinding maken met de opgegeven gebruikersnaam of `$USER` als standaard (U wordt gevraagd om een wachtwoord): diff --git a/pages.nl/linux/nl.md b/pages.nl/linux/nl.md new file mode 100644 index 000000000..dd90a91d3 --- /dev/null +++ b/pages.nl/linux/nl.md @@ -0,0 +1,36 @@ +# nl + +> Voorzie regels van een nummer uit een bestand of van `stdin`. +> Meer informatie: . + +- Voorzie niet-lege regels in een bestand van een nummer: + +`nl {{pad/naar/bestand}}` + +- Lees van `stdin`: + +`{{commando}} | nl -` + +- Nummer [a]lle [b]ody regels inclusief lege regels of [n]ummer geen [b]ody regels: + +`nl --body-numbering {{a|n}} {{pad/naar/bestand}}` + +- Nummer alleen de [b]ody regels die overeenkomen met een basis reguliere expressie (BRE) [p]atroon: + +`nl --body-numbering p'FooBar[0-9]' {{pad/naar/bestand}}` + +- Gebruik een specifieke [i]ncrement voor regelnummering: + +`nl --line-increment {{increment}} {{pad/naar/bestand}}` + +- Specificeer het nummeringsformaat voor regels: [r]echts of [l]inks uitgelijnd, met of zonder voorloopnullen ([z]eros): + +`nl --number-format {{rz|ln|rn}}` + +- Specificeer de breedte van de nummering (standaard is 6): + +`nl --number-width {{kolombreedte}} {{pad/naar/bestand}}` + +- Gebruik een specifieke string om de regelnummers van de regels te scheiden (standaard is TAB): + +`nl --number-separator {{scheidingsteken}} {{pad/naar/bestand}}` diff --git a/pages.nl/linux/ptx.md b/pages.nl/linux/ptx.md new file mode 100644 index 000000000..d7a3cc068 --- /dev/null +++ b/pages.nl/linux/ptx.md @@ -0,0 +1,24 @@ +# ptx + +> Genereer een permutatie-index van woorden uit tekstbestanden. +> Meer informatie: . + +- Genereer een permutatie-index waarbij het eerste veld van elke regel een indexreferentie is: + +`ptx --references {{pad/naar/bestand}}` + +- Genereer een permutatie-index met automatisch gegenereerde indexreferenties: + +`ptx --auto-reference {{pad/naar/bestand}}` + +- Genereer een permutatie-index met een vaste breedte: + +`ptx --width={{breedte_in_kolommen}} {{pad/naar/bestand}}` + +- Genereer een permutatie-index met een lijst van gefilterde woorden: + +`ptx --only-file={{pad/naar/filter}} {{pad/naar/bestand}}` + +- Genereer een permutatie-index met SYSV-stijl gedragingen: + +`ptx --traditional {{pad/naar/bestand}}` diff --git a/pages.nl/linux/rcp.md b/pages.nl/linux/rcp.md new file mode 100644 index 000000000..7add50500 --- /dev/null +++ b/pages.nl/linux/rcp.md @@ -0,0 +1,21 @@ +# rcp + +> Kopieer bestanden tussen lokale en externe systemen. +> Het imiteert het gedrag van het `cp`-commando, maar werkt tussen verschillende machines. +> Meer informatie: . + +- Kopieer een bestand naar een externe host: + +`rcp {{pad/naar/local_file}} {{gebruikersnaam}}@{{remote_host}}:{{/pad/naar/bestemming/}}` + +- Kopieer een directory recursief: + +`rcp -r {{pad/naar/local_directory}} {{gebruikersnaam}}@{{remote_host}}:{{/pad/naar/bestemming/}}` + +- Behoud de bestandseigenschappen: + +`rcp -p {{pad/naar/local_file}} {{gebruikersnaam}}@{{remote_host}}:{{/pad/naar/bestemming/}}` + +- Forceer kopiëren zonder bevestiging: + +`rcp -f {{pad/naar/local_file}} {{gebruikersnaam}}@{{remote_host}}:{{/pad/naar/bestemming/}}` diff --git a/pages.nl/linux/rexec.md b/pages.nl/linux/rexec.md new file mode 100644 index 000000000..e53082c21 --- /dev/null +++ b/pages.nl/linux/rexec.md @@ -0,0 +1,21 @@ +# rexec + +> Voer een commando uit op een externe host. +> Let op: Gebruik `rexec` met voorzichtigheid, omdat het gegevens in platte tekst verzendt. Overweeg veilige alternatieven zoals SSH voor versleutelde communicatie. +> Meer informatie: . + +- Voer een commando uit op een externe [h]ost: + +`rexec -h={{remote_host}} {{ls -l}}` + +- Specificeer de externe [g]ebruikersnaam op een externe [h]ost: + +`rexec -username={{gebruikersnaam}} -h={{remote_host}} {{ps aux}}` + +- Redirect `stdin` van `/dev/null` op een externe [h]ost: + +`rexec --no-err -h={{remote_host}} {{ls -l}}` + +- Specificeer de externe [P]oort op een externe [h]ost: + +`rexec -P={{1234}} -h={{remote_host}} {{ls -l}}` diff --git a/pages.nl/linux/rlogin.md b/pages.nl/linux/rlogin.md new file mode 100644 index 000000000..2f54a0c03 --- /dev/null +++ b/pages.nl/linux/rlogin.md @@ -0,0 +1,12 @@ +# rlogin + +> Log in op een externe host. +> Meer informatie: . + +- Log in op een externe host: + +`rlogin {{remote_host}}` + +- Log in op een externe host met een specifieke gebruikersnaam: + +`rlogin -l {{gebruikersnaam}} {{remote_host}}` diff --git a/pages.nl/linux/rsh.md b/pages.nl/linux/rsh.md new file mode 100644 index 000000000..32a9b43fe --- /dev/null +++ b/pages.nl/linux/rsh.md @@ -0,0 +1,16 @@ +# rsh + +> Voer commando's uit op een externe host. +> Meer informatie: . + +- Voer een commando uit op een externe host: + +`rsh {{remote_host}} {{ls -l}}` + +- Voer een commando uit op een externe host met een specifieke gebruikersnaam: + +`rsh {{remote_host}} -l {{gebruikersnaam}} {{ls -l}}` + +- Redirect `stdin` naar `/dev/null` bij het uitvoeren van een commando op een externe host: + +`rsh {{remote_host}} --no-err {{ls -l}}` diff --git a/pages.nl/linux/runcon.md b/pages.nl/linux/runcon.md new file mode 100644 index 000000000..eac10219e --- /dev/null +++ b/pages.nl/linux/runcon.md @@ -0,0 +1,21 @@ +# runcon + +> Voer een programma uit in een andere SELinux-beveiligingscontext. +> Bekijk ook: `secon`. +> Meer informatie: . + +- Toon de beveiligingscontext van de huidige uitvoeringscontext: + +`runcon` + +- Specificeer het domein om een commando in uit te voeren: + +`runcon -t {{domein}}_t {{commando}}` + +- Specificeer de context rol om een commando mee uit te voeren: + +`runcon -r {{rol}}_r {{commando}}` + +- Specificeer de volledige context om een commando mee uit te voeren: + +`runcon {{gebruiker}}_u:{{rol}}_r:{{domein}}_t {{commando}}` diff --git a/pages.nl/linux/secon.md b/pages.nl/linux/secon.md new file mode 100644 index 000000000..505ced177 --- /dev/null +++ b/pages.nl/linux/secon.md @@ -0,0 +1,25 @@ +# secon + +> Krijg de SELinux-beveiligingscontext van een bestand, PID, huidige uitvoeringscontext of een contextspecificatie. +> Zie ook: `semanage`, `runcon`, `chcon`. +> Meer informatie: . + +- Krijg de beveiligingscontext van de huidige uitvoeringscontext: + +`secon` + +- Krijg de huidige beveiligingscontext van een proces: + +`secon --pid {{1}}` + +- Krijg de huidige beveiligingscontext van een bestand, waarbij alle tussenliggende symlinks worden opgelost: + +`secon --file {{pad/naar/bestand_of_map}}` + +- Krijg de huidige beveiligingscontext van een symlink zelf (d.w.z. niet oplossen): + +`secon --link {{pad/naar/symlink}}` + +- Parse en leg een contextspecificatie uit: + +`secon {{systeem_u:systeem_r:container_t:s0:c899,c900}}` diff --git a/pages.nl/linux/semanage-boolean.md b/pages.nl/linux/semanage-boolean.md new file mode 100644 index 000000000..db93d984c --- /dev/null +++ b/pages.nl/linux/semanage-boolean.md @@ -0,0 +1,17 @@ +# semanage boolean + +> Beheer persistente SELinux-boolean-instellingen. +> Zie ook: `semanage` voor het beheren van SELinux-beleid, `getsebool` voor het controleren van boolean-waarden, en `setsebool` voor het toepassen van niet-blijvende boolean-instellingen. +> Meer informatie: . + +- Toon alle boolean-instellingen: + +`sudo semanage boolean {{-l|--list}}` + +- Toon alle door de gebruiker gedefinieerde boolean-instellingen zonder koppen: + +`sudo semanage boolean {{-l|--list}} {{-C|--locallist}} {{-n|--noheading}}` + +- Stel een boolean blijvend in of uit: + +`sudo semanage boolean {{-m|--modify}} {{-1|--on|-0|--off}} {{haproxy_connect_any}}` diff --git a/pages.nl/linux/semanage-fcontext.md b/pages.nl/linux/semanage-fcontext.md new file mode 100644 index 000000000..5c058c6d3 --- /dev/null +++ b/pages.nl/linux/semanage-fcontext.md @@ -0,0 +1,25 @@ +# semanage fcontext + +> Beheer persistente SELinux-beveiligingscontextregels op bestanden/mappen. +> Zie ook: `semanage`, `matchpathcon`, `secon`, `chcon`, `restorecon`. +> Meer informatie: . + +- Toon alle bestandslabelregels: + +`sudo semanage fcontext --list` + +- Toon alle door de gebruiker gedefinieerde bestandslabelregels zonder koppen: + +`sudo semanage fcontext --list --locallist --noheading` + +- Voeg een door de gebruiker gedefinieerde regel toe die elk pad labelt dat overeenkomt met een PCRE-regex: + +`sudo semanage fcontext --add --type {{samba_share_t}} {{'/mnt/share(/.*)?'}}` + +- Verwijder een door de gebruiker gedefinieerde regel met behulp van zijn PCRE-regex: + +`sudo semanage fcontext --delete {{'/mnt/share(/.*)?'}}` + +- Herlabel een map recursief door de nieuwe regels toe te passen: + +`restorecon -R -v {{pad/naar/map}}` diff --git a/pages.nl/linux/semanage-permissive.md b/pages.nl/linux/semanage-permissive.md new file mode 100644 index 000000000..84fa9ea5b --- /dev/null +++ b/pages.nl/linux/semanage-permissive.md @@ -0,0 +1,14 @@ +# semanage permissive + +> Beheer persistente SELinux permissieve domeinen. +> Let op dat dit het proces effectief onbeperkt maakt. Voor langdurig gebruik wordt aanbevolen om SELinux correct te configureren. +> Zie ook: `semanage`, `getenforce`, `setenforce`. +> Meer informatie: . + +- Toon alle procestypen (ook wel domeinen genoemd) die in permissieve modus zijn: + +`sudo semanage permissive {{-l|--list}}` + +- Stel de permissieve modus in of uit voor een domein: + +`sudo semanage permissive {{-a|--add|-d|--delete}} {{httpd_t}}` diff --git a/pages.nl/linux/semanage-port.md b/pages.nl/linux/semanage-port.md new file mode 100644 index 000000000..baa6c22a1 --- /dev/null +++ b/pages.nl/linux/semanage-port.md @@ -0,0 +1,21 @@ +# semanage port + +> Beheer persistente SELinux-poortdefinities. +> Zie ook: `semanage`. +> Meer informatie: . + +- Toon alle poortlabelregels: + +`sudo semanage port {{-l|--list}}` + +- Toon alle door de gebruiker gedefinieerde poortlabelregels zonder koppen: + +`sudo semanage port {{-l|--list}} {{-C|--locallist}} {{-n|--noheading}}` + +- Voeg een door de gebruiker gedefinieerde regel toe die een label toekent aan een protocol-poortpaar: + +`sudo semanage port {{-a|--add}} {{-t|--type}} {{ssh_port_t}} {{-p|--proto}} {{tcp}} {{22000}}` + +- Verwijder een door de gebruiker gedefinieerde regel met behulp van zijn protocol-poortpaar: + +`sudo semanage port {{-d|--delete}} {{-p|--proto}} {{udp}} {{11940}}` diff --git a/pages.nl/linux/semanage.md b/pages.nl/linux/semanage.md new file mode 100644 index 000000000..b07a6721f --- /dev/null +++ b/pages.nl/linux/semanage.md @@ -0,0 +1,29 @@ +# semanage + +> SELinux persistent beleid beheertool. +> Sommige subcommando's zoals `boolean`, `fcontext`, `port`, etc. hebben hun eigen gebruiksdocumentatie. +> Meer informatie: . + +- Stel een SELinux-boolean in of uit. Booleans stellen de beheerder in staat om aan te passen hoe beleidsregels invloed hebben op ingesloten procestypes (ook wel domeinen genoemd): + +`sudo semanage boolean {{-m|--modify}} {{-1|--on|-0|--off}} {{haproxy_connect_any}}` + +- Voeg een door de gebruiker gedefinieerde bestandscontextlabelregel toe. Bestandscontexten definiëren welke bestanden ingesloten domeinen mogen openen: + +`sudo semanage fcontext {{-a|--add}} {{-t|--type}} {{samba_share_t}} '/mnt/share(/.*)?'` + +- Voeg een door de gebruiker gedefinieerde poortlabelregel toe. Poortlabels definiëren op welke poorten ingesloten domeinen mogen luisteren: + +`sudo semanage port {{-a|--add}} {{-t|--type}} {{ssh_port_t}} {{-p|--proto}} {{tcp}} {{22000}}` + +- Stel de permissieve modus in of uit voor een ingesloten domein. Per-domein permissieve modus biedt meer gedetailleerde controle vergeleken met `setenforce`: + +`sudo semanage permissive {{-a|--add|-d|--delete}} {{httpd_t}}` + +- Exporteer lokale aanpassingen in de standaardopslag: + +`sudo semanage export {{-f|--output_file}} {{pad/naar/bestand}}` + +- Importeer een bestand gegenereerd door `semanage export` in lokale aanpassingen (VOORZICHTIG: kan huidige aanpassingen verwijderen!): + +`sudo semanage import {{-f|--input_file}} {{pad/naar/bestand}}` diff --git a/pages.nl/linux/shntool-split.md b/pages.nl/linux/shntool-split.md index 7c08d3ede..6c66d86ed 100644 --- a/pages.nl/linux/shntool-split.md +++ b/pages.nl/linux/shntool-split.md @@ -1,4 +1,4 @@ -# shntool-split +# shntool split > Dit commando is een alias van `shnsplit`. diff --git a/pages.nl/linux/sleep.md b/pages.nl/linux/sleep.md new file mode 100644 index 000000000..90f387ac2 --- /dev/null +++ b/pages.nl/linux/sleep.md @@ -0,0 +1,20 @@ +# sleep + +> Wacht voor een gespecificeerde hoeveelheid tijd. +> Meer informatie: . + +- Wacht in seconden: + +`sleep {{seconden}}` + +- Wacht in [m]inuten. (Andere eenheden zoals [d]ag, [u]ur, [s]econde, [inf]initeit kunnen ook worden gebruikt): + +`sleep {{minuten}}m` + +- Wacht 1 [d]ag en 3 uur ([h]): + +`sleep 1d 3h` + +- Voer een specifiek commando uit na een wachttijd van 20 [m]inuten: + +`sleep 20m && {{commando}}` diff --git a/pages.nl/linux/sockstat.md b/pages.nl/linux/sockstat.md new file mode 100644 index 000000000..2e6d9cdd1 --- /dev/null +++ b/pages.nl/linux/sockstat.md @@ -0,0 +1,29 @@ +# sockstat + +> Toon open Internet- of UNIX-domeinsockets. +> Bekijk ook: `netstat`. +> Meer informatie: . + +- Toon informatie voor IPv4- en IPv6-sockets voor zowel luister- als verbonden sockets: + +`sockstat` + +- Toon informatie voor IPv[4]/IPv[6] sockets die [l]uisteren op specifieke [p]oorten met een specifiek p[R]otocol: + +`sockstat -{{4|6}} -l -R {{tcp|udp|sctp|divert}} -p {{poort1,poort2...}}` + +- Toon ook [c]onnected sockets en [u]nix-sockets: + +`sockstat -cu` + +- Toon alleen sockets van het opgegeven `pid` of proces: + +`sockstat -P {{pid|proces}}` + +- Toon alleen sockets van de opgegeven `uid` of gebruiker: + +`sockstat -U {{uid|gebruiker}}` + +- Toon alleen sockets van de opgegeven `gid` of groep: + +`sockstat -G {{gid|groep}}` diff --git a/pages.nl/linux/tac.md b/pages.nl/linux/tac.md new file mode 100644 index 000000000..abc246e18 --- /dev/null +++ b/pages.nl/linux/tac.md @@ -0,0 +1,25 @@ +# tac + +> Toon en voeg bestanden samen met regels in omgekeerde volgorde. +> Bekijk ook: `cat`. +> Meer informatie: . + +- Voeg specifieke bestanden samen in omgekeerde volgorde: + +`tac {{pad/naar/bestand1 pad/naar/bestand2 ...}}` + +- Toon `stdin` in omgekeerde volgorde: + +`{{cat pad/naar/bestand}} | tac` + +- Gebruik een specifiek scheidingsteken: + +`tac --separator {{,}} {{pad/naar/bestand1 pad/naar/bestand2 ...}}` + +- Gebruik een specifieke regex als scheidingsteken: + +`tac --regex --separator {{[,;]}} {{pad/naar/bestand1 pad/naar/bestand2 ...}}` + +- Gebruik een scheidingsteken vóór elk bestand: + +`tac --before {{pad/naar/bestand1 pad/naar/bestand2 ...}}` diff --git a/pages.nl/linux/talk.md b/pages.nl/linux/talk.md new file mode 100644 index 000000000..24337e17c --- /dev/null +++ b/pages.nl/linux/talk.md @@ -0,0 +1,24 @@ +# talk + +> Een visueel communicatieprogramma dat regels van jouw terminal kopieert naar die van een andere gebruiker. +> Meer informatie: . + +- Start een talk-sessie met een gebruiker op dezelfde machine: + +`talk {{gebruikersnaam}}` + +- Start een talk-sessie met een gebruiker op dezelfde machine, die is ingelogd op tty3: + +`talk {{gebruikersnaam}} {{tty3}}` + +- Start een talk-sessie met een gebruiker op een externe machine: + +`talk {{gebruikersnaam}}@{{hostname}}` + +- Wis tekst op beide terminals: + +`+D` + +- Verlaat de talk-sessie: + +`+C` diff --git a/pages.nl/linux/tftp.md b/pages.nl/linux/tftp.md new file mode 100644 index 000000000..88d016e97 --- /dev/null +++ b/pages.nl/linux/tftp.md @@ -0,0 +1,32 @@ +# tftp + +> Trivial File Transfer Protocol client. +> Meer informatie: . + +- Maak verbinding met een TFTP-server door het IP-adres en de poort op te geven: + +`tftp {{server_ip}} {{poort}}` + +- Maak verbinding met een TFTP-server en voer een TFTP-[c]ommand uit: + +`tftp {{server_ip}} -c {{command}}` + +- Maak verbinding met een TFTP-server met IPv6 en forceer dat de oorspronkelijke poort binnen een [R]ange ligt: + +`tftp {{server_ip}} -6 -R {{poort}}:{{poort}}` + +- Stel de overdrachtsmodus in op binaire of ASCIi via de tftp-client: + +`mode {{binary|ascii}}` + +- Download een bestand van een server via de tftp-client: + +`get {{file}}` + +- Upload een bestand naar een server via de tftp-client: + +`put {{file}}` + +- Verlaat de tftp-client: + +`quit` diff --git a/pages.nl/linux/uname.md b/pages.nl/linux/uname.md new file mode 100644 index 000000000..c097e8f18 --- /dev/null +++ b/pages.nl/linux/uname.md @@ -0,0 +1,36 @@ +# uname + +> Uname toont informatie over de machine en het besturingssysteem waarop het wordt uitgevoerd. +> Meer informatie: . + +- Toon alle informatie: + +`uname --all` + +- Toon de huidige kernelnaam: + +`uname --kernel-name` + +- Toon de huidige netwerkhostnaam: + +`uname --nodename` + +- Toon de huidige kernelrelease: + +`uname --kernel-release` + +- Toon de huidige kernelversie: + +`uname --kernel-version` + +- Toon de huidige hardwarenaam van de machine: + +`uname --machine` + +- Toon het huidige processortype: + +`uname --processor` + +- Toon de huidige naam van het besturingssysteem: + +`uname --operating-system` diff --git a/pages.nl/linux/unmount.md b/pages.nl/linux/unmount.md index 27b7fff41..b9d873bdf 100644 --- a/pages.nl/linux/unmount.md +++ b/pages.nl/linux/unmount.md @@ -1,4 +1,4 @@ -# unmount +# umount > Het correcte commando is `umount` (u-mount). > Meer informatie: . diff --git a/pages.nl/linux/updatedb.md b/pages.nl/linux/updatedb.md new file mode 100644 index 000000000..ac8d9bc7e --- /dev/null +++ b/pages.nl/linux/updatedb.md @@ -0,0 +1,13 @@ +# updatedb + +> Maak of werk de database bij die gebruikt wordt door `locate`. +> Dit wordt meestal dagelijks uitgevoerd door cron. +> Meer informatie: . + +- Ververs de inhoud van de database: + +`sudo updatedb` + +- Toon bestandsnamen zodra ze gevonden zijn: + +`sudo updatedb --verbose` diff --git a/pages.nl/netbsd/cal.md b/pages.nl/netbsd/cal.md new file mode 100644 index 000000000..73655efac --- /dev/null +++ b/pages.nl/netbsd/cal.md @@ -0,0 +1,36 @@ +# cal + +> Toon een kalender. +> Meer informatie: . + +- Toon een kalender voor de huidige maand: + +`cal` + +- Toon een kalender voor een specifiek jaar: + +`cal {{jaar}}` + +- Toon een kalender voor een specifieke maand en jaar: + +`cal {{maand}} {{jaar}}` + +- Toon de volledige kalender voor het huidige jaar door gebruik te maken van [j]ulian dagen (beginnend vanaf één, genummerd vanaf 1 januari): + +`cal -y -j` + +- Markeer ([h]) vandaag en toon [3] maanden rondom de datum:: + +`cal -h -3 {{maand}} {{jaar}}` + +- Toon de 2 maanden voor ([B]) en 3 maanden na ([A]) een specifieke [m]aand van het huidige jaar: + +`cal -A 3 -B 2 {{maand}}` + +- Toon een specifiek aantal maanden voor en na (Context) de opgegeven maand: + +`cal -C {{maanden}} {{maand}}` + +- Specificeer de startdag van de week (0: Zondag, 1: Maandag, ..., 6: Zaterdag): + +`cal -d {{0..6}}` diff --git a/pages.nl/netbsd/chpass.md b/pages.nl/netbsd/chpass.md new file mode 100644 index 000000000..b451bde6f --- /dev/null +++ b/pages.nl/netbsd/chpass.md @@ -0,0 +1,29 @@ +# chpass + +> Gebruikersdatabase informatie toevoegen of wijzigen, inclusief login shell en wachtwoord. +> Bekijk ook: `passwd`. +> Meer informatie: . + +- Stel interactief een specifieke login shell in voor de huidige gebruiker: + +`su -c chpass` + +- Stel een specifieke login [s]hell in voor de huidige gebruiker: + +`chpass -s {{pad/naar/shell}}` + +- Stel een login [s]hell in voor een specifieke gebruiker: + +`chpass chsh -s {{pad/naar/shell}} {{gebruikersnaam}}` + +- Specificeer een gebruikersdatabase entry in het `passwd` bestandsformaat: + +`su -c 'chpass -a {{gebruikersnaam:gecodeerd_wachtwoord:uid:gid:...}} -s {{pad/naar/bestand}}' {{gebruikersnaam}}` + +- Pas alleen het lokale wachtwoord bestand aan: + +`su -c 'chpass -l -s {{pad/naar/shell}}' {{gebruikersnaam}}` + +- Pas geforceerd een database [y]P wachtwoord database entry aan: + +`su -c 'chpass -y -s {{pad/naar/shell}}' {{gebruikersnaam}}` diff --git a/pages.nl/netbsd/sockstat.md b/pages.nl/netbsd/sockstat.md new file mode 100644 index 000000000..b05f2ae6c --- /dev/null +++ b/pages.nl/netbsd/sockstat.md @@ -0,0 +1,26 @@ +# sockstat + +> Toon open Internet- of UNIX-domeinsockets. +> Let op: dit programma is hergeschreven voor NetBSD 3.0 van FreeBSD's `sockstat`. +> Bekijk ook: `netstat`. +> Meer informatie: . + +- Toon informatie voor IPv4- en IPv6-sockets voor zowel luister- als verbonden sockets: + +`sockstat` + +- Toon informatie voor IPv[4]/IPv[6] sockets die [l]uisteren op specifieke [p]oorten met een specifiek [P]rotocol: + +`sockstat -{{4|6}} -l -P {{tcp|udp|sctp|divert}} -p {{port1,port2...}}` + +- Toon ook [c]onnected sockets en [u]nix-sockets: + +`sockstat -cu` + +- Toon alleen [n]umerieke output, zonder symbolische namen voor adressen en poorten te resolven: + +`sockstat -n` + +- Toon alleen sockets van de opgegeven adres[f]amilie: + +`sockstat -f {{inet|inet6|local|unix}}` diff --git a/pages.nl/openbsd/cal.md b/pages.nl/openbsd/cal.md new file mode 100644 index 000000000..dcece264e --- /dev/null +++ b/pages.nl/openbsd/cal.md @@ -0,0 +1,32 @@ +# cal + +> Toon een kalender met de huidige dag gemarkeerd. +> Meer informatie: . + +- Toon een kalender voor de huidige maand: + +`cal` + +- Toon een kalender voor een specifiek jaar: + +`cal {{jaar}}` + +- Toon een kalender voor een specifieke maand en jaar: + +`cal {{maand}} {{jaar}}` + +- Toon de volledige kalender voor het huidige jaar ([y]): + +`cal -y` + +- Toon [j]ulian dagen (beginnend vanaf één, genummerd vanaf 1 januari): + +`cal -j` + +- Gebruik [m]aandag als week start in plaats van zondag: + +`cal -m` + +- Toon [w]eeknummers (niet compatibel met `-j`): + +`cal -w` diff --git a/pages.nl/openbsd/chpass.md b/pages.nl/openbsd/chpass.md new file mode 100644 index 000000000..0ea5ee963 --- /dev/null +++ b/pages.nl/openbsd/chpass.md @@ -0,0 +1,21 @@ +# chpass + +> Gebruikersdatabase informatie toevoegen of wijzigen, inclusief login shell en wachtwoord. +> Bekijk ook: `passwd`. +> Meer informatie: . + +- Stel interactief een specifieke login shell in voor de huidige gebruiker: + +`doas chsh` + +- Stel een specifieke login [s]hell in voor de huidige gebruiker: + +`doas chsh -s {{pad/naar/shell}}` + +- Stel een login [s]hell in voor een specifieke gebruiker: + +`doas chsh -s {{pad/naar/shell}} {{gebruikersnaam}}` + +- Specificeer een gebruikersdatabase entry in het `passwd` bestandsformaat: + +`doas chsh -a {{gebruikersnaam:gecodeerd_wachtwoord:uid:gid:...}}` diff --git a/pages.nl/osx/cal.md b/pages.nl/osx/cal.md new file mode 100644 index 000000000..70440844a --- /dev/null +++ b/pages.nl/osx/cal.md @@ -0,0 +1,32 @@ +# cal + +> Toon kalender informatie. +> Meer informatie: . + +- Toon een kalender voor de huidige maand: + +`cal` + +- Toon vorige, huidige en volgende maand: + +`cal -3` + +- Toon een kalender voor een specifieke maand (1-12 of de naam): + +`cal -m {{maand}}` + +- Toon een kalender voor het huidige jaar: + +`cal -y` + +- Toon een kalender voor een specifiek jaar (4 cijfers): + +`cal {{jaar}}` + +- Toon een kalender voor een specifieke maand en jaar: + +`cal {{maand}} {{jaar}}` + +- Toon de datum van Pasen (Westerse Christelijke kerken) in een gegeven jaar: + +`ncal -e {{jaar}}` diff --git a/pages.nl/osx/chpass.md b/pages.nl/osx/chpass.md new file mode 100644 index 000000000..590e29457 --- /dev/null +++ b/pages.nl/osx/chpass.md @@ -0,0 +1,26 @@ +# chpass + +> Gebruikersdatabase informatie toevoegen of wijzigen, inclusief login shell en wachtwoord. +> Let op: het is niet mogelijk om een gebruikerswachtwoord te wijzigen op een Open Directory systeem, gebruik hiervoor `passwd`. +> Bekijk ook: `passwd`. +> Meer informatie: . + +- Voeg toe of pas interactief de gebruikersdatabase informatie aan voor de huidige gebruiker: + +`su -c chpass` + +- Stel een specifieke login [s]hell in voor de huidige gebruiker: + +`chpass -s {{pad/naar/shell}}` + +- Stel een login [s]hell in voor een specifieke gebruiker: + +`chpass -s {{pad/naar/shell}} {{gebruikersnaam}}` + +- Pas het gebruikersrecord aan in de directory node op de opgegeven [l]ocatie: + +`chpass -l {{locatie}} -s {{pad/naar/shell}} {{gebruikersnaam}}` + +- Gebruik de opgegeven gebr[u]ikersnaam bij het authenticeren van het mapknooppunt dat de gebruiker bevat: + +`chpass -u {{auth_naam}} -s {{pad/naar/shell}} {{gebruikersnaam}}` diff --git a/pages.nl/osx/date.md b/pages.nl/osx/date.md new file mode 100644 index 000000000..12e9c9cf0 --- /dev/null +++ b/pages.nl/osx/date.md @@ -0,0 +1,20 @@ +# date + +> Stel de systeemdatum in of toon deze. +> Meer informatie: . + +- Toon de huidige datum in het standaardformaat van de locale: + +`date +%c` + +- Toon de huidige datum in UTC en ISO 8601-formaat: + +`date -u +%Y-%m-%dT%H:%M:%SZ` + +- Toon de huidige datum als een Unix timestamp (seconden sinds de Unix-epoch): + +`date +%s` + +- Toon een specifieke datum (gerepresenteerd als een Unix timestamp) met het standaard formaat: + +`date -r {{1473305798}}` diff --git a/pages.nl/osx/dd.md b/pages.nl/osx/dd.md new file mode 100644 index 000000000..6df62b2aa --- /dev/null +++ b/pages.nl/osx/dd.md @@ -0,0 +1,28 @@ +# dd + +> Converteer en kopieer een bestand. +> Meer informatie: . + +- Maak een opstartbare USB-schijf van een isohybrid-bestand (zoals `archlinux-xxx.iso`) en toon de voortgang: + +`dd if={{pad/naar/bestand.iso}} of={{/dev/usb_apparaat}} status=progress` + +- Kopieer een schijf naar een andere schijf met een blokgrootte van 4 MiB, negeer fouten en toon de voortgang: + +`dd bs=4m conv=noerror if={{/dev/bron_apparaat}} of={{/dev/doel_apparaat}} status=progress` + +- Genereer een bestand met een specifiek aantal willekeurige bytes met behulp van de kernel random driver: + +`dd bs={{100}} count={{1}} if=/dev/urandom of={{pad/naar/random_bestand}}` + +- Benchmark de schrijfsnelheid van een schijf: + +`dd bs={{1024}} count={{1000000}} if=/dev/zero of={{pad/naar/bestand_1GB}}` + +- Maak een systeemback-up, sla deze op in een IMG bestand (kan later worden hersteld door `if` en `of` om te wisselen) en toon de voortgang: + +`dd if={{/dev/schijf_apparaat}} of={{pad/naar/bestand.img}} status=progress` + +- Bekijk de voortgang van een lopende `dd` operatie (voer dit commando uit vanaf een andere shell):: + +`kill -USR1 $(pgrep ^dd)` diff --git a/pages.nl/osx/ed.md b/pages.nl/osx/ed.md new file mode 100644 index 000000000..409fe2ea4 --- /dev/null +++ b/pages.nl/osx/ed.md @@ -0,0 +1,25 @@ +# ed + +> De originele Unix tekst editor. +> Bekijk ook: `awk`, `sed`. +> Meer informatie: . + +- Start een interactieve editor sessie met een leeg document: + +`ed` + +- Start een interactieve editor sessie met een leeg document en een specifieke [p]rompt: + +`ed -p '> '` + +- Start een interactieve editor sessie met een leeg document en zonder diagnostics, het aantal bytes en de '!' prompt: + +`ed -s` + +- Pas een specifiek bestand aan (dit toont het aantal bytes van het geladen bestand): + +`ed {{pad/naar/bestand}}` + +- Vervang een string met een specifieke vervanging voor alle regels: + +`,s/{{reguliere_expressie}}/{{vervanging}}/g` diff --git a/pages.nl/osx/indent.md b/pages.nl/osx/indent.md new file mode 100644 index 000000000..b59ff16f1 --- /dev/null +++ b/pages.nl/osx/indent.md @@ -0,0 +1,12 @@ +# indent + +> Wijzig het uiterlijk van een C/C++-programma door spaties in te voegen of te verwijderen. +> Meer informatie: . + +- Formatteer C/C++-broncode volgens de Berkeley-stijl: + +`indent {{pad/naar/bronbestand.c}} {{pad/naar/ingesprongen_bestand.c}} -nbad -nbap -bc -br -c33 -cd33 -cdb -ce -ci4 -cli0 -di16 -fc1 -fcb -i4 -ip -l75 -lp -npcs -nprs -psl -sc -nsob -ts8` + +- Formatteer C/C++-broncode volgens de stijl van Kernighan & Ritchie (K&R): + +`indent {{pad/naar/bronbestand.c}} {{pad/naar/ingesprongen_bestand.c}} -nbad -bap -nbc -br -c33 -cd33 -ncdb -ce -ci4 -cli0 -cs -d0 -di1 -nfc1 -nfcb -i4 -nip -l75 -lp -npcs -nprs -npsl -nsc -nsob` diff --git a/pages.nl/osx/launchctl.md b/pages.nl/osx/launchctl.md index 7d6da9ca4..49e1eab2b 100644 --- a/pages.nl/osx/launchctl.md +++ b/pages.nl/osx/launchctl.md @@ -20,11 +20,11 @@ `launchctl list` -- Een momenteel geladen agent ontladen, b.v. om wijzigingen aan te brengen (let op: het plist-bestand wordt automatisch in `launchd` geladen na een herstart en/of inloggen): +- Een momenteel geladen agent ontladen, b.v. om wijzigingen aan te brengen (Let op: het plist-bestand wordt automatisch in `launchd` geladen na een herstart en/of inloggen): `launchctl unload ~/Library/LaunchAgents/{{my_script}}.plist` -- Voer handmatig een bekende (geladen) agent/daemon uit, zelfs als dit niet het juiste moment is (opmerking: deze opdracht gebruikt het label van de agent, in plaats van de bestandsnaam): +- Voer handmatig een bekende (geladen) agent/daemon uit, zelfs als dit niet het juiste moment is (Let op: deze opdracht gebruikt het label van de agent, in plaats van de bestandsnaam): `launchctl start {{script_bestand}}` diff --git a/pages.nl/osx/locate.md b/pages.nl/osx/locate.md new file mode 100644 index 000000000..9905ca14b --- /dev/null +++ b/pages.nl/osx/locate.md @@ -0,0 +1,16 @@ +# locate + +> Vind snel bestandsnamen. +> Meer informatie: . + +- Zoek naar een patroon in de database. Opmerking: de database wordt periodiek herberekend (meestal wekelijks of dagelijks): + +`locate "{{patroon}}"` + +- Zoek naar een bestand op basis van de exacte bestandsnaam (een patroon zonder glob-tekens wordt geïnterpreteerd als `*patroon*`): + +`locate */{{bestandsnaam}}` + +- Herbereken de database. Dit moet je doen als je recent toegevoegde bestanden wilt vinden: + +`sudo /usr/libexec/locate.updatedb` diff --git a/pages.nl/osx/look.md b/pages.nl/osx/look.md new file mode 100644 index 000000000..b18744fb6 --- /dev/null +++ b/pages.nl/osx/look.md @@ -0,0 +1,21 @@ +# look + +> Toon regels die beginnen met een prefix in een gesorteerd bestand. +> Bekijk ook: `grep`, `sort`. +> Meer informatie: . + +- Zoek naar regels die beginnen met een specifieke prefix in een specifiek bestand: + +`look {{prefix}} {{pad/naar/bestand}}` + +- Zoek hoofdletterongevoelig alleen op alfanumerieke tekens: + +`look {{-f|--ignore-case}} {{-d|--alphanum}} {{prefix}} {{pad/naar/bestand}}` + +- Specificeer een string-terminatiekarakter (standaard is spatie): + +`look {{-t|--terminate}} {{,}}` + +- Zoek in `/usr/share/dict/words` (`--ignore-case` en `--alphanum` worden aangenomen): + +`look {{prefix}}` diff --git a/pages.nl/osx/mktemp.md b/pages.nl/osx/mktemp.md new file mode 100644 index 000000000..d6f4a6bb0 --- /dev/null +++ b/pages.nl/osx/mktemp.md @@ -0,0 +1,24 @@ +# mktemp + +> Maak een tijdelijk bestand of een tijdelijke map aan. +> Meer informatie: . + +- Maak een leeg tijdelijk bestand en toon het absolute pad: + +`mktemp` + +- Gebruik een aangepaste map (standaard is de uitvoer van `getconf DARWIN_USER_TEMP_DIR`, of `/tmp`): + +`mktemp --tmpdir={{/pad/naar/tempdir}}` + +- Gebruik een aangepast pad-sjabloon (`X`en worden vervangen door willekeurige alfanumerieke tekens): + +`mktemp {{/tmp/voorbeeld.XXXXXXXX}}` + +- Gebruik een aangepaste bestandsnaam-prefix: + +`mktemp -t {{voorbeeld}}` + +- Maak een lege tijdelijke map aan en toon het absolute pad: + +`mktemp --directory` diff --git a/pages.nl/osx/ping.md b/pages.nl/osx/ping.md new file mode 100644 index 000000000..35749d887 --- /dev/null +++ b/pages.nl/osx/ping.md @@ -0,0 +1,28 @@ +# ping + +> Verstuur ICMP ECHO_REQUEST-pakketten naar netwerkhosts. +> Meer informatie: . + +- Ping een specifieke host: + +`ping "{{hostnaam}}"` + +- Ping een host een specifiek aantal keren: + +`ping -c {{aantal}} "{{host}}"` + +- Ping een host, met een specifiek interval in seconden tussen de verzoeken (standaard is 1 seconde): + +`ping -i {{seconden}} "{{host}}"` + +- Ping een host zonder te proberen symbolische namen voor adressen op te zoeken: + +`ping -n "{{host}}"` + +- Ping een host en laat een bel afgaan wanneer een pakket wordt ontvangen (als je terminal dit ondersteunt): + +`ping -a "{{host}}"` + +- Ping een host en toon de tijd wanneer een pakket is ontvangen (deze optie is een Apple-toevoeging): + +`ping --apple-time "{{host}}"` diff --git a/pages.nl/osx/port.md b/pages.nl/osx/port.md new file mode 100644 index 000000000..eb8bd72ad --- /dev/null +++ b/pages.nl/osx/port.md @@ -0,0 +1,28 @@ +# port + +> Pakketbeheerder voor macOS. +> Meer informatie: . + +- Zoek naar een pakket: + +`port search {{zoekterm}}` + +- Installeer een pakket: + +`sudo port install {{pakket}}` + +- Lijst geïnstalleerde pakketten: + +`port installed` + +- Update port en haal de nieuwste lijst met beschikbare pakketten op: + +`sudo port selfupdate` + +- Upgrade verouderde pakketten: + +`sudo port upgrade outdated` + +- Verwijder oude versies van geïnstalleerde pakketten: + +`sudo port uninstall inactive` diff --git a/pages.nl/osx/readlink.md b/pages.nl/osx/readlink.md new file mode 100644 index 000000000..d570d785a --- /dev/null +++ b/pages.nl/osx/readlink.md @@ -0,0 +1,8 @@ +# readlink + +> Volg symlinks en verkrijg symlink-informatie. +> Meer informatie: . + +- Toon het absolute pad waarnaar de symlink verwijst: + +`readlink {{pad/naar/symlink_bestand}}` diff --git a/pages.nl/osx/sed.md b/pages.nl/osx/sed.md index b27b944c2..ab858d4e7 100644 --- a/pages.nl/osx/sed.md +++ b/pages.nl/osx/sed.md @@ -10,7 +10,7 @@ - Voer een specifiek script bestand uit en toon het resultaat in `stdout`: -`{{commando}} | sed -f {{path/to/script_file.sed}}` +`{{commando}} | sed -f {{pad/naar/script_bestand.sed}}` - Vervang alle `apple` (uitgebreide regex) met `APPLE` (uitgebreide regex) in alle invoerregels en toon het resultaat in `stdout`: diff --git a/pages.nl/osx/shuf.md b/pages.nl/osx/shuf.md new file mode 100644 index 000000000..383672450 --- /dev/null +++ b/pages.nl/osx/shuf.md @@ -0,0 +1,20 @@ +# shuf + +> Genereer willekeurige permutaties. +> Meer informatie: . + +- Wijzig willekeurig de volgorde van regels in een bestand en toon het resultaat: + +`shuf {{pad/naar/bestand}}` + +- Toon alleen de eerste 5 regels van het resultaat: + +`shuf --head-count=5 {{pad/naar/bestand}}` + +- Schrijf de uitvoer naar een ander bestand: + +`shuf {{pad/naar/invoer_bestand}} --output={{pad/naar/uitvoer_bestand}}` + +- Genereer willekeurige getallen in het bereik van 1 tot 10: + +`shuf --input-range=1-10` diff --git a/pages.nl/osx/split.md b/pages.nl/osx/split.md new file mode 100644 index 000000000..c1522c05a --- /dev/null +++ b/pages.nl/osx/split.md @@ -0,0 +1,20 @@ +# split + +> Split een bestand in stukken. +> Meer informatie: . + +- Split een bestand, elk deel heeft 10 regels (behalve het laatste deel): + +`split -l 10 {{pad/naar/bestand}}` + +- Split een bestand op een reguliere expressie. De overeenkomende regel zal de eerste regel van het volgende uitvoerbestand zijn: + +`split -p {{cat|^[dh]og}} {{pad/naar/bestand}}` + +- Split een bestand met 512 bytes in elk deel (behalve het laatste deel; gebruik 512k voor kilobytes en 512m voor megabytes): + +`split -b 512 {{pad/naar/bestand}}` + +- Split een bestand in 5 bestanden. Het bestand wordt zo gesplitst dat elk deel dezelfde grootte heeft (behalve het laatste deel): + +`split -n 5 {{pad/naar/bestand}}` diff --git a/pages.nl/osx/stat.md b/pages.nl/osx/stat.md new file mode 100644 index 000000000..50e2bed4f --- /dev/null +++ b/pages.nl/osx/stat.md @@ -0,0 +1,24 @@ +# stat + +> Toon bestandsstatus. +> Meer informatie: . + +- Toon bestandseigenschappen zoals grootte, permissies, aanmaak- en toegangsdatums en meer: + +`stat {{pad/naar/bestand}}` + +- Zelfde als hierboven maar uitgebreid (meer vergelijkbaar met Linux's `stat`): + +`stat -x {{pad/naar/bestand}}` + +- Toon alleen octale bestandspermissies: + +`stat -f %Mp%Lp {{pad/naar/bestand}}` + +- Toon eigenaar en groep van het bestand: + +`stat -f "%Su %Sg" {{pad/naar/bestand}}` + +- Toon de grootte van het bestand in bytes: + +`stat -f "%z %N" {{pad/naar/bestand}}` diff --git a/pages.nl/osx/uname.md b/pages.nl/osx/uname.md new file mode 100644 index 000000000..e53a28198 --- /dev/null +++ b/pages.nl/osx/uname.md @@ -0,0 +1,25 @@ +# uname + +> Toon details over de huidige machine en het besturingssysteem dat erop draait. +> Opmerking: voor aanvullende informatie over het besturingssysteem, probeer het `sw_vers` commando. +> Meer informatie: . + +- Toon de naam van de kernel: + +`uname` + +- Toon systeemarchitectuur en processorinformatie: + +`uname -mp` + +- Toon de naam, release en versie van de kernel: + +`uname -srv` + +- Toon de systeemhostname: + +`uname -n` + +- Toon alle beschikbare systeeminformatie: + +`uname -a` diff --git a/pages.nl/osx/uptime.md b/pages.nl/osx/uptime.md new file mode 100644 index 000000000..9a4fe4d73 --- /dev/null +++ b/pages.nl/osx/uptime.md @@ -0,0 +1,8 @@ +# uptime + +> Toon hoe lang het systeem actief is en andere informatie. +> Meer informatie: . + +- Toon de huidige tijd, uptime, aantal ingelogde gebruikers en andere informatie: + +`uptime` diff --git a/pages.nl/osx/wc.md b/pages.nl/osx/wc.md new file mode 100644 index 000000000..155238b28 --- /dev/null +++ b/pages.nl/osx/wc.md @@ -0,0 +1,24 @@ +# wc + +> Tel regels, woorden of bytes. +> Meer informatie: . + +- Tel regels in een bestand: + +`wc -l {{pad/naar/bestand}}` + +- Tel woorden in een bestand: + +`wc -w {{pad/naar/bestand}}` + +- Tel tekens (bytes) in een bestand: + +`wc -c {{pad/naar/bestand}}` + +- Tel tekens in een bestand (rekening houdend met multi-byte tekensets): + +`wc -m {{pad/naar/bestand}}` + +- Gebruik `stdin` om regels, woorden en tekens (bytes) in die volgorde te tellen: + +`{{find .}} | wc` diff --git a/pages.nl/osx/yaa.md b/pages.nl/osx/yaa.md new file mode 100644 index 000000000..706778e6b --- /dev/null +++ b/pages.nl/osx/yaa.md @@ -0,0 +1,28 @@ +# yaa + +> Maak en beheer YAA-archieven. +> Meer informatie: . + +- Maak een archief van een map: + +`yaa archive -d {{pad/naar/map}} -o {{pad/naar/uitvoer_bestand.yaa}}` + +- Maak een archief van een bestand: + +`yaa archive -i {{pad/naar/bestand}} -o {{pad/naar/uitvoer_bestand.yaa}}` + +- Pak een archief uit naar de huidige map: + +`yaa extract -i {{pad/naar/archive_file.yaa}}` + +- Lijst de inhoud van een archief op: + +`yaa list -i {{pad/naar/archive_file.yaa}}` + +- Maak een archief met een specifiek compressie-algoritme: + +`yaa archive -a {{algoritme}} -d {{pad/naar/map}} -o {{pad/naar/uitvoer_bestand.yaa}}` + +- Maak een archief met een blokgrootte van 8 MB: + +`yaa archive -b 8m -d {{pad/naar/map}} -o {{pad/naar/uitvoer_bestand.yaa}}` diff --git a/pages.nl/sunos/prstat.md b/pages.nl/sunos/prstat.md index bb7c4c253..d5e726b12 100644 --- a/pages.nl/sunos/prstat.md +++ b/pages.nl/sunos/prstat.md @@ -19,6 +19,6 @@ `prstat -m` -- Print de 5 meest CPU intensieve processen elke seconde: +- Toon de 5 meest CPU intensieve processen elke seconde: -`prstat -c -n {{5}} -s cpu {{1}}` +`prstat -c -n 5 -s cpu 1` diff --git a/pages.nl/windows/choco-list.md b/pages.nl/windows/choco-list.md index ec8bb0687..7db29e1e9 100644 --- a/pages.nl/windows/choco-list.md +++ b/pages.nl/windows/choco-list.md @@ -21,8 +21,8 @@ - Geef een aangepaste bron op om pakketten van weer te geven: -`choco list --source {{source_url|alias}}` +`choco list --source {{bron_url|alias}}` - Geef een gebruikersnaam en wachtwoord voor authenticatie op: -`choco list --user {{username}} --password {{password}}` +`choco list --user {{gebruikersnaam}} --password {{wachtwoord}}` diff --git a/pages.nl/windows/date.md b/pages.nl/windows/date.md new file mode 100644 index 000000000..735c978eb --- /dev/null +++ b/pages.nl/windows/date.md @@ -0,0 +1,16 @@ +# date + +> Toon of stel de systeemdatum in. +> Meer informatie: . + +- Toon de huidige systeemdatum en vraag voor een nieuwe datum (laat leeg om niet te veranderen): + +`date` + +- Toon de huidige systeemdatum zonder te vragen voor een nieuwe datum: + +`date /t` + +- Verander de huidige systeemdatum naar een specifieke datum: + +`date {{maand}}-{{dag}}-{{jaar}}` diff --git a/pages.nl/windows/expand.md b/pages.nl/windows/expand.md new file mode 100644 index 000000000..45f79b6fc --- /dev/null +++ b/pages.nl/windows/expand.md @@ -0,0 +1,24 @@ +# expand + +> Pak Windows Cabinet bestanden uit. +> Meer informatie: . + +- Pak een Cabinet bestand met één bestand naar de specifieke map: + +`expand {{pad\naar\bestand.cab}} {{pad\naar\map}}` + +- Toon een lijst van bestanden in een Cabinet bestand: + +`expand {{pad\naar\bestand.cab}} {{pad\naar\map}} -d` + +- Pak alle bestanden van een Cabinet bestand uit: + +`expand {{pad\naar\bestand.cab}} {{pad\naar\map}} -f:*` + +- Pak een specifiek bestand van een Cabinet bestand uit: + +`expand {{pad\naar\bestand.cab}} {{pad\naar\map}} -f:{{pad\naar\bestand}}` + +- Negeer de mapstructuur bij het uitpakken en voeg ze toe aan een enkele map: + +`expand {{pad\naar\bestand.cab}} {{pad\naar\map}} -i` diff --git a/pages.nl/windows/ftp.md b/pages.nl/windows/ftp.md new file mode 100644 index 000000000..f538fd4ea --- /dev/null +++ b/pages.nl/windows/ftp.md @@ -0,0 +1,36 @@ +# ftp + +> Interactief bestanden overzetten tussen een lokale en een externe FTP-server. +> Meer informatie: . + +- Verbind interactief met een externe FTP-server: + +`ftp {{host}}` + +- Log in als een anonieme gebruiker: + +`ftp -A {{host}}` + +- Schakel automatisch inloggen uit bij de eerste verbinding: + +`ftp -n {{host}}` + +- Voer een bestand uit met een lijst van FTP-opdrachten: + +`ftp -s:{{pad\naar\bestand}} {{host}}` + +- Download meerdere bestanden (glob-expressie): + +`mget {{*.png}}` + +- Upload meerdere bestanden (glob-expressie): + +`mput {{*.zip}}` + +- Verwijder meerdere bestanden op de externe server: + +`mdelete {{*.txt}}` + +- Toon hulp: + +`ftp --help` diff --git a/pages.nl/windows/mkdir.md b/pages.nl/windows/mkdir.md new file mode 100644 index 000000000..965cdcd44 --- /dev/null +++ b/pages.nl/windows/mkdir.md @@ -0,0 +1,12 @@ +# mkdir + +> Maak een map aan. +> Meer informatie: . + +- Maak een map aan: + +`mkdir {{pad\naar\map}}` + +- Maak een geneste mappenstructuur recursief aan: + +`mkdir {{pad\naar\sub_map}}` diff --git a/pages.nl/windows/new-item.md b/pages.nl/windows/new-item.md index 607074386..3d820e82e 100644 --- a/pages.nl/windows/new-item.md +++ b/pages.nl/windows/new-item.md @@ -1,6 +1,6 @@ # New-Item -> Maak een nieuw bestand, directory, symbolische link of een registerinvoer. +> Maak een nieuw bestand, map, symbolische link of een registerinvoer. > Dit commando kan alleen worden uitgevoerd onder PowerShell. > Meer informatie: . diff --git a/pages.nl/windows/reg.md b/pages.nl/windows/reg.md new file mode 100644 index 000000000..e749deaf7 --- /dev/null +++ b/pages.nl/windows/reg.md @@ -0,0 +1,37 @@ +# reg + +> Beheer sleutels en de waardes in een Windows registry. +> Sommige subcommando's zoals `reg add` hebben hun eigen documentatie. +> Meer informatie: . + +- Voer een registry commando uit: + +`reg {{commando}}` + +- Bekijk de documentatie voor het toevoegen en kopiëren van subsleutels: + +`tldr reg {{add|copy}}` + +- Bekijk de documentatie voor het verwijderen van sleutels en subsleutels: + +`tldr reg {{delete|unload}}` + +- Bekijk de documentatie voor het zoeken, bekijken en vergelijken van sleutels: + +`tldr reg {{compare|flags|query}}` + +- Bekijk de documentatie voor het exporteren en importeren van registry sleutels zonder de eigenaar en ACLs te bewaren: + +`tldr reg {{export|import}}` + +- Bekijk de documentatie voor het opslaan, herstellen en het lossen van sleutels met behoud van de eigenaar en ACLs: + +`tldr reg {{save|restore|load|unload}}` + +- Toon de help: + +`reg /?` + +- Toon de help voor een specifiek commando: + +`reg {{commando}} /?` diff --git a/pages.nl/windows/sc-config.md b/pages.nl/windows/sc-config.md index a36dbbc0e..d0c56d053 100644 --- a/pages.nl/windows/sc-config.md +++ b/pages.nl/windows/sc-config.md @@ -1,4 +1,4 @@ -# sc-config +# sc config > Dit commando is een alias van `sc.exe config`. > Meer informatie: . diff --git a/pages.nl/windows/sc-create.md b/pages.nl/windows/sc-create.md index 0277193c8..76df6ece4 100644 --- a/pages.nl/windows/sc-create.md +++ b/pages.nl/windows/sc-create.md @@ -1,4 +1,4 @@ -# sc-create +# sc create > Dit commando is een alias van `sc.exe create`. > Meer informatie: . diff --git a/pages.nl/windows/sc-delete.md b/pages.nl/windows/sc-delete.md index 357cc2375..46eec565f 100644 --- a/pages.nl/windows/sc-delete.md +++ b/pages.nl/windows/sc-delete.md @@ -1,4 +1,4 @@ -# sc-delete +# sc delete > Dit commando is een alias van `sc.exe delete`. > Meer informatie: . diff --git a/pages.nl/windows/sc-query.md b/pages.nl/windows/sc-query.md index 7a9db29f1..09bad5b15 100644 --- a/pages.nl/windows/sc-query.md +++ b/pages.nl/windows/sc-query.md @@ -1,4 +1,4 @@ -# sc-query +# sc query > Dit commando is een alias van `sc.exe query`. > Meer informatie: . diff --git a/pages.nl/windows/whoami.md b/pages.nl/windows/whoami.md new file mode 100644 index 000000000..135ed382c --- /dev/null +++ b/pages.nl/windows/whoami.md @@ -0,0 +1,28 @@ +# whoami + +> Toon details over de huidige gebruiker. +> Meer informatie: . + +- Toon de gebruikersnaam van de huidige gebruiker: + +`whoami` + +- Toon de groepen waarvan de huidige gebruiker lid is: + +`whoami /groups` + +- Toon de privileges van de huidige gebruiker: + +`whoami /priv` + +- Toon de user principal name (UPN) van de huidige gebruiker: + +`whoami /upn` + +- Toon de logon ID van de huidige gebruiker: + +`whoami /logonid` + +- Toon alle informatie voor de huidige gebruiker: + +`whoami /all` diff --git a/pages.no/common/ack.md b/pages.no/common/ack.md index a62573dea..1f7b54497 100644 --- a/pages.no/common/ack.md +++ b/pages.no/common/ack.md @@ -18,11 +18,11 @@ - Begrens søket til filer av en bestemt type: -`ack --type={{ruby}} "{{søkemønster}}"` +`ack --type {{ruby}} "{{søkemønster}}"` - Ikke søk i filer av en bestemt type: -`ack --type=no{{ruby}} "{{søkemønster}}"` +`ack --type no{{ruby}} "{{søkemønster}}"` - Tell totalt antall treff funnet: diff --git a/pages.no/common/cat.md b/pages.no/common/cat.md index 98f463db4..79eab2575 100644 --- a/pages.no/common/cat.md +++ b/pages.no/common/cat.md @@ -1,7 +1,7 @@ # cat > Skriv ut og sammenføy filer. -> Mer informasjon: . +> Mer informasjon: . - Skriv ut innholdet i en fil til standard utgang: diff --git a/pages.no/common/clamav.md b/pages.no/common/clamav.md index e3723947b..d0a193b6f 100644 --- a/pages.no/common/clamav.md +++ b/pages.no/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > Denne kommandoen er et alias for `clamdscan`. > Mer informasjon: . diff --git a/pages.no/common/fossil-ci.md b/pages.no/common/fossil-ci.md index ab5de66cd..07b5e76e3 100644 --- a/pages.no/common/fossil-ci.md +++ b/pages.no/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> Denne kommandoen er et alias for `fossil-commit`. +> Denne kommandoen er et alias for `fossil commit`. > Mer informasjon: . - Vis dokumentasjonen for den opprinnelige kommandoen: diff --git a/pages.no/common/fossil-delete.md b/pages.no/common/fossil-delete.md index 6a4da1245..1db480545 100644 --- a/pages.no/common/fossil-delete.md +++ b/pages.no/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > Denne kommandoen er et alias for `fossil rm`. > Mer informasjon: . diff --git a/pages.no/common/fossil-forget.md b/pages.no/common/fossil-forget.md index 4f94bd836..47f98f3ba 100644 --- a/pages.no/common/fossil-forget.md +++ b/pages.no/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > Denne kommandoen er et alias for `fossil rm`. > Mer informasjon: . diff --git a/pages.no/common/fossil-new.md b/pages.no/common/fossil-new.md index 495e437f9..92f7d35f4 100644 --- a/pages.no/common/fossil-new.md +++ b/pages.no/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> Denne kommandoen er et alias for `fossil-init`. +> Denne kommandoen er et alias for `fossil init`. > Mer informasjon: . - Vis dokumentasjonen for den opprinnelige kommandoen: diff --git a/pages.no/common/gh-cs.md b/pages.no/common/gh-cs.md index e5fd2a620..e66bd737c 100644 --- a/pages.no/common/gh-cs.md +++ b/pages.no/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> Denne kommandoen er et alias for `gh-codespace`. +> Denne kommandoen er et alias for `gh codespace`. > Mer informasjon: . - Vis dokumentasjonen for den opprinnelige kommandoen: diff --git a/pages.no/common/gnmic-sub.md b/pages.no/common/gnmic-sub.md index 6794a414d..4404edcee 100644 --- a/pages.no/common/gnmic-sub.md +++ b/pages.no/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > Denne kommandoen er et alias for `gnmic subscribe`. > Mer informasjon: . diff --git a/pages.no/common/pio-init.md b/pages.no/common/pio-init.md index 843222fc7..fce9dc73b 100644 --- a/pages.no/common/pio-init.md +++ b/pages.no/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > Denne kommandoen er et alias for `pio project`. diff --git a/pages.no/common/tlmgr-arch.md b/pages.no/common/tlmgr-arch.md index 57309d96d..d8ed3104b 100644 --- a/pages.no/common/tlmgr-arch.md +++ b/pages.no/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > Denne kommandoen er et alias for `tlmgr platform`. > Mer informasjon: . diff --git a/pages.no/linux/ip-route-list.md b/pages.no/linux/ip-route-list.md index 3a7b5ccd5..94c52865b 100644 --- a/pages.no/linux/ip-route-list.md +++ b/pages.no/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> Denne kommandoen er et alias for `ip-route-show`. +> Denne kommandoen er et alias for `ip route show`. - Vis dokumentasjonen for den opprinnelige kommandoen: diff --git a/pages.pl/android/bugreportz.md b/pages.pl/android/bugreportz.md index 9d0d1265c..9502e8e5d 100644 --- a/pages.pl/android/bugreportz.md +++ b/pages.pl/android/bugreportz.md @@ -12,10 +12,10 @@ `bugreportz -p` -- Wyświetl wersję `bugreportz`: - -`bugreportz -v` - - Wyświetl pomoc: `bugreportz -h` + +- Wyświetl wersję: + +`bugreportz -v` diff --git a/pages.pl/android/logcat.md b/pages.pl/android/logcat.md index a6e629df2..ed98ff706 100644 --- a/pages.pl/android/logcat.md +++ b/pages.pl/android/logcat.md @@ -1,6 +1,6 @@ # logcat -> Zrzut dziennika komunikatów systemowych. +> Zrzut dziennika komunikatów systemowych, w tym śladów stosu po wystąpieniu błędu i komunikatów informacyjnych rejestrowanych przez aplikacje. > Więcej informacji: . - Wyświetl logi systemowe: @@ -14,3 +14,11 @@ - Wyświetl linie pasujące do wyrażenia regularnego: `logcat --regex {{wyrażenie_regularne}}` + +- Wyświetl logi dla określonego PID: + +`logcat --pid {{pid}}` + +- Wyświetl logi dla procesu określonego pakietu: + +`logcat --pid $(pidof -s {{pakiet}})` diff --git a/pages.pl/android/screencap.md b/pages.pl/android/screencap.md new file mode 100644 index 000000000..99a73c50c --- /dev/null +++ b/pages.pl/android/screencap.md @@ -0,0 +1,9 @@ +# screencap + +> Zrób zrzut ekranu wyświetlacza urządzenia przenośnego. +> To polecenie może być używane tylko przez `adb shell`. +> Więcej informacji: . + +- Zrób zrzut ekranu: + +`screencap {{ścieżka/do/pliku}}` diff --git a/pages.pl/android/wm.md b/pages.pl/android/wm.md index 077bd4f4a..518a76f47 100644 --- a/pages.pl/android/wm.md +++ b/pages.pl/android/wm.md @@ -6,8 +6,8 @@ - Wyświetl fizyczny rozmiaru ekranu urządzenia Android: -`wm {{rozmiar}}` +`wm size` - Wyświetl fizyczną gęstość ekranu urządzenia Android: -`wm {{gęstość}}` +`wm density` diff --git a/pages.pl/common/!.md b/pages.pl/common/!.md new file mode 100644 index 000000000..106e36752 --- /dev/null +++ b/pages.pl/common/!.md @@ -0,0 +1,28 @@ +# Exclamation mark + +> Polecenie wbudowane w Bash do zastępowania komendą znalezioną w historii. +> Więcej informacji: . + +- Zastąp poprzednią komendą i uruchom ją z `sudo`: + +`sudo !!` + +- Zastąp komendą na podstawie jej numeru linii znalezionego za pomocą `history`: + +`!{{liczba}}` + +- Zastąp poleceniem, które zostało użyte określoną liczbę wierszy wstecz: + +`!-{{liczba}}` + +- Zastąp ostatnim poleceniem zaczynającym się od ciągu znaków: + +`!{{ciąg_znaków}}` + +- Zastąp argumentami ostatniego polecenia: + +`{{polecenie}} !*` + +- Zastąp ostatnim argumentem ostatniego polecenia: + +`{{polecenie}} !$` diff --git a/pages.pl/common/7z.md b/pages.pl/common/7z.md index 2725f0560..0cab6a307 100644 --- a/pages.pl/common/7z.md +++ b/pages.pl/common/7z.md @@ -3,30 +3,34 @@ > Archiwizator plików o wysokim stopniu kompresji. > Więcej informacji: . -- Zarchiwizuj plik lub katalog: +- Dodaj plik lub katalog do nowego lub istniejącego archiwum: -`7z a {{zarchiwizowane.7z}} {{sciezka/do/pliku_lub_katalogu}}` +`7z a {{ścieżka/do/archiwum.7z}} {{ścieżka/do/pliku_lub_katalogu}}` -- Zaszyfruj istniejące archiwum (w tym nagłówki)): +- Zaszyfruj istniejące archiwum (w tym nagłówki): -`7z a {{zaszyfrowane.7z}} -p{{haslo}} -mhe=on {{zarchiwizowane.7z}}` +`7z a {{ścieżka/do/zaszyfrowanego.7z}} -p{{hasło}} -mhe=on {{ścieżka/do/archiwum.7z}}` - Wyodrębnij istniejący plik 7z z oryginalną strukturą katalogów: -`7z x {{zarchiwizowane.7z}}` +`7z x {{ścieżka/do/archiwum.7z}}` -- Wyodrębnij archiwum ze ścieżką wyjściową zdefiniowaną przez użytkownika: +- Wyodrębnij archiwum do określonego katalogu: -`7z x {{zarchiwizowane.7z}} -o{{sciezka/do/wyjscia}}` +`7z x {{ścieżka/do/archiwum.7z}} -o{{ścieżka/do/wyjścia}}` - Wypakuj archiwum do `stdout`: -`7z x {{zarchiwizowane.7z}} -so` +`7z x {{ścieżka/do/archiwum.7z}} -so` - Archiwizuj przy użyciu określonego typu archiwum: -`7z a -t{{7z|bzip2|gzip|lzip|tar|zip}} {{zarchiwizowane}} {{sciezka/do/pliku_lub_katalogu}}` +`7z a -t{{7z|bzip2|gzip|lzip|tar|zip}} {{ścieżka/do/archiwum}} {{ścieżka/do/pliku_lub_katalogu}}` - Wyświetl zawartość pliku archiwum: -`7z l {{zarchiwizowane.7z}}` +`7z l {{ścieżka/do/archiwum.7z}}` + +- Ustaw poziom kompresji (wyższy oznacza wyższą kompresję, ale wolniejszą): + +`7z a {{ścieżka/do/archiwum.7z}} -mx={{0|1|3|5|7|9}} {{ścieżka/do/pliku_lub_katalogu}}` diff --git a/pages.pl/common/7za.md b/pages.pl/common/7za.md index 68ef93137..7ed6959ff 100644 --- a/pages.pl/common/7za.md +++ b/pages.pl/common/7za.md @@ -1,21 +1,37 @@ # 7za > Archiwizator plików o wysokim współczynniku kompresji. -> Samodzielna wersja `7z` z obsługą mniejszej liczby typów archiwów. +> Podobny do `7z` z wyjątkiem tego, że obsługuje mniej typów plików, ale jest wieloplatformowy. > Więcej informacji: . - Zarchiwizuj plik lub katalog: -`7za a {{archiwum.7z}} {{scieżka/do/pliku_lub_katalogu}}` +`7za a {{ścieżka/do/archiwum.7z}} {{ścieżka/do/pliku_lub_katalogu}}` -- Wyodrębnij istniejący plik 7z z oryginalną strukturą katalogów: +- Zaszyfruj istniejące archiwum (w tym nagłówki): -`7za x {{archiwum}}` +`7za a {{ścieżka/do/zaszyfrowanego.7z}} -p{{hasło}} -mhe={{on}} {{ścieżka/do/archiwum.7z}}` + +- Wyodrębnij archiwum, zachowując oryginalną strukturę katalogów: + +`7za x {{ścieżka/do/archiwum.7z}}` + +- Wyodrębnij archiwum do określonego katalogu: + +`7za x {{ścieżka/do/archiwum.7z}} -o{{ścieżka/do/wyjścia}}` + +- Wypakuj archiwum do `stdout`: + +`7za x {{ścieżka/do/archiwum.7z}} -so` - Zarchiwizuj przy użyciu określonego typu archiwum: -`7za a -t{{zip|gzip|bzip2|tar}} {{archiwum}} {{scieżka/do/pliku_lub_katalogu}}` +`7za a -t{{7z|bzip2|gzip|lzip|tar|...}} {{ścieżka/do/archiwum.7z}} {{ścieżka/do/pliku_lub_katalogu}}` - Wypisz zawartość pliku archiwum: -`7za l {{archiwum}}` +`7za l {{ścieżka/do/archiwum.7z}}` + +- Ustaw poziom kompresji (wyższy oznacza wyższą kompresję, ale wolniejszą): + +`7za a {{ścieżka/do/archiwum.7z}} -mx={{0|1|3|5|7|9}} {{ścieżka/do/pliku_lub_katalogu}}` diff --git a/pages.pl/common/ack.md b/pages.pl/common/ack.md index 4b56ce993..41b4325c9 100644 --- a/pages.pl/common/ack.md +++ b/pages.pl/common/ack.md @@ -18,11 +18,11 @@ - Ogranicz wyszukiwanie do plików wyłącznie określonego typu: -`ack --type={{ruby}} "{{wzorzec}}"` +`ack --type {{ruby}} "{{wzorzec}}"` - Wyszukaj z pominięciem plików określonego typu: -`ack --type=no{{ruby}} "{{wzorzec}}"` +`ack --type no{{ruby}} "{{wzorzec}}"` - Policz całkowitą liczbę dopasowań: diff --git a/pages.pl/common/ag.md b/pages.pl/common/ag.md index 0a6221988..3f3e09000 100644 --- a/pages.pl/common/ag.md +++ b/pages.pl/common/ag.md @@ -9,7 +9,7 @@ - Znajdź pliki zawierające „foo” w określonym katalogu: -`ag {{foo}} {{scieżka/do/katalogu}}` +`ag {{foo}} {{ścieżka/do/katalogu}}` - Znajdź pliki zawierające „foo”, ale podaj tylko nazwy plików: diff --git a/pages.pl/common/atom.md b/pages.pl/common/atom.md index ab6fcbe15..5b527f349 100644 --- a/pages.pl/common/atom.md +++ b/pages.pl/common/atom.md @@ -6,15 +6,15 @@ - Otwórz plik lub katalog: -`atom {{sciezka/do/pliku_lub_katalogu}}` +`atom {{ścieżka/do/pliku_lub_katalogu}}` -- Otwórz plik lub katalog w nowym oknie: +- Otwórz plik lub katalog w [n]owym oknie: -`atom -n {{sciezka/do/pliku_lub_katalogu}}` +`atom -n {{ścieżka/do/pliku_lub_katalogu}}` - Otwórz plik lub katalog w istniejącym oknie: -`atom --add {{sciezka/do/pliku_lub_katalogu}}` +`atom --add {{ścieżka/do/pliku_lub_katalogu}}` - Otwórz Atom w trybie bezpiecznym (nie ładuje żadnych dodatkowych pakietów): diff --git a/pages.pl/common/autoflake.md b/pages.pl/common/autoflake.md index ac2971b0a..94968f1a8 100644 --- a/pages.pl/common/autoflake.md +++ b/pages.pl/common/autoflake.md @@ -1,6 +1,6 @@ # autoflake -> Narzędzie do usuwania nieużywanych importów i zmiennych z kodu Python. +> Usuń nieużywane importy i zmienne z kodu Python. > Więcej informacji: . - Usuń nieużywane zmienne z jednego pliku i wyświetl różnicę: @@ -17,4 +17,4 @@ - Usuń nieużywane zmienne rekurencyjnie ze wszystkich plików w katalogu, nadpisując każdy plik: -`autoflake --remove-unused-variables --in-place --recursive {{sciezka/do/katalogu}}` +`autoflake --remove-unused-variables --in-place --recursive {{ścieżka/do/katalogu}}` diff --git a/pages.pl/common/aws.md b/pages.pl/common/aws.md index 2d22c85fa..6888a06ba 100644 --- a/pages.pl/common/aws.md +++ b/pages.pl/common/aws.md @@ -1,7 +1,7 @@ # aws > Oficjalne narzędzie CLI dla Amazon Web Services. -> Wizard, SSO, Resource Autocompletion, i opcje YAML są tylko v2. +> Niektóre podkomendy takie jak `aws s3` mają osobną dokumentację. > Więcej informacji: . - Konfiguruj AWS Command-line: @@ -12,15 +12,11 @@ `aws configure sso` -- Zobacz tekst pomocy dla polecenia AWS: - -`aws {{komenda}} help` - - Uzyskaj tożsamość wywołującego (służy do rozwiązywania problemów z uprawnieniami): `aws sts get-caller-identity` -- Wyświetla listę zasobów AWS w regionie i wyświetla w yaml: +- Uzyskaj listę zasobów AWS w regionie i wyświetl ją w YAML: `aws dynamodb list-tables --region {{us-east-1}} --output yaml` @@ -35,3 +31,7 @@ - Generuj JSON CLI Skeleton (przydatne dla infrastruktury jako kodu): `aws dynamodb update-table --generate-cli-skeleton` + +- Wyświetl pomoc dla określonej komendy: + +`aws {{komenda}} help` diff --git a/pages.pl/common/babel.md b/pages.pl/common/babel.md index 0d541952e..32221ed2f 100644 --- a/pages.pl/common/babel.md +++ b/pages.pl/common/babel.md @@ -3,33 +3,33 @@ > Transpiler, który konwertuje kod ze składni JavaScript ES6 / ES7 na składnię ES5. > Więcej informacji: . -- Transpiluj określony plik wejściowy i dane wyjściowe do `stdout`: +- Transpiluj określony plik wejściowy i wypisz dane wyjściowe do `stdout`: -`babel {{siezka/do/pliku}}` +`babel {{ścieżka/do/pliku}}` -- Transpiluj określony plik wejściowy i wyjście do określonego pliku: +- Transpiluj określony plik wejściowy i zapisz wyjście do określonego pliku: -`babel {{sciezka/do/pliku_wejsciowego}} --out-file {{sciezka/do/pliku_wyjsciowego}}` +`babel {{ścieżka/do/pliku_wejściowego}} --out-file {{ścieżka/do/pliku_wyjściowego}}` - Transpiluj plik wejściowy przy każdej zmianie: -`babel {{sciezka/do/pliku_wejsciowego}} --watch` +`babel {{ścieżka/do/pliku_wejściowego}} --watch` - Transpiluj cały katalog plików: -`babel {{sciezka/do/katalogu_wejsciowego}}` +`babel {{ścieżka/do/katalogu_wejściowego}}` - Zignoruj określone pliki oddzielone przecinkami w katalogu: -`babel {{sciezka/do/katalogu_wejsciowego}} --ignore {{ignorowane_pliki}}` +`babel {{ścieżka/do/katalogu_wejściowego}} --ignore {{ignorowany_plik1,ignorowany_plik2,...}}` - Transpiluj i wypisz jako zminimalizowany JavaScript: -`babel {{sciezka/do/pliku_wejsciowego}} --minified` +`babel {{ścieżka/do/pliku_wejściowego}} --minified` - Wybierz zestaw ustawień dla formatowania wyjściowego: -`babel {{sciezka/do/pliku_wejsciowego}} --presets {{presets}}` +`babel {{ścieżka/do/pliku_wejściowego}} --presets {{preset1,preset2,...}}` - Wyświetl wszystkie dostępne opcje: diff --git a/pages.pl/common/bash.md b/pages.pl/common/bash.md new file mode 100644 index 000000000..65d586e7e --- /dev/null +++ b/pages.pl/common/bash.md @@ -0,0 +1,37 @@ +# bash + +> Bourne-Again SHell, interpreter komend powłoki systemowej kompatybilny z `sh`. +> Zobacz także: `zsh`, `histexpand`. +> Więcej informacji: . + +- Rozpocznij interaktywną sesję powłoki: + +`bash` + +- Rozpocznij interaktywną sesję powłoki bez ładowania konfiguracji: + +`bash --norc` + +- Wywołaj określone komendy: + +`bash -c "{{echo 'bash jest uruchomiony'}}"` + +- Uruchom podany skrypt: + +`bash {{ścieżka/do/skryptu.sh}}` + +- Wykonaj podany skrypt, wypisując wszystkie komendy przed ich wykonaniem: + +`bash -x {{ścieżka/do/skryptu.sh}}` + +- Wykonaj podany skrypt do wystąpienia pierwszego błędu: + +`bash -e {{ścieżka/do/skryptu.sh}}` + +- Wykonaj komendy ze `stdin`: + +`{{echo "echo 'bash jest uruchomiony'"}} | bash` + +- Uruchom sesję w trybie [r]estrykcyjnym: + +`bash -r` diff --git a/pages.pl/common/bmptoppm.md b/pages.pl/common/bmptoppm.md new file mode 100644 index 000000000..e9ae02993 --- /dev/null +++ b/pages.pl/common/bmptoppm.md @@ -0,0 +1,8 @@ +# bmptoppm + +> To polecenie zostało zastąpione przez `bmptopnm`. +> Więcej informacji: . + +- Zobacz dokumentację aktualnego polecenia: + +`tldr bmptopnm` diff --git a/pages.pl/common/clamav.md b/pages.pl/common/clamav.md index ca19a9c2f..b1ad52476 100644 --- a/pages.pl/common/clamav.md +++ b/pages.pl/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > To polecenie jest aliasem `clamdscan`. > Więcej informacji: . diff --git a/pages.pl/common/compare.md b/pages.pl/common/compare.md new file mode 100644 index 000000000..7893ff3ac --- /dev/null +++ b/pages.pl/common/compare.md @@ -0,0 +1,7 @@ +# compare + +> To polecenie jest aliasem `magick compare`. + +- Zobacz dokumentację oryginalnego polecenia: + +`tldr magick compare` diff --git a/pages.pl/common/convert.md b/pages.pl/common/convert.md new file mode 100644 index 000000000..571f9dacb --- /dev/null +++ b/pages.pl/common/convert.md @@ -0,0 +1,9 @@ +# convert + +> To polecenie jest aliasem `magick convert`. +> Uwaga: ten alias jest wycofany od ImageMagick 7. Został on zastąpiony przez `magick`. +> Użyj `magick convert` jeśli potrzebujesz użyć starego narzędzia w wersjach 7+. + +- Zobacz dokumentację oryginalnego polecenia: + +`tldr magick convert` diff --git a/pages.pl/common/csslint.md b/pages.pl/common/csslint.md index c2d94e143..83b49d751 100644 --- a/pages.pl/common/csslint.md +++ b/pages.pl/common/csslint.md @@ -1,15 +1,15 @@ # csslint -> Linter dla kodu CSS. +> Lintuj kod CSS. > Więcej informacji: . -- Lintowanie pojedynczego pliku CSS: +- Lintuj pojedyńczy plik CSS: `csslint {{plik.css}}` -- Lintowanie wiele plików CSS: +- Lintuj wiele plików CSS: -`csslint {{plik1.css}} {{plik2.css}} {{plik3.css}}` +`csslint {{plik1.css plik2.css ...}}` - Wymień wszystkie możliwe reguły stylu: @@ -17,12 +17,12 @@ - Określ pewne reguły jako błędy (które powodują niezerowy kod wyjścia): -`csslint --errors={{bledy,universal-selector,imports}} {{plik.css}}` +`csslint --errors={{errors,universal-selector,imports}} {{plik.css}}` - Określ pewne reguły jako ostrzeżenia: `csslint --warnings={{box-sizing,selector-max,floats}} {{plik.css}}` -- Określ pewne reguły, które będą całkowicie ignorowane: +- Ignoruj określone reguły: `csslint --ignore={{ids,rules-count,shorthand}} {{plik.css}}` diff --git a/pages.pl/common/cups.md b/pages.pl/common/cups.md new file mode 100644 index 000000000..484696e0c --- /dev/null +++ b/pages.pl/common/cups.md @@ -0,0 +1,25 @@ +# CUPS + +> Otwarty system drukowania. +> CUPS nie jest pojedynczym poleceniem, ale zestawem poleceń. +> Więcej informacji: . + +- Zobacz dokumentację uruchamiania demona CUPS: + +`tldr cupsd` + +- Zobacz dokumentację zarządzania drukarkami: + +`tldr lpadmin` + +- Zobacz dokumentację drukowania plików: + +`tldr lp` + +- Zobacz dokumentację sprawdzania informacji o stanie bieżących klas, zadań i drukarek: + +`tldr lpstat` + +- Zobacz dokumentację anulowania zadań drukowania: + +`tldr lprm` diff --git a/pages.pl/common/dart.md b/pages.pl/common/dart.md new file mode 100644 index 000000000..2de4faf93 --- /dev/null +++ b/pages.pl/common/dart.md @@ -0,0 +1,32 @@ +# dart + +> Zarządzaj projektami Dart. +> Więcej informacji: . + +- Zainicjuj nowy projekt Dart w katalogu o tej samej nazwie: + +`dart create {{nazwa_projektu}}` + +- Uruchom plik Dart: + +`dart run {{ścieżka/do/pliku.dart}}` + +- Pobierz zależności dla obecnego projektu: + +`dart pub get` + +- Uruchom testy jednostkowe dla obecnego projektu: + +`dart test` + +- Aktualizuj przestarzałe zależności projektu w celu obsługi null-safety: + +`dart pub upgrade --null-safety` + +- Skompiluj plik Dart do natywnego pliku binarnego: + +`dart compile exe {{ścieżka/do/pliku.dart}}` + +- Zastosuj automatyczne poprawki dla obecnego projektu: + +`dart fix --apply` diff --git a/pages.pl/common/diff.md b/pages.pl/common/diff.md index cbdd9d97a..7426f14f3 100644 --- a/pages.pl/common/diff.md +++ b/pages.pl/common/diff.md @@ -1,7 +1,7 @@ # diff > Porównaj pliki i foldery. -> Więcej informacji: . +> Więcej informacji: . - Porównaj pliki (lista zmian między `stary_plik` a `nowy_plik`): diff --git a/pages.pl/common/dotnet.md b/pages.pl/common/dotnet.md index 0a23108a8..c3941ed56 100644 --- a/pages.pl/common/dotnet.md +++ b/pages.pl/common/dotnet.md @@ -1,13 +1,14 @@ # dotnet > Wieloplatformowe narzędzia wiersza polecenia .NET dla platformy .NET Core. +> Niektóre podkomendy takie jak `dotnet build` mają osobną dokumentację. > Więcej informacji: . - Zainicjuj nowy projekt .NET: -`dotnet new {{szablon_krotka_nazwa}}` +`dotnet new {{krótka_nazwa_szablonu}}` -- Przywróć pakiety nuget: +- Przywróć pakiety NuGet: `dotnet restore` @@ -15,6 +16,6 @@ `dotnet run` -- Uruchom pakietową aplikację dotnet (wymaga tylko środowiska wykonawczego, pozostałe polecenia wymagają zainstalowanego zestawu .NET Core SDK): +- Uruchom spakowaną aplikację dotnet (wymaga tylko środowiska wykonawczego, pozostałe polecenia wymagają zainstalowanego zestawu .NET Core SDK): -`dotnet {{sciezka/do/aplikacji.dll}}` +`dotnet {{ścieżka/do/aplikacji.dll}}` diff --git a/pages.pl/common/entr.md b/pages.pl/common/entr.md index 2e3d9ad91..536fef998 100644 --- a/pages.pl/common/entr.md +++ b/pages.pl/common/entr.md @@ -1,7 +1,7 @@ # entr > Uruchom dowolną komendę, gdy zmieni się plik. -> Więcej informacji: . +> Więcej informacji: . - Przebuduj projekt używając `make`, jeżeli zmiemi się którykolwiek z plików w podkatalogu: diff --git a/pages.pl/common/fossil-ci.md b/pages.pl/common/fossil-ci.md index 1e23f3083..6ae8eb856 100644 --- a/pages.pl/common/fossil-ci.md +++ b/pages.pl/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> To polecenie jest aliasem `fossil-commit`. +> To polecenie jest aliasem `fossil commit`. > Więcej informacji: . - Zobacz dokumentację oryginalnego polecenia: diff --git a/pages.pl/common/fossil-delete.md b/pages.pl/common/fossil-delete.md index 10f919f11..9c553853f 100644 --- a/pages.pl/common/fossil-delete.md +++ b/pages.pl/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > To polecenie jest aliasem `fossil rm`. > Więcej informacji: . diff --git a/pages.pl/common/fossil-forget.md b/pages.pl/common/fossil-forget.md index af6a342ee..1110ab3cf 100644 --- a/pages.pl/common/fossil-forget.md +++ b/pages.pl/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > To polecenie jest aliasem `fossil rm`. > Więcej informacji: . diff --git a/pages.pl/common/fossil-new.md b/pages.pl/common/fossil-new.md index d667abbbc..de674b077 100644 --- a/pages.pl/common/fossil-new.md +++ b/pages.pl/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> To polecenie jest aliasem `fossil-init`. +> To polecenie jest aliasem `fossil init`. > Więcej informacji: . - Zobacz dokumentację oryginalnego polecenia: diff --git a/pages.pl/common/frp.md b/pages.pl/common/frp.md new file mode 100644 index 000000000..98e24ab87 --- /dev/null +++ b/pages.pl/common/frp.md @@ -0,0 +1,12 @@ +# frp + +> Fast Reverse Proxy: szybko konfiguruj tunele sieciowe w celu udostępnienia określonych usług w Internecie lub innych sieciach zewnętrznych. +> Więcej informacji: . + +- Zobacz dokumentację `frpc`, komponentu klienta `frp`: + +`tldr frpc` + +- Zobacz dokumentację `frps`, komponentu serwera `frp`: + +`tldr frps` diff --git a/pages.pl/common/gemtopbm.md b/pages.pl/common/gemtopbm.md new file mode 100644 index 000000000..9ca4cade9 --- /dev/null +++ b/pages.pl/common/gemtopbm.md @@ -0,0 +1,8 @@ +# gemtopbm + +> To polecenie zostało zastąpione przez `gemtopnm`. +> Więcej informacji: . + +- Zobacz dokumentację aktualnego polecenia: + +`tldr gemtopnm` diff --git a/pages.pl/common/gh-cs.md b/pages.pl/common/gh-cs.md index 44a14ff14..854898ab5 100644 --- a/pages.pl/common/gh-cs.md +++ b/pages.pl/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> To polecenie jest aliasem `gh-codespace`. +> To polecenie jest aliasem `gh codespace`. > Więcej informacji: . - Zobacz dokumentację oryginalnego polecenia: diff --git a/pages.pl/common/gnmic-sub.md b/pages.pl/common/gnmic-sub.md index 6bfb11043..77fe78d3d 100644 --- a/pages.pl/common/gnmic-sub.md +++ b/pages.pl/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > To polecenie jest aliasem `gnmic subscribe`. > Więcej informacji: . diff --git a/pages.pl/common/icontopbm.md b/pages.pl/common/icontopbm.md new file mode 100644 index 000000000..1b0fe9fed --- /dev/null +++ b/pages.pl/common/icontopbm.md @@ -0,0 +1,8 @@ +# icontopbm + +> To polecenie zostało zastąpione przez `sunicontopnm`. +> Więcej informacji: . + +- Zobacz dokumentację aktualnego polecenia: + +`tldr sunicontopnm` diff --git a/pages.pl/common/identify.md b/pages.pl/common/identify.md new file mode 100644 index 000000000..a185110f2 --- /dev/null +++ b/pages.pl/common/identify.md @@ -0,0 +1,7 @@ +# identify + +> To polecenie jest aliasem `magick identify`. + +- Zobacz dokumentację oryginalnego polecenia: + +`tldr magick identify` diff --git a/pages.pl/common/import.md b/pages.pl/common/import.md new file mode 100644 index 000000000..670ed6a9d --- /dev/null +++ b/pages.pl/common/import.md @@ -0,0 +1,7 @@ +# import + +> To polecenie jest aliasem `magick import`. + +- Zobacz dokumentację oryginalnego polecenia: + +`tldr magick import` diff --git a/pages.pl/common/jfrog.md b/pages.pl/common/jfrog.md new file mode 100644 index 000000000..b795fc11c --- /dev/null +++ b/pages.pl/common/jfrog.md @@ -0,0 +1,7 @@ +# jfrog + +> To polecenie jest aliasem `jf`. + +- Zobacz dokumentację oryginalnego polecenia: + +`tldr jf` diff --git a/pages.pl/common/lckdo.md b/pages.pl/common/lckdo.md new file mode 100644 index 000000000..8401a4886 --- /dev/null +++ b/pages.pl/common/lckdo.md @@ -0,0 +1,8 @@ +# lckdo + +> To polecenie jest przestarzałe i zastąpione przez `flock`. +> Więcej informacji: . + +- Zobacz dokumentację zalecanego zamiennika: + +`tldr flock` diff --git a/pages.pl/common/ls.md b/pages.pl/common/ls.md index 5bdf90d57..73922c80d 100644 --- a/pages.pl/common/ls.md +++ b/pages.pl/common/ls.md @@ -15,19 +15,19 @@ `ls -F` -- Lista w długim formacie (uprawnienia, właściciel/ka, rozmiar i data modyfikacji) wszystkich plików: +- Wypisz listę w długim formacie (uprawnienia, własność, rozmiar i data modyfikacji) wszystkich plików: `ls -la` -- Lista w długim formacie z rozmiarem w jednostkach z przedrostkami dwójkowymi (KiB, MiB, GiB): +- Wypisz listę w długim formacie z rozmiarem w jednostkach z przedrostkami dwójkowymi (KiB, MiB, GiB): `ls -lh` -- Lista w długim formacie posortowana rozmiarem (malejąco): +- Wypisz listę rekurencyjnie w długim formacie, posortowaną po rozmiarze (malejąco): -`ls -lS` +`ls -lSR` -- Lista wszystkich plików w długim formacie posortowanych według daty modyfikacji (od najstarszych): +- Wypisz listę wszystkich plików w długim formacie posortowaną według daty modyfikacji (od najstarszych): `ls -ltr` diff --git a/pages.pl/common/mysql.md b/pages.pl/common/mysql.md index ad78ce74c..91ce357ee 100644 --- a/pages.pl/common/mysql.md +++ b/pages.pl/common/mysql.md @@ -3,30 +3,30 @@ > Narzędzie wiersza polecenia MySQL. > Więcej informacji: . -- Połącz z bazą danych: +- Połącz się z bazą danych: -`mysql {{nazwa_bazydanych}}` +`mysql {{nazwa_bazy_danych}}` - Połącz się z bazą danych, użytkownik zostanie poproszony o podanie hasła: -`mysql -u {{uzytkownik}} --password {{nazwa_bazydanych}}` +`mysql -u {{użytkownik}} --password {{nazwa_bazy_danych}}` - Połącz się z bazą danych na innym hoście: -`mysql -h {{host_bazydanych}} {{nazwa_bazydanych}}` +`mysql -h {{host_bazy_danych}} {{nazwa_bazy_danych}}` - Połącz się z bazą danych przez gniazdo Unix: -`mysql --socket {{sciezka/do/socket.sock}}` +`mysql --socket {{ścieżka/do/gniazda.sock}}` - Wykonuj instrukcje SQL w pliku skryptu (plik wsadowy): -`mysql -e "source {{nazwapliku.sql}}" {{nazwa_bazydanych}}` +`mysql -e "source {{nazwa_pliku.sql}}" {{nazwa_bazy_danych}}` - Przywróć bazę danych z kopii zapasowej (użytkownik zostanie poproszony o podanie hasła): -`mysql --user {{uzytkownik}} --password {{nazwa_bazydanych}} < {{sciezka/do/backup.sql}}` +`mysql --user {{użytkownik}} --password {{nazwa_bazy_danych}} < {{ścieżka/do/kopii_zapasowej.sql}}` - Przywróć wszystkie bazy danych z kopii zapasowej (użytkownik zostanie poproszony o podanie hasła): -`mysql --user {{uzytkownik}} --password < {{sciezka/do/backup.sql}}` +`mysql --user {{użytkownik}} --password < {{ścieżka/do/kopii_zapasowej.sql}}` diff --git a/pages.pl/common/nmap.md b/pages.pl/common/nmap.md index 070368fdd..c43759632 100644 --- a/pages.pl/common/nmap.md +++ b/pages.pl/common/nmap.md @@ -2,7 +2,7 @@ > Narzędzie do enumeracji sieci oraz skanowania portów. > Niektóre funkcję są tylko aktywne gdy Nmap uruchamiany jest z przywilejami root'a. -> Więcej informacji: . +> Więcej informacji: . - Sprawdź czy host odpowiada na skanowanie oraz zgadnij system operacyjny: diff --git a/pages.pl/common/open.md b/pages.pl/common/open.md index 8beb27c88..338989cfc 100644 --- a/pages.pl/common/open.md +++ b/pages.pl/common/open.md @@ -6,6 +6,6 @@ `tldr open -p osx` -- Zobacz dokumentację komendy dostępnej w `fish`: +- Zobacz dokumentację komendy dostępnej w fish: `tldr open.fish` diff --git a/pages.pl/common/php.md b/pages.pl/common/php.md index 67ab6f4cc..febba8147 100644 --- a/pages.pl/common/php.md +++ b/pages.pl/common/php.md @@ -3,7 +3,7 @@ > Interfejs wiersza poleceń PHP. > Więcej informacji: . -- Parsuj i uruchom skrypt php: +- Parsuj i uruchom skrypt PHP: `php {{plik}}` diff --git a/pages.pl/common/pio-init.md b/pages.pl/common/pio-init.md index e974d8032..11d3580df 100644 --- a/pages.pl/common/pio-init.md +++ b/pages.pl/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > To polecenie jest aliasem `pio project`. diff --git a/pages.pl/common/r.md b/pages.pl/common/r.md index 4cf873e6c..d32110715 100644 --- a/pages.pl/common/r.md +++ b/pages.pl/common/r.md @@ -1,4 +1,4 @@ -# r +# R > Interpreter języka R. > Więcej informacji: . diff --git a/pages.pl/common/rsync.md b/pages.pl/common/rsync.md index d2da6b76c..b14b5f2fd 100644 --- a/pages.pl/common/rsync.md +++ b/pages.pl/common/rsync.md @@ -1,7 +1,7 @@ # rsync > Przesyłaj pliki do lub ze zdalnego hosta (ale nie pomiędzy dwoma zdalnymi hostami), domyślnie używając SSH. -> Aby wskazać na ścieżkę zdalną, użyj `host:ścieżka/do/pliku_lub_katalogu`. +> Aby wskazać na ścieżkę zdalną, użyj `user@host:ścieżka/do/pliku_lub_katalogu`. > Więcej informacji: . - Prześlij plik: @@ -10,28 +10,28 @@ - Użyj trybu archiwum (rekursywnie kopiuj katalogi, kopiuj dowiązania symboliczne bez rozwiązywania i zachowaj uprawnienia, własność i czasy modyfikacji): -`rsync --archive {{ścieżka/do/źródła}} {{ścieżka/do/miejsca_docelowego}}` +`rsync {{-a|--archive}} {{ścieżka/do/źródła}} {{ścieżka/do/miejsca_docelowego}}` - Kompresuj dane podczas gdy są wysyłane do miejsca docelowego, wyświetlaj szczegółowy i czytelny dla człowieka postęp i zachowaj częściowo przesłane pliki w przypadku przerwania: -`rsync --compress --verbose --human-readable --partial --progress {{ścieżka/do/źródła}} {{ścieżka/do/miejsca_docelowego}}` +`rsync {{-zvhP|--compress --verbose --human-readable --partial --progress}} {{ścieżka/do/źródła}} {{ścieżka/do/miejsca_docelowego}}` - Rekursywnie kopiuj katalogi: -`rsync --recursive {{ścieżka/do/źródła}} {{ścieżka/do/miejsca_docelowego}}` +`rsync {{-r|--recursive}} {{ścieżka/do/źródła}} {{ścieżka/do/miejsca_docelowego}}` - Prześlij zawartość katalogu, ale nie sam katalog: -`rsync --recursive {{ścieżka/do/źródła}}/ {{ścieżka/do/miejsca_docelowego}}` +`rsync {{-r|--recursive}} {{ścieżka/do/źródła}}/ {{ścieżka/do/miejsca_docelowego}}` - Rekursywnie kopiuj katalogi, użyj trybu archiwum, rozwiąż dowiązania symboliczne i pomiń pliki, które są nowsze w miejscu docelowym: -`rsync --archive --update --copy-links {{ścieżka/do/źródła}} {{ścieżka/do/miejsca_docelowego}}` +`rsync {{-auL|--archive --update --copy-links}} {{ścieżka/do/źródła}} {{ścieżka/do/miejsca_docelowego}}` -- Prześlij katalog do zdalnego hosta, na którym działa `rsyncd` i usuń pliki w miejscu docelowym które nie istnieją w źródle: +- Prześlij katalog ze zdalnego hosta, na którym działa `rsyncd` i usuń pliki w miejscu docelowym, które nie istnieją w źródle: -`rsync --recursive --delete rsync://{{host}}:{{ścieżka/do/źródła}} {{ścieżka/do/miejsca_docelowego}}` +`rsync {{-r|--recursive}} --delete rsync://{{host}}:{{ścieżka/do/źródła}} {{ścieżka/do/miejsca_docelowego}}` - Prześlij plik poprzez SSH używając innego portu niż domyślny (22) i wyświetlaj globalny postęp: -`rsync --rsh 'ssh -p {{port}}' --info=progress2 {{host}}:{{ścieżka/do/źródła}} {{ścieżka/do/miejsca_docelowego}}` +`rsync {{-e|--rsh}} 'ssh -p {{port}}' --info=progress2 {{host}}:{{ścieżka/do/źródła}} {{ścieżka/do/miejsca_docelowego}}` diff --git a/pages.pl/common/sudo.md b/pages.pl/common/sudo.md index 277a01b1a..563add3e5 100644 --- a/pages.pl/common/sudo.md +++ b/pages.pl/common/sudo.md @@ -15,7 +15,7 @@ `sudo -u {{uzytkownik}} -g {{grupa}} {{id -a}}` -- Powtórz ostatnie polecenie poprzedzone `sudo` (tylko w `bash`, `zsh`, etc.): +- Powtórz ostatnie polecenie poprzedzone `sudo` (tylko w Bash, Zsh, etc.): `sudo !!` diff --git a/pages.pl/common/tig.md b/pages.pl/common/tig.md index ab0d8f23d..240daf67d 100644 --- a/pages.pl/common/tig.md +++ b/pages.pl/common/tig.md @@ -1,7 +1,7 @@ # tig > Interfejs tekstowy dla Gita. -> Więcej informacji: . +> Więcej informacji: . - Pokaż listę commitów w odwrotnej kolejności chronologicznej, zaczynając od najnowszego: diff --git a/pages.pl/common/tlmgr-arch.md b/pages.pl/common/tlmgr-arch.md index 167e480d6..936145256 100644 --- a/pages.pl/common/tlmgr-arch.md +++ b/pages.pl/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > To polecenie jest aliasem `tlmgr platform`. > Więcej informacji: . diff --git a/pages.pl/common/yes.md b/pages.pl/common/yes.md index 23a8ce8fa..769d7899c 100644 --- a/pages.pl/common/yes.md +++ b/pages.pl/common/yes.md @@ -4,14 +4,18 @@ > Komenda używana często aby potwierdzić pytania zadawane przez komendy instalujące takie jak apt-get. > Więcej informacji: . -- Wypisuje bez końca "wiadomość": +- Wypisuj bez końca "wiadomość": `yes {{wiadomość}}` -- Wypisuje bez końca "y": +- Wypisuj bez końca "y": `yes` - Wysyłaj potwierdzenie dla każdego pytania zadanego przez `apt-get`: `yes | sudo apt-get install {{program}}` + +- Wielokrotnie wypisuj znak nowej linii, aby zawsze akceptować domyślne opcje poleceń: + +`yes ''` diff --git a/pages.pl/linux/a2disconf.md b/pages.pl/linux/a2disconf.md new file mode 100644 index 000000000..2f59def87 --- /dev/null +++ b/pages.pl/linux/a2disconf.md @@ -0,0 +1,12 @@ +# a2disconf + +> Wyłącz plik konfiguracyjny Apache w systemach opartych na Debianie. +> Więcej informacji: . + +- Wyłącz plik konfiguracyjny: + +`sudo a2disconf {{plik_konfiguracyjny}}` + +- Nie pokazuj wiadomości informacyjnych: + +`sudo a2disconf --quiet {{plik_konfiguracyjny}}` diff --git a/pages.pl/linux/apt-file.md b/pages.pl/linux/apt-file.md index 9276fefa2..0636bd3fc 100644 --- a/pages.pl/linux/apt-file.md +++ b/pages.pl/linux/apt-file.md @@ -1,6 +1,6 @@ # apt-file -> Wyszukaj pliki w pakietach apt, w tym jeszcze nie zainstalowanych. +> Wyszukaj pliki w pakietach APT, w tym jeszcze nie zainstalowanych. > Więcej informacji: . - Zaktualizuj bazę metadanych: diff --git a/pages.pl/linux/apt-key.md b/pages.pl/linux/apt-key.md index 7fa41a258..8fb3460ed 100644 --- a/pages.pl/linux/apt-key.md +++ b/pages.pl/linux/apt-key.md @@ -20,6 +20,6 @@ `wget -qO - {{https://host.tld/nazwa_pliku.key}} | apt-key add -` -- Dodaj klucz z serwera kluczy na podstawie id klucza: +- Dodaj klucz z serwera kluczy na podstawie ID klucza: `apt-key adv --keyserver {{pgp.mit.edu}} --recv {{id_klucza}}` diff --git a/pages.pl/linux/ip-route-list.md b/pages.pl/linux/ip-route-list.md index 30e37434c..3531b7bf3 100644 --- a/pages.pl/linux/ip-route-list.md +++ b/pages.pl/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> To polecenie jest aliasem `ip-route-show`. +> To polecenie jest aliasem `ip route show`. - Zobacz dokumentację oryginalnego polecenia: diff --git a/pages.pl/openbsd/cal.md b/pages.pl/openbsd/cal.md new file mode 100644 index 000000000..82cc9c854 --- /dev/null +++ b/pages.pl/openbsd/cal.md @@ -0,0 +1,32 @@ +# cal + +> Wyświetl kalendarz z wyróżnionym bieżącym dniem. +> Więcej informacji: . + +- Wyświetl kalendarz dla obecnego miesiąca: + +`cal` + +- Wyświetl kalendarz dla określonego roku: + +`cal {{rok}}` + +- Wyświetl kalendarz dla określonego miesiąca i roku: + +`cal {{miesiąc}} {{rok}}` + +- Wyświetl kalendarz dla obecnego roku (z ang. [y]ear): + +`cal -y` + +- Wyświetl dni [j]uliańskie (zaczynając od jeden, numerowane od 1 stycznia): + +`cal -j` + +- Użyj poniedziałku (z ang. [m]onday) jako początku tygodnia zamiast niedzieli: + +`cal -m` + +- Wyświetl numery tygodni (z ang. [w]eek) (niezgodne z `-j`): + +`cal -w` diff --git a/pages.pl/openbsd/chfn.md b/pages.pl/openbsd/chfn.md new file mode 100644 index 000000000..c1ba8d8dd --- /dev/null +++ b/pages.pl/openbsd/chfn.md @@ -0,0 +1,7 @@ +# chfn + +> Ta komenda jest aliasem `chpass`. + +- Pokaż dokumentację oryginalnej komendy: + +`tldr chpass` diff --git a/pages.pl/openbsd/chpass.md b/pages.pl/openbsd/chpass.md new file mode 100644 index 000000000..a425ccac7 --- /dev/null +++ b/pages.pl/openbsd/chpass.md @@ -0,0 +1,21 @@ +# chpass + +> Dodaj lub zmień informacje o użytkowniku w bazie danych, w tym powłoki logowania i hasła. +> Zobacz także: `passwd`. +> Więcej informacji: . + +- Interaktywnie ustaw określoną powłokę logowania dla bieżącego użytkownika: + +`doas chsh` + +- Ustaw określoną powłokę (z ang. [s]hell) logowania dla bieżącego użytkownika: + +`doas chsh -s {{ścieżka/do/powłoki}}` + +- Ustaw określoną powłokę (z ang. [s]hell) logowania dla określonego użytkownika: + +`doas chsh -s {{ścieżka/do/powłoki}} {{nazwa_użytkownika}}` + +- Określ wpis bazy danych użytkownika w formacie pliku `passwd`: + +`doas chsh -a {{nazwa_użytkownika:zaszyfrowane_hasło:uid:gid:...}}` diff --git a/pages.pl/openbsd/chsh.md b/pages.pl/openbsd/chsh.md new file mode 100644 index 000000000..b9c192a7f --- /dev/null +++ b/pages.pl/openbsd/chsh.md @@ -0,0 +1,7 @@ +# chsh + +> Ta komenda jest aliasem `chpass`. + +- Pokaż dokumentację oryginalnej komendy: + +`tldr chpass` diff --git a/pages.pl/openbsd/df.md b/pages.pl/openbsd/df.md new file mode 100644 index 000000000..0c673bf1f --- /dev/null +++ b/pages.pl/openbsd/df.md @@ -0,0 +1,28 @@ +# df + +> Wyświetl przegląd wykorzystania przestrzeni dyskowej systemu plików. +> Więcej informacji: . + +- Wyświetl wszystkie systemy plików i ich wykorzystanie dysków w jednostkach 512-bajtowych: + +`df` + +- Wyświetl wszystkie systemy plików i ich wykorzystanie dysków w formie czytelnej dla człowieka (w oparciu o potęgi 1024): + +`df -h` + +- Wyświetl wszystkie systemy plików i ich wykorzystanie dysków zawierające podany plik lub katalog: + +`df {{ścieżka/do/pliku_lub_folderu}}` + +- Wyświetl statystyki dotyczące liczby wolnych i wykorzystanych [i]-węzłów: + +`df -i` + +- Użyj jednostek 1024-bajtowych do zapisu danych przestrzennych: + +`df -k` + +- Wyświetl informację w [P]rzenośny sposób: + +`df -P` diff --git a/pages.pl/openbsd/pkg_add.md b/pages.pl/openbsd/pkg_add.md new file mode 100644 index 000000000..deb38738b --- /dev/null +++ b/pages.pl/openbsd/pkg_add.md @@ -0,0 +1,17 @@ +# pkg_add + +> Instaluj/aktualizuj pakiety w OpenBSD. +> Zobacz także: `pkg_info`, `pkg_delete`. +> Więcej informacji: . + +- Zaktualizuj wszystkie pakiety, w tym zależności: + +`pkg_add -u` + +- Zainstaluj nowy pakiet: + +`pkg_add {{pakiet}}` + +- Zainstaluj pakiety z surowego wyjścia `pkg_info`: + +`pkg_add -l {{ścieżka/do/pliku}}` diff --git a/pages.pl/openbsd/pkg_delete.md b/pages.pl/openbsd/pkg_delete.md new file mode 100644 index 000000000..1c99fd74d --- /dev/null +++ b/pages.pl/openbsd/pkg_delete.md @@ -0,0 +1,17 @@ +# pkg_delete + +> Usuwaj pakiety w OpenBSD. +> Zobacz także: `pkg_add`, `pkg_info`. +> Więcej informacji: . + +- Usuń pakiet: + +`pkg_delete {{pakiet}}` + +- Usuń pakiet wraz z jego nieużywanymi zależnościami: + +`pkg_delete -a {{pakiet}}` + +- Usuń pakiet "na sucho": + +`pkg_delete -n {{pakiet}}` diff --git a/pages.pl/openbsd/pkg_info.md b/pages.pl/openbsd/pkg_info.md new file mode 100644 index 000000000..008028139 --- /dev/null +++ b/pages.pl/openbsd/pkg_info.md @@ -0,0 +1,13 @@ +# pkg_info + +> Wyświetl informację o pakietach w OpenBSD. +> Zobacz także: `pkg_add`, `pkg_delete`. +> Więcej informacji: . + +- Wyszukaj pakiet, używając jego nazwy: + +`pkg_info -Q {{pakiet}}` + +- Wyświetl listę zainstalowanych pakietów do użycia z `pkg_add -l`: + +`pkg_info -mz` diff --git a/pages.pl/openbsd/sed.md b/pages.pl/openbsd/sed.md new file mode 100644 index 000000000..e2ae61c3a --- /dev/null +++ b/pages.pl/openbsd/sed.md @@ -0,0 +1,29 @@ +# sed + +> Edytuj tekst w sposób skryptowalny. +> Zobacz także: `awk`, `ed`. +> Więcej informacji: . + +- Zastąp wszystkie wystąpienia `jabłko` (podstawowe wyrażenie regularne) przez `mango` (podstawowe wyrażenie regularne) we wszystkich liniach wejściowych i wypisz wynik do `stdout`: + +`{{komenda}} | sed 's/jabłko/mango/g'` + +- Wykonaj określony plik (z ang. [f]ile) skryptu i wypisz jego wynik do `stdout`: + +`{{komenda}} | sed -f {{ścieżka/do/skryptu.sed}}` + +- Opóźnij otwarcie każdego pliku do momentu, gdy polecenie zawierające powiązaną funkcję lub flagę `w` zostanie zastosowane do linii wejścia: + +`{{komenda}} | sed -fa {{ścieżka/do/skryptu.sed}}` + +- Zastąp wszystkie wystąpienia `jabłko` (rozszerzone wyrażenie regularne) przez `JABŁKO` (rozszerzone wyrażenie regularne) we wszystkich liniach wejściowych i wypisz wynik do `stdout`: + +`{{komenda}} | sed -E 's/(jabłko)/\U\1/g'` + +- Wypisz tylko pierwszą linię do `stdout`: + +`{{komenda}} | sed -n '1p'` + +- Zastąp wszystkie wystąpienia `jabłko` (podstawowe wyrażenie regularne) przez `mango` (podstawowe wyrażenie regularne) w określonym pliku i nadpisz oryginalny plik: + +`sed -i 's/jabłko/mango/g' {{ścieżka/do/pliku}}` diff --git a/pages.pl/osx/date.md b/pages.pl/osx/date.md index 8bd60300a..9efa9a78d 100644 --- a/pages.pl/osx/date.md +++ b/pages.pl/osx/date.md @@ -17,4 +17,4 @@ - Wyświetl określoną datę jako znacznik czasu Unix w domyślnym formacie: -`date -r 1473305798` +`date -r {{1473305798}}` diff --git a/pages.pl/osx/xsand.md b/pages.pl/osx/xsand.md new file mode 100644 index 000000000..b2475313c --- /dev/null +++ b/pages.pl/osx/xsand.md @@ -0,0 +1,9 @@ +# xsand + +> Demon zarządzający systemem plików Xsan. Zapewnia usługi dla systemu plików Xsan. +> Nie powinien być wywoływany ręcznie. +> Więcej informacji: . + +- Uruchom demona: + +`xsand` diff --git a/pages.pl/osx/xsltproc.md b/pages.pl/osx/xsltproc.md new file mode 100644 index 000000000..aec522794 --- /dev/null +++ b/pages.pl/osx/xsltproc.md @@ -0,0 +1,12 @@ +# xsltproc + +> Przekształć XML z XSLT w celu uzyskania wyjścia (zwykle HTML lub XML). +> Więcej informacji: . + +- Przekształć plik XML za pomocą określonego arkusza stylów XSLT: + +`xsltproc --output {{ścieżka/do/pliku_wyjścia.html}} {{ścieżka/do/arkusza_stylów.xslt}} {{ścieżka/do/pliku.xml}}` + +- Przekaż wartość do parametru w arkuszu stylów: + +`xsltproc --output {{ścieżka/do/pliku_wyjścia.html}} --stringparam "{{nazwa}}" "{{wartość}}" {{ścieżka/do/arkusza_stylów.xslt}} {{ścieżka/do/pliku.xml}}` diff --git a/pages.pl/osx/yaa.md b/pages.pl/osx/yaa.md new file mode 100644 index 000000000..a838aa848 --- /dev/null +++ b/pages.pl/osx/yaa.md @@ -0,0 +1,28 @@ +# yaa + +> Twórz i manipuluj archiwami YAA. +> Więcej informacji: . + +- Utwórz archiwum z katalogu: + +`yaa archive -d {{ścieżka/do/katalogu}} -o {{ścieżka/do/pliku_wyjścia.yaa}}` + +- Utwórz archiwum z pliku: + +`yaa archive -i {{ścieżka/do/pliku}} -o {{ścieżka/do/pliku_wyjścia.yaa}}` + +- Wypakuj archiwum do obecnego folderu: + +`yaa extract -i {{ścieżka/do/pliku_archiwum.yaa}}` + +- Wyświetl zawartość archiwum: + +`yaa list -i {{ścieżka/do/pliku_archiwum.yaa}}` + +- Utwórz archiwum z określonym algorytmem kompresji: + +`yaa archive -a {{algorytm}} -d {{ścieżka/do/folderu}} -o {{ścieżka/do/pliku_wyjścia.yaa}}` + +- Utwórz archiwum o rozmiarze bloku 8 MB: + +`yaa archive -b 8m -d {{ścieżka/do/folderu}} -o {{ścieżka/do/pliku_wyjścia.yaa}}` diff --git a/pages.pl/osx/yabai.md b/pages.pl/osx/yabai.md new file mode 100644 index 000000000..11de6ca0b --- /dev/null +++ b/pages.pl/osx/yabai.md @@ -0,0 +1,24 @@ +# yabai + +> Kafelkowy menedżer okien dla macOS oparty na partycjonowaniu przestrzeni binarnej. +> Więcej informacji: . + +- Wyślij wiado[m]ość konfiguracyjną w celu ustawienia układu: + +`yabai -m config layout {{bsp|stack|float}}` + +- Ustaw odstęp między oknami w pt: + +`yabai -m config window_gap {{10}}` + +- Włącz nieprzezroczystość: + +`yabai -m config window_opacity on` + +- Wyłącz cienie okien: + +`yabai -m config window_shadow off` + +- Włącz pasek stanu: + +`yabai -m config status_bar on` diff --git a/pages.pl/sunos/devfsadm.md b/pages.pl/sunos/devfsadm.md new file mode 100644 index 000000000..4eb9961ac --- /dev/null +++ b/pages.pl/sunos/devfsadm.md @@ -0,0 +1,16 @@ +# devfsadm + +> Komenda administracyjna dla `/dev`. Zarządza przestrzenią nazw `/dev`. +> Więcej informacji: . + +- Skanuj w poszukiwaniu nowych dysków: + +`devfsadm -c disk` + +- Wyczyść wszystkie wiszące linki /dev i skanuj w poszukiwaniu nowego urządzenia: + +`devfsadm -C -v` + +- Próbne uruchomienie - wypisz to, co zostanie zmienione, ale bez wprowadzania modyfikacji: + +`devfsadm -C -v -n` diff --git a/pages.pl/sunos/dmesg.md b/pages.pl/sunos/dmesg.md new file mode 100644 index 000000000..7e54d88a3 --- /dev/null +++ b/pages.pl/sunos/dmesg.md @@ -0,0 +1,16 @@ +# dmesg + +> Wypisz komunikaty jądra do `stdout`. +> Więcej informacji: . + +- Wyświetl komunikaty jądra: + +`dmesg` + +- Pokaż ilość pamięci fizycznej dostępnej w systemie: + +`dmesg | grep -i memory` + +- Wyświetl komunikaty jądra po 1 stronie naraz: + +`dmesg | less` diff --git a/pages.pl/sunos/prctl.md b/pages.pl/sunos/prctl.md new file mode 100644 index 000000000..1045865b6 --- /dev/null +++ b/pages.pl/sunos/prctl.md @@ -0,0 +1,16 @@ +# prctl + +> Pobieraj lub ustawiaj kontrolę zasobów uruchomionych procesów, zadań i projektów. +> Więcej informacji: . + +- Sprawdź limity procesów i uprawnienia: + +`prctl {{pid}}` + +- Sprawdź limity procesów i uprawnienia w formacie przetwarzalnym przez maszynę: + +`prctl -P {{pid}}` + +- Uzyskaj określony limit dla uruchomionego procesu: + +`prctl -n process.max-file-descriptor {{pid}}` diff --git a/pages.pl/sunos/prstat.md b/pages.pl/sunos/prstat.md new file mode 100644 index 000000000..d427af588 --- /dev/null +++ b/pages.pl/sunos/prstat.md @@ -0,0 +1,24 @@ +# prstat + +> Raportuj statystyki aktywnego procesu. +> Więcej informacji: . + +- Sprawdź wszystkie procesy i raportuj statystyki posortowane według użycia procesora: + +`prstat` + +- Sprawdź wszystkie procesy i raportuj statystyki posortowane według użycia pamięci: + +`prstat -s rss` + +- Raportuj podsumowanie całkowitego użycia dla każdego użytkownika: + +`prstat -t` + +- Raportuj informacje o pomiarach procesu mikrostanu: + +`prstat -m` + +- Wypisz 5 najbardziej obciążających procesor procesów co sekundę: + +`prstat -c -n 5 -s cpu 1` diff --git a/pages.pl/sunos/snoop.md b/pages.pl/sunos/snoop.md new file mode 100644 index 000000000..278fc9546 --- /dev/null +++ b/pages.pl/sunos/snoop.md @@ -0,0 +1,25 @@ +# snoop + +> Sniffer pakietów sieciowych. +> Odpowiednik tcpdump w systemie SunOS. +> Więcej informacji: . + +- Przechwyć pakiety na określonym interfejsie sieciowym: + +`snoop -d {{e1000g0}}` + +- Zapisz przechwycone pakiety w pliku zamiast ich wyświetlania: + +`snoop -o {{ścieżka/do/pliku}}` + +- Wyświetl szczegółowe podsumowanie warstwy protokołu pakietów z pliku: + +`snoop -V -i {{ścieżka/do/pliku}}` + +- Przechwyć pakiety sieciowe, które pochodzą z nazwy hosta i trafiają na dany port: + +`snoop to port {{port}} from host {{nazwa_hosta}}` + +- Przechwyć i wyświetl zrzut heksadecymalny pakietów sieciowych wymienianych między dwoma adresami IP: + +`snoop -x0 -p4 {{ip1}} {{ip2}}` diff --git a/pages.pl/sunos/svcadm.md b/pages.pl/sunos/svcadm.md new file mode 100644 index 000000000..9ef6bd2ab --- /dev/null +++ b/pages.pl/sunos/svcadm.md @@ -0,0 +1,24 @@ +# svcadm + +> Manipuluj instancjami usług. +> Więcej informacji: . + +- Włącz usługę w bazie danych usług: + +`svcadm enable {{nazwa_usługi}}` + +- Wyłącz usługę: + +`svcadm disable {{nazwa_usługi}}` + +- Ponownie uruchom aktywną usługę: + +`svcadm restart {{nazwa_usługi}}` + +- Ponownie odczytaj pliki konfiguracyjne: + +`svcadm refresh {{nazwa_usługi}}` + +- Usuń usługę ze stanu konserwacji i ją uruchom: + +`svcadm clear {{nazwa_usługi}}` diff --git a/pages.pl/sunos/svccfg.md b/pages.pl/sunos/svccfg.md new file mode 100644 index 000000000..070e6c5a6 --- /dev/null +++ b/pages.pl/sunos/svccfg.md @@ -0,0 +1,16 @@ +# svccfg + +> Importuj, eksportuj i modyfikuj konfigurację usług. +> Więcej informacji: . + +- Sprawdź poprawność pliku konfiguracyjnego: + +`svccfg validate {{ścieżka/do/pliku_smf.xml}}` + +- Eksportuj konfigurację usług do pliku: + +`svccfg export {{nazwa_usługi}} > {{ścieżka/do/pliku_smf.xml}}` + +- Importuj/aktualizuj konfigurację usług z pliku: + +`svccfg import {{ścieżka/do/pliku_smf.xml}}` diff --git a/pages.pl/sunos/svcs.md b/pages.pl/sunos/svcs.md new file mode 100644 index 000000000..0b870c925 --- /dev/null +++ b/pages.pl/sunos/svcs.md @@ -0,0 +1,24 @@ +# svcs + +> Wyświetl informację o uruchomionych usługach. +> Więcej informacji: . + +- Wyświetl wszystkie uruchomione usługi: + +`svcs` + +- Wyświetl wszystkie usługi, które nie są uruchomione: + +`svcs -vx` + +- Wyświetl informację o usłudze: + +`svcs apache` + +- Pokaż lokalizację pliku dziennika usługi: + +`svcs -L apache` + +- Wyświetl koniec pliku dziennika usługi: + +`tail $(svcs -L apache)` diff --git a/pages.pl/sunos/truss.md b/pages.pl/sunos/truss.md new file mode 100644 index 000000000..3988d314d --- /dev/null +++ b/pages.pl/sunos/truss.md @@ -0,0 +1,25 @@ +# truss + +> Narzędzie do rozwiązywania problemów poprzez śledzenie wywołań systemowych. +> Odpowiednik strace w SunOS. +> Więcej informacji: . + +- Rozpocznij śledzenie programu, wykonując go i śledząc wszystkie procesy potomne: + +`truss -f {{program}}` + +- Rozpocznij śledzenie określonego procesu według jego PID: + +`truss -p {{pid}}` + +- Rozpocznij śledzenie programu, wykonując go, pokazując argumenty i zmienne środowiskowe: + +`truss -a -e {{program}}` + +- Zlicz czas, wywołania i błędy dla każdego wywołania systemowego i raportuj podsumowanie po zakończeniu programu: + +`truss -c -p {{pid}}` + +- Śledź proces filtrując dane wyjściowe według wywołania systemowego: + +`truss -p {{pid}} -t {{nazwa_wywolania_systemowego}}` diff --git a/pages.pt_BR/android/bugreportz.md b/pages.pt_BR/android/bugreportz.md index 4f0a02844..962b7a3da 100644 --- a/pages.pt_BR/android/bugreportz.md +++ b/pages.pt_BR/android/bugreportz.md @@ -1,10 +1,10 @@ # bugreportz -> Gera um relatório de bugs do Android em formato .zip. +> Gera um relatório de bugs do Android em formato Zip. > Esse comando só pode ser utilizado por meio de `adb shell`. > Mais informações: . -- Mostra um relatório completo de bugs de um dispositivo Android em formato .zip: +- Mostra um relatório completo de bugs de um dispositivo Android em formato Zip: `bugreportz` diff --git a/pages.pt_BR/android/logcat.md b/pages.pt_BR/android/logcat.md index 8cc2fb31b..6747078f5 100644 --- a/pages.pt_BR/android/logcat.md +++ b/pages.pt_BR/android/logcat.md @@ -17,8 +17,8 @@ - Exibe logs para um PID específico: -`logcat --pid={{pid}}` +`logcat --pid {{pid}}` - Exibe logs de processo de um pacote específico: -`logcat --pid=$(pidof -s {{pacote}})` +`logcat --pid $(pidof -s {{pacote}})` diff --git a/pages.pt_BR/common/2to3.md b/pages.pt_BR/common/2to3.md index 92bebf889..0dd0ec4e2 100644 --- a/pages.pt_BR/common/2to3.md +++ b/pages.pt_BR/common/2to3.md @@ -13,11 +13,11 @@ - Converte recurso específico de Python 2 para Python 3: -`2to3 --write {{caminho/para/arquivo.py}} --fix={{raw_input}} --fix={{print}}` +`2to3 --write {{caminho/para/arquivo.py}} --fix {{raw_input}} --fix {{print}}` - Converte todos os recursos de Python 2 para Python 3, exceto as que específicadas: -`2to3 --write {{caminho/para/arquivo.py}} --nofix={{has_key}} --nofix={{isinstance}}` +`2to3 --write {{caminho/para/arquivo.py}} --nofix {{has_key}} --nofix {{isinstance}}` - Mostra a lista de todas os recursos disponíveis que podem ser convertidas de Python 2 para Python 3: @@ -25,8 +25,8 @@ - Converte todos os arquivos feitos em Python 2 em um diretório para Python 3: -`2to3 --output-dir={{caminho/para/arquivos_python3}} --write-unchanged-files --nobackups {{caminho/para/arquivos_python2}}` +`2to3 --output-dir {{caminho/para/arquivos_python3}} --write-unchanged-files --nobackups {{caminho/para/arquivos_python2}}` - Executa 2to3 com múltiplas threads: -`2to3 --processes={{4}} --output-dir={{caminho/para/arquivos_python3}} --write --nobackups --no-diff {{caminho/para/arquivos_python2}}` +`2to3 --processes {{4}} --output-dir {{caminho/para/arquivos_python3}} --write --nobackups --no-diff {{caminho/para/arquivos_python2}}` diff --git a/pages.pt_BR/common/7z.md b/pages.pt_BR/common/7z.md index e94836bc6..ad7c05e7d 100644 --- a/pages.pt_BR/common/7z.md +++ b/pages.pt_BR/common/7z.md @@ -33,4 +33,4 @@ - Define o nível de compressão (maior significa mais compressão, porém mais lento): -`7z a {{caminho/para/arquivo_compactado.7z}} -mx={{0|1|3|5|7|9}} {{caminho/para/arquivo_ou_diretório}}` +`7z a {{caminho/para/arquivo_compactado.7z}} -mx {{0|1|3|5|7|9}} {{caminho/para/arquivo_ou_diretório}}` diff --git a/pages.pt_BR/common/7za.md b/pages.pt_BR/common/7za.md index 836c82574..1e6e09636 100644 --- a/pages.pt_BR/common/7za.md +++ b/pages.pt_BR/common/7za.md @@ -10,7 +10,7 @@ - Criptografa um arquivo existente (incluindo cabeçalhos): -`7za a {{caminho/para/arquivo_criptografado.7z}} -p{{senha}} -mhe={{on}} {{caminho/para/arquivo_compactado.7z}}` +`7za a {{caminho/para/arquivo_criptografado.7z}} -p{{senha}} -mhe {{on}} {{caminho/para/arquivo_compactado.7z}}` - Descompacta um arquivo mantendo a estrutura de diretórios original: diff --git a/pages.pt_BR/common/7zr.md b/pages.pt_BR/common/7zr.md index f141ecdaa..85be3751a 100644 --- a/pages.pt_BR/common/7zr.md +++ b/pages.pt_BR/common/7zr.md @@ -1,7 +1,7 @@ # 7zr > Um compactador de arquivos com alta taxa de compressão. -> Versão do `7z` com suporte apenas para o formato `.7z`. +> Versão do `7z` com suporte apenas para o formato 7z. > Mais informações: . - Compacta um arquivo ou diretório: @@ -10,7 +10,7 @@ - Criptografa um arquivo existente (incluindo cabeçalhos): -`7zr a {{arquivo_criptografado.7z}} -p{{senha}} -mhe={{on}} {{caminho/para/arquivo_compactado.7z}}` +`7zr a {{arquivo_criptografado.7z}} -p{{senha}} -mhe {{on}} {{caminho/para/arquivo_compactado.7z}}` - Descompacta um arquivo mantendo a estrutura de diretórios original: @@ -30,4 +30,4 @@ - Define o nível de compressão (maior significa mais compressão, porém mais lento): -`7zr a {{caminho/para/arquivo_compactado.7z}} -mx={{0|1|3|5|7|9}} {{caminho/para/diretório}}` +`7zr a {{caminho/para/arquivo_compactado.7z}} -mx {{0|1|3|5|7|9}} {{caminho/para/diretório}}` diff --git a/pages.pt_BR/common/alacritty.md b/pages.pt_BR/common/alacritty.md index 590cf7bb0..4d992fc03 100644 --- a/pages.pt_BR/common/alacritty.md +++ b/pages.pt_BR/common/alacritty.md @@ -15,10 +15,10 @@ `alacritty -e {{comando}}` -- Especifica um arquivo de configuração alternativo (`$XDG_CONFIG_HOME/alacritty/alacritty.yml` por padrão): +- Especifica um arquivo de configuração alternativo (`$XDG_CONFIG_HOME/alacritty/alacritty.toml` por padrão): -`alacritty --config-file {{caminho/para/config.yml}}` +`alacritty --config-file {{caminho/para/config.toml}}` -- Executa com configuração ao vivo habilitada (pode também ser habilitada por padrão no `alacritty.yml`): +- Executa com configuração ao vivo habilitada (pode também ser habilitada por padrão no `alacritty.toml`): -`alacritty --live-config-reload --config-file {{caminho/para/config.yml}}` +`alacritty --live-config-reload --config-file {{caminho/para/config.toml}}` diff --git a/pages.pt_BR/common/amass.md b/pages.pt_BR/common/amass.md index 1ef6b9233..025c7babd 100644 --- a/pages.pt_BR/common/amass.md +++ b/pages.pt_BR/common/amass.md @@ -1,20 +1,20 @@ # amass > Ferramenta de Attack Surface Mapping (mapeamento de superfície de ataque) e Asset Discovery (descoberta de asset) em profundidade. -> Alguns subcomandos como `amass db` tem sua propria documentacao de uso. -> Mais informações: . +> Alguns subcomandos como `amass intel` tem sua propria documentacao de uso. +> Mais informações: . - Executa um subcomando Amass: -`amass {{subcomando}}` +`amass {{intel|enum}} {{options}}` - Mostra ajuda geral: `amass -help` -- Mostra ajuda de um subcomando Amass (como `intel`, `enum`, etc.): +- Mostra ajuda de um subcomando Amass: -`amass -help {{subcomando}}` +`amass {{intel|enum}} -help` - Mostra a versão: diff --git a/pages.pt_BR/common/asciidoctor.md b/pages.pt_BR/common/asciidoctor.md index 51cac26a0..bb450f84a 100644 --- a/pages.pt_BR/common/asciidoctor.md +++ b/pages.pt_BR/common/asciidoctor.md @@ -9,7 +9,7 @@ - Converte um arquivo `.adoc` em HTML e liga a uma folha de estilos CSS: -`asciidoctor -a stylesheet={{caminho/para/estilos.css}} {{caminho/para/arquivo.adoc}}` +`asciidoctor -a stylesheet {{caminho/para/estilos.css}} {{caminho/para/arquivo.adoc}}` - Converte um arquivo `.adoc` em um HTML embutível, removendo tudo exceto o corpo: @@ -17,4 +17,4 @@ - Converte um arquivo `.adoc` em PDF usando a biblioteca `asciidoctor-pdf`: -`asciidoctor --backend={{pdf}} --require={{asciidoctor-pdf}} {{caminho/para/arquivo.adoc}}` +`asciidoctor --backend {{pdf}} --require {{asciidoctor-pdf}} {{caminho/para/arquivo.adoc}}` diff --git a/pages.pt_BR/common/autossh.md b/pages.pt_BR/common/autossh.md index c00be946c..ea0fc60e3 100644 --- a/pages.pt_BR/common/autossh.md +++ b/pages.pt_BR/common/autossh.md @@ -1,7 +1,7 @@ # autossh > Executa, monitora e reinicia conexões SSH. -> Reconecta automaticamente para manter os túneis de redirecionamento de porta ativos. Aceita todas as flags do `ssh`. +> Reconecta automaticamente para manter os túneis de redirecionamento de porta ativos. Aceita todas as flags do SSH. > Mais informações: . - Inicia uma sessão SSH, reiniciando quando uma porta de monitoramento falhar em retornar dados: @@ -12,7 +12,7 @@ `autossh -M {{porta_de_monitoramento}} -L {{porta_local}}:localhost:{{porta_remota}} {{usuário}}@{{host}}` -- Executa o `autossh` em segundo plano antes de executar o `ssh` e não abrir um shell remoto: +- Executa o `autossh` em segundo plano antes de executar o SSH e não abrir um shell remoto: `autossh -f -M {{porta_de_monitoramento}} -N "{{comando_ssh}}"` @@ -24,6 +24,6 @@ `autossh -f -M 0 -N -o "ServerAliveInterval 10" -o "ServerAliveCountMax 3" -o ExitOnForwardFailure=yes -L {{porta_local}}:localhost:{{porta_remota}} {{usuário}}@{{host}}` -- Executa em segundo plano, registrando a saída de depuração do `autossh` e a saída detalhada do `ssh` em arquivos: +- Executa em segundo plano, registrando a saída de depuração do `autossh` e a saída detalhada do SSH em arquivos: `AUTOSSH_DEBUG=1 AUTOSSH_LOGFILE={{caminho/para/arquivo_de_log_do_autossh.log}} autossh -f -M {{porta_de_monitoramento}} -v -E {{caminho/para/arquivo_de_log_do_ssh.log}} {{comando_ssh}}` diff --git a/pages.pt_BR/common/aws-ecr.md b/pages.pt_BR/common/aws-ecr.md index b9cd97deb..050b0176b 100644 --- a/pages.pt_BR/common/aws-ecr.md +++ b/pages.pt_BR/common/aws-ecr.md @@ -3,7 +3,7 @@ > Enviar, buscar, e gerenciar imagens de container. > Mais informações: . -- Autentica o docker com o registro default (nome do usuário na AWS): +- Autentica o Docker com o registro default (nome do usuário na AWS): `aws ecr get-login-password --region {{region}} | {{docker login}} --username AWS --password-stdin {{aws_account_id}}.dkr.ecr.{{region}}.amazonaws.com` diff --git a/pages.pt_BR/common/bc.md b/pages.pt_BR/common/bc.md index 9e4112851..c1480d538 100644 --- a/pages.pt_BR/common/bc.md +++ b/pages.pt_BR/common/bc.md @@ -2,7 +2,7 @@ > Uma linguagem de calculadora de precisão arbitrária. > Veja também: `dc`. -> Mais informações: . +> Mais informações: . - Inicia uma sessão interativa: diff --git a/pages.pt_BR/common/cabal.md b/pages.pt_BR/common/cabal.md index 18099ca67..227d35e29 100644 --- a/pages.pt_BR/common/cabal.md +++ b/pages.pt_BR/common/cabal.md @@ -2,7 +2,7 @@ > Interface de linha de comando para a infraestrutura de pacote Haskel (Cabal). > Gerencia projetos Haskell e pacotes Cabal do repositório de pacotes Hackage. -> Mais informações: . +> Mais informações: . - Busca e lista pacotes do Hackage: diff --git a/pages.pt_BR/common/cargo-test.md b/pages.pt_BR/common/cargo-test.md index 572860d0b..3816ce9e6 100644 --- a/pages.pt_BR/common/cargo-test.md +++ b/pages.pt_BR/common/cargo-test.md @@ -9,7 +9,7 @@ - Define o número de casos de teste para execução simultânea: -`cargo test -- --test-threads={{quantidade}}` +`cargo test -- --test-threads {{quantidade}}` - Executa os testes garantindo que o `Cargo.lock` esteja atualizado: diff --git a/pages.pt_BR/common/cat.md b/pages.pt_BR/common/cat.md index 6324877c4..813fee520 100644 --- a/pages.pt_BR/common/cat.md +++ b/pages.pt_BR/common/cat.md @@ -1,7 +1,7 @@ # cat > Exibe e concatena o conteúdo de arquivos. -> Mais informações: . +> Mais informações: . - Exibe o conteúdo de um arquivo na `stdout`: diff --git a/pages.pt_BR/common/chown.md b/pages.pt_BR/common/chown.md index c43384ce1..450c2d187 100644 --- a/pages.pt_BR/common/chown.md +++ b/pages.pt_BR/common/chown.md @@ -21,4 +21,4 @@ - Muda o dono de um arquivo/diretório para ficar igual a um arquivo de referência: -`chown --reference={{caminho/para/arquivo_de_referencia}} {{caminho/para/arquivo_ou_diretorio}}` +`chown --reference {{caminho/para/arquivo_de_referencia}} {{caminho/para/arquivo_ou_diretorio}}` diff --git a/pages.pt_BR/common/chromium.md b/pages.pt_BR/common/chromium.md index 98651f113..e914b5eff 100644 --- a/pages.pt_BR/common/chromium.md +++ b/pages.pt_BR/common/chromium.md @@ -17,7 +17,7 @@ - Abre no modo aplicativo (Sem barra de tarefas, barra de URL, botões, etc.): -`chromium --app={{https://exemplo.com}}` +`chromium --app {{https://exemplo.com}}` - Usa um servidor proxy: @@ -25,11 +25,11 @@ - Abre com um diretório de perfil customizado: -`chromium --user-data-dir={{caminho/para/arquivo}}` +`chromium --user-data-dir {{caminho/para/arquivo}}` - Abre sem validação CORS (útil para testar uma API): -`chromium --user-data-dir={{caminho/para/arquivo}} --disable-web-security` +`chromium --user-data-dir {{caminho/para/arquivo}} --disable-web-security` - Abre com uma janela DevTools para cada aba aberta: diff --git a/pages.pt_BR/common/clamav.md b/pages.pt_BR/common/clamav.md index 9c8a5a284..b051c454d 100644 --- a/pages.pt_BR/common/clamav.md +++ b/pages.pt_BR/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > Programa antivírus de código aberto. > O ClamAV não é um comando, mas um conjunto de comandos. diff --git a/pages.pt_BR/common/convert.md b/pages.pt_BR/common/convert.md deleted file mode 100644 index d1a5328f6..000000000 --- a/pages.pt_BR/common/convert.md +++ /dev/null @@ -1,28 +0,0 @@ -# convert - -> Ferramenta de conversão de imagens da ImageMagick. -> Mais informações: . - -- Converte uma imagem do formato JPG para o formato PNG: - -`convert {{imagem.jpg}} {{imagem.png}}` - -- Escala uma imagem para 50% do seu tamanho original: - -`convert {{imagem.png}} -resize 50% {{nova_imagem.png}}` - -- Escala uma imagem, mantendo as suas proporções originais, para uma dimensão máxima de 640x480: - -`convert {{imagem.png}} -resize 640x480 {{nova_imagem.png}}` - -- Junta várias imagens horizontalmente: - -`convert {{imagem1.png}} {{imagem2.png}} {{imagem3.png}} +append {{nova_imagem.png}}` - -- Cria um GIF a partir de uma série de imagens, com um intervalo de 100ms entre elas: - -`convert {{imagem1.png}} {{imagem2.png}} {{imagem3.png}} -delay {{100}} {{nova_imagem.gif}}` - -- Cria uma nova imagem de tamanho 800x600 com apenas um fundo sólido vermelho: - -`convert -size {{800x600}} "xc:{{#ff0000}}" {{imagem.png}}` diff --git a/pages.pt_BR/common/cut.md b/pages.pt_BR/common/cut.md index 31de651c7..b45116954 100644 --- a/pages.pt_BR/common/cut.md +++ b/pages.pt_BR/common/cut.md @@ -5,12 +5,12 @@ - Imprime um intervalo específico de caracteres/campos de cada linha: -`{{comando}} | cut --{{characters|fields}}={{1|1,10|1-10|1-|-10}}` +`{{comando}} | cut --{{characters|fields}} {{1|1,10|1-10|1-|-10}}` - Imprime um intervalo de campos de cada linha com um delimitador específico: -`{{comando}} | cut --delimiter="{{,}}" --fields={{1}}` +`{{comando}} | cut --delimiter "{{,}}" --fields {{1}}` - Imprime um intervalo de caracteres de cada linha de um arquivo específico: -`cut --characters={{1}} {{caminho/para/arquivo}}` +`cut --characters {{1}} {{caminho/para/arquivo}}` diff --git a/pages.pt_BR/common/date.md b/pages.pt_BR/common/date.md index 77ec312bf..d96df73c8 100644 --- a/pages.pt_BR/common/date.md +++ b/pages.pt_BR/common/date.md @@ -25,7 +25,7 @@ - Exibe a data atual usando o formato RFC-3339 (`YYYY-MM-DD hh:mm:ss TZ`): -`date --rfc-3339=s` +`date --rfc-3339 s` - Define a data atual usando o formato `MMDDhhmmYYYY.ss` (`YYYY` e `.ss` são opcionais): diff --git a/pages.pt_BR/common/dd.md b/pages.pt_BR/common/dd.md index 12d45237a..c765116c2 100644 --- a/pages.pt_BR/common/dd.md +++ b/pages.pt_BR/common/dd.md @@ -1,32 +1,24 @@ # dd > Converte e copia um arquivo. -> Mais informações: . +> Mais informações: . -- Cria um USB drive bootável a partir de um arquivo isohybrid (como uma archlinux-xxx.iso) e mostra o progresso: +- Cria um USB drive bootável a partir de um arquivo isohybrid (como uma `archlinux-xxx.iso`) e mostra o progresso: -`dd if={{arquivo.iso}} of=/dev/{{usb_drive}} status=progress` +`dd if={{caminho/para/arquivo.iso}} of={{/dev/usb_drive}} status=progress` -- Clona um drive para outro drive com 4 MiB block, ignora erros e mostra o progresso: +- Clona um drive para outro drive com 4 MiB block e ignora erros: -`dd if=/dev/{{drive_fonte}} of=/dev/{{drive_destino}} bs=4M conv=noerror status=progress` +`dd bs=4194304 conv=noerror if={{/dev/drive_fonte}} of={{/dev/drive_destino}}` -- Gera um arquivo com 100 bytes aleatórios utilizando o kernel random driver: +- Gera um arquivo com um número específico de bytes aleatórios utilizando o kernel random driver: -`dd if=/dev/urandom of={{arquivo_random}} bs=100 count=1` +`dd bs={{100}} count={{1}} if=/dev/urandom of={{caminho/para/arquivo_random}}` - Faz o benchmark da performance de escrita de um disco: -`dd if=/dev/zero of={{arquivo_1GB}} bs=1024 count=1000000` +`dd bs={{1024}} count={{1000000}} if=/dev/zero of={{caminho/para/arquivo_1GB}}` - Gera um backup do sistema em um arquivo IMG e mostra o progresso: -`dd if=/dev/{{dispositivo_drive}} of={{caminho/para/arquivo.img}} status=progress` - -- Restaura um drive a partir de um arquivo IMG e mostra o progresso: - -`dd if={{caminho/para/arquivo.img}} of=/dev/{{dispositivo_drive}} status=progress` - -- Checa o progresso de um processo dd rodando (rode esse comando de outro shell): - -`kill -USR1 $(pgrep -x dd)` +`dd if={{/dev/dispositivo_drive}} of={{caminho/para/arquivo.img}} status=progress` diff --git a/pages.pt_BR/common/diff.md b/pages.pt_BR/common/diff.md index a796375ef..23dd70928 100644 --- a/pages.pt_BR/common/diff.md +++ b/pages.pt_BR/common/diff.md @@ -1,7 +1,7 @@ # diff > Compara diretórios e arquivos. -> Mais informações: . +> Mais informações: . - Compara arquivos (mostra as mudanças necessárias para transformar `arquivo_antigo` em `arquivo_novo`): diff --git a/pages.pt_BR/common/docker-build.md b/pages.pt_BR/common/docker-build.md index 1fa1b625c..694c654fb 100644 --- a/pages.pt_BR/common/docker-build.md +++ b/pages.pt_BR/common/docker-build.md @@ -3,19 +3,19 @@ > Cria uma imagem a partir de um Dockerfile. > Mais informações: . -- Cria uma imagem docker usando o Dockerfile no diretório atual: +- Cria uma imagem Docker usando o Dockerfile no diretório atual: `docker build .` -- Cria uma imagem docker a partir de um Dockerfile em uma URL específica: +- Cria uma imagem Docker a partir de um Dockerfile em uma URL específica: `docker build {{github.com/creack/docker-firefox}}` -- Cria uma imagem docker e cria uma etiqueta para ela: +- Cria uma imagem Docker e cria uma etiqueta para ela: `docker build --tag {{nome:etiqueta}} .` -- Cria uma imagem docker sem contexto de criação: +- Cria uma imagem Docker sem contexto de criação: `docker build --tag {{nome:etiqueta}} - < {{Dockerfile}}` @@ -23,10 +23,10 @@ `docker build --no-cache --tag {{nome:etiqueta}} .` -- Cria uma imagem docker usando um Dockerfile específico: +- Cria uma imagem Docker usando um Dockerfile específico: `docker build --file {{Dockerfile}} .` -- Cria uma imagem docker utilizando variáveis customizadas para a criação de imagens: +- Cria uma imagem Docker utilizando variáveis customizadas para a criação de imagens: `docker build --build-arg {{PROXY_DO_HTTP=http://10.20.30.2:1234}} --build-arg {{PROXY_DO_FTP=http://40.50.60.5:4567}} .` diff --git a/pages.pt_BR/common/docker-commit.md b/pages.pt_BR/common/docker-commit.md index 6a9154529..636eb5e6a 100644 --- a/pages.pt_BR/common/docker-commit.md +++ b/pages.pt_BR/common/docker-commit.md @@ -9,23 +9,23 @@ - Aplica uma instrução `CMD` do Dockerfile à imagem criada: -`docker commit --change="CMD {{comando}}" {{contêiner}} {{imagem}}:{{tag}}` +`docker commit --change "CMD {{comando}}" {{contêiner}} {{imagem}}:{{tag}}` - Aplica uma instrução `ENV` do Dockerfile à imagem criada: -`docker commit --change="ENV {{nome}}={{valor}}" {{contêiner}} {{imagem}}:{{tag}}` +`docker commit --change "ENV {{nome}}={{valor}}" {{contêiner}} {{imagem}}:{{tag}}` - Cria uma imagem com um autor específico nos metadados: -`docker commit --author="{{autor}}" {{contêiner}} {{imagem}}:{{tag}}` +`docker commit --author "{{autor}}" {{contêiner}} {{imagem}}:{{tag}}` - Cria uma imagem com um comentário específico nos metadados: -`docker commit --message="{{comentário}}" {{contêiner}} {{imagem}}:{{tag}}` +`docker commit --message "{{comentário}}" {{contêiner}} {{imagem}}:{{tag}}` - Cria uma imagem sem pausar o contêiner durante o commit: -`docker commit --pause={{false}} {{contêiner}} {{imagem}}:{{tag}}` +`docker commit --pause {{false}} {{contêiner}} {{imagem}}:{{tag}}` - Exibe ajuda: diff --git a/pages.pt_BR/common/docker-machine.md b/pages.pt_BR/common/docker-machine.md index 621abeec8..9b2fe5696 100644 --- a/pages.pt_BR/common/docker-machine.md +++ b/pages.pt_BR/common/docker-machine.md @@ -1,7 +1,7 @@ # docker-machine > Criar e gerenciar máquinas que executam o Docker. -> Mais informações: . +> Mais informações: . - Lista as máquinas Docker em execução no momento: diff --git a/pages.pt_BR/common/docker-ps.md b/pages.pt_BR/common/docker-ps.md index 9f0092d94..dc6567b58 100644 --- a/pages.pt_BR/common/docker-ps.md +++ b/pages.pt_BR/common/docker-ps.md @@ -3,11 +3,11 @@ > Lista os containers Docker. > Mais informações: . -- Lista containers docker em execução: +- Lista containers Docker em execução: `docker ps` -- Lista todos containers docker (em execução e parados): +- Lista todos containers Docker (em execução e parados): `docker ps --all` @@ -29,8 +29,8 @@ - Filtra containers por estado (criado, execução, removendo, pausado, finalizado e morto): -`docker ps --filter="status={{estado}}"` +`docker ps --filter "status={{estado}}"` - Filtra containers que contenham um volume específico ou montado em um caminho específico: -`docker ps --filter="volume={{caminho/para/diretório}}" --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Mounts}}"` +`docker ps --filter "volume={{caminho/para/diretório}}" --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Mounts}}"` diff --git a/pages.pt_BR/common/docker-start.md b/pages.pt_BR/common/docker-start.md index 9fc6404fd..1e350328e 100644 --- a/pages.pt_BR/common/docker-start.md +++ b/pages.pt_BR/common/docker-start.md @@ -7,7 +7,7 @@ `docker start` -- Inicia um container docker: +- Inicia um container Docker: `docker start {{container}}` diff --git a/pages.pt_BR/common/docker-system.md b/pages.pt_BR/common/docker-system.md index 40808551a..133284579 100644 --- a/pages.pt_BR/common/docker-system.md +++ b/pages.pt_BR/common/docker-system.md @@ -21,7 +21,7 @@ - Remove dados não utilizados criados há mais de um período específico no passado: -`docker system prune --filter="until={{horas}}h{{minutos}}m"` +`docker system prune --filter "until={{horas}}h{{minutos}}m"` - Exibe eventos em tempo real do daemon do Docker: diff --git a/pages.pt_BR/common/ect.md b/pages.pt_BR/common/ect.md index 1f8c46d3b..a5fe9fde1 100644 --- a/pages.pt_BR/common/ect.md +++ b/pages.pt_BR/common/ect.md @@ -1,7 +1,7 @@ # ect > Efficient Compression Tool. -> Otimizador de arquivos escrito em C++. Suporta arquivos do tipo `.png`, `.jpg`, `.gzip` and `.zip`. +> Otimizador de arquivos escrito em C++. Suporta arquivos do tipo PNG, JPEG, gzip and Zip. > Mais informações: . - Comprime um arquivo: diff --git a/pages.pt_BR/common/fdp.md b/pages.pt_BR/common/fdp.md index dc2a76141..8f9fc261d 100644 --- a/pages.pt_BR/common/fdp.md +++ b/pages.pt_BR/common/fdp.md @@ -4,11 +4,11 @@ > Layouts: `dot`, `neato`, `twopi`, `circo`, `fdp`, `sfdp`, `osage` & `patchwork`. > Mais informações: . -- Renderiza uma imagem `png` com um nome de arquivo baseado no nome do arquivo de entrada e formato de saída (-O maiúsculo): +- Renderiza uma imagem PNG com um nome de arquivo baseado no nome do arquivo de entrada e formato de saída (-O maiúsculo): `fdp -T png -O {{caminho/para/entrada.gv}}` -- Renderiza uma imagem `svg` com o nome do arquivo de saída especificado (-o minúsculo): +- Renderiza uma imagem SVG com o nome do arquivo de saída especificado (-o minúsculo): `fdp -T svg -o {{caminho/para/imagem.svg}} {{caminho/para/entrada.gv}}` @@ -16,7 +16,7 @@ `fdp -T {{ps|pdf|svg|fig|png|gif|jpg|json|dot}} -O {{caminho/para/entrada.gv}}` -- Renderiza uma imagem `gif` usando `stdin` e `stdout`: +- Renderiza uma imagem GIF usando `stdin` e `stdout`: `echo "{{digraph {isso -> aquilo} }}" | fdp -T gif > {{caminho/para/imagem.gif}}` diff --git a/pages.pt_BR/common/fossil-ci.md b/pages.pt_BR/common/fossil-ci.md index c9c14852d..090a0675a 100644 --- a/pages.pt_BR/common/fossil-ci.md +++ b/pages.pt_BR/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> Este comando é um apelido de `fossil-commit`. +> Este comando é um apelido de `fossil commit`. > Mais informações: . - Exibe documentação sobre o comando original: diff --git a/pages.pt_BR/common/fossil-delete.md b/pages.pt_BR/common/fossil-delete.md index c98ef0a24..736588518 100644 --- a/pages.pt_BR/common/fossil-delete.md +++ b/pages.pt_BR/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > Este comando é um apelido de `fossil rm`. > Mais informações: . diff --git a/pages.pt_BR/common/fossil-forget.md b/pages.pt_BR/common/fossil-forget.md index f2bfba716..74860d891 100644 --- a/pages.pt_BR/common/fossil-forget.md +++ b/pages.pt_BR/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > Este comando é um apelido de `fossil rm`. > Mais informações: . diff --git a/pages.pt_BR/common/fossil-new.md b/pages.pt_BR/common/fossil-new.md index 9cbf49635..5ebea5d96 100644 --- a/pages.pt_BR/common/fossil-new.md +++ b/pages.pt_BR/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> Este comando é um apelido de `fossil-init`. +> Este comando é um apelido de `fossil init`. > Mais informações: . - Exibe documentação sobre o comando original: diff --git a/pages.pt_BR/common/gcal.md b/pages.pt_BR/common/gcal.md index d4055fc41..6deb66b34 100644 --- a/pages.pt_BR/common/gcal.md +++ b/pages.pt_BR/common/gcal.md @@ -9,7 +9,7 @@ - Exibe o calendário para o mês de Fevereiro do ano de 2010: -`gcal {{2}} {{2010}}` +`gcal 2 2010` - Fornece folha de calendário com números da semana: @@ -17,7 +17,7 @@ - Altera o dia da semana de início para o 1º dia da semana (segunda-feira): -`gcal --starting-day={{1}}` +`gcal --starting-day=1` - Exibe o mês anterior, atual e seguinte em torno de hoje: diff --git a/pages.pt_BR/common/gh-cs.md b/pages.pt_BR/common/gh-cs.md index 8119c9739..6c30b7985 100644 --- a/pages.pt_BR/common/gh-cs.md +++ b/pages.pt_BR/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> Este comando é um apelido de `gh-codespace`. +> Este comando é um apelido de `gh codespace`. > Mais informações: . - Exibe documentação sobre o comando original: diff --git a/pages.pt_BR/common/git-init.md b/pages.pt_BR/common/git-init.md index 1cce19d1e..182dee4b5 100644 --- a/pages.pt_BR/common/git-init.md +++ b/pages.pt_BR/common/git-init.md @@ -15,6 +15,6 @@ `git init --object-format={{sha256}}` -- Inicializa um repositório barebones, adequado para usar como um remoto via ssh: +- Inicializa um repositório barebones, adequado para usar como um remoto via SSH: `git init --bare` diff --git a/pages.pt_BR/common/gnmic-sub.md b/pages.pt_BR/common/gnmic-sub.md index 8c674c92f..72f68953c 100644 --- a/pages.pt_BR/common/gnmic-sub.md +++ b/pages.pt_BR/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > Este comando é um apelido de `gnmic subscribe`. > Mais informações: . diff --git a/pages.pt_BR/common/grep.md b/pages.pt_BR/common/grep.md index 5ce82274e..77f9a8998 100644 --- a/pages.pt_BR/common/grep.md +++ b/pages.pt_BR/common/grep.md @@ -9,28 +9,28 @@ - Pesquisa por uma string exata (desabilita expressões regulares): -`grep --fixed-strings "{{string_exata}}" {{caminho/para/arquivo}}` +`grep {{-F|--fixed-strings}} "{{string_exata}}" {{caminho/para/arquivo}}` - Pesquisa por um padrão em todos os arquivos recursivamente em um diretório, mostrando o número das linhas das correspondências, ignorando arquivos binários: -`grep --recursive --line-number --binary-files={{without-match}} "{{padrão_pesquisado}}" {{caminho/para/diretório}}` +`grep {{-r|--recursive}} {{-n|--line-number}} --binary-files={{without-match}} "{{padrão_pesquisado}}" {{caminho/para/diretório}}` - Usa expressões regulares estendidas (suporta `?`, `+`, `{}`, `()` and `|`), no modo insensível a maiúsculas e minúsculas: -`grep --extended-regexp --ignore-case "{{padrão_pesquisado}}" {{caminho/para/arquivo}}` +`grep {{-E|--extended-regexp}} {{-i|--ignore-case}} "{{padrão_pesquisado}}" {{caminho/para/arquivo}}` - Imprime 3 linhas de contexto em volta, antes ou depois de cada correspondência: -`grep --{{context|before-context|after-context}}={{3}} "{{padrão_pesquisado}}" {{caminho/para/arquivo}}` +`grep --{{context|before-context|after-context}} 3 "{{padrão_pesquisado}}" {{caminho/para/arquivo}}` - Imprime o nome do arquivo e o número da linha para cada correspondência: -`grep --with-filename --line-number --color=always "{{padrão_pesquisado}}" {{caminho/para/arquivo}}` +`grep {{-H|--with-filename}} {{-n|--line-number}} --color=always "{{padrão_pesquisado}}" {{caminho/para/arquivo}}` - Pesquisa por linhas que correspondem a um padrão, imprimindo apenas o texto correspondido: -`grep --only-matching "{{padrão_pesquisado}}" {{caminho/para/arquivo}}` +`grep {{-o|--only-matching}} "{{padrão_pesquisado}}" {{caminho/para/arquivo}}` - Pesquisa `stdin` para linhas que não correspondem a um padrão: -`cat {{caminho/para/arquivo}} | grep --invert-match "{{padrão_pesquisado}}"` +`cat {{caminho/para/arquivo}} | grep {{-v|--invert-match}} "{{padrão_pesquisado}}"` diff --git a/pages.pt_BR/common/history.md b/pages.pt_BR/common/history.md index 5d562c907..0441a860f 100644 --- a/pages.pt_BR/common/history.md +++ b/pages.pt_BR/common/history.md @@ -7,15 +7,15 @@ `history` -- Exibe os últimos 20 comandos (em `zsh` ele exibe todos os comandos a partir do 20º): +- Exibe os últimos 20 comandos (em Zsh ele exibe todos os comandos a partir do 20º): `history {{20}}` -- Limpa a lista do histórico de comandos (apenas para o shell `bash` atual): +- Limpa a lista do histórico de comandos (apenas para o shell Bash atual): `history -c` -- Sobrescreve o arquivo de histórico com o histórico do shell `bash` atual (frequentemente combinado com `history -c` para limpar o histórico): +- Sobrescreve o arquivo de histórico com o histórico do shell Bash atual (frequentemente combinado com `history -c` para limpar o histórico): `history -w` diff --git a/pages.pt_BR/common/magick-convert.md b/pages.pt_BR/common/magick-convert.md new file mode 100644 index 000000000..c7fe46bd8 --- /dev/null +++ b/pages.pt_BR/common/magick-convert.md @@ -0,0 +1,28 @@ +# magick convert + +> Ferramenta de conversão de imagens da ImageMagick. +> Mais informações: . + +- Converte uma imagem do formato JPEG para o formato PNG: + +`magick convert {{imagem.jpg}} {{imagem.png}}` + +- Escala uma imagem para 50% do seu tamanho original: + +`magick convert {{imagem.png}} -resize 50% {{nova_imagem.png}}` + +- Escala uma imagem, mantendo as suas proporções originais, para uma dimensão máxima de 640x480: + +`magick convert {{imagem.png}} -resize 640x480 {{nova_imagem.png}}` + +- Junta várias imagens horizontalmente: + +`magick convert {{imagem1.png}} {{imagem2.png}} {{imagem3.png}} +append {{nova_imagem.png}}` + +- Cria um GIF a partir de uma série de imagens, com um intervalo de 100ms entre elas: + +`magick convert {{imagem1.png}} {{imagem2.png}} {{imagem3.png}} -delay {{100}} {{nova_imagem.gif}}` + +- Cria uma nova imagem de tamanho 800x600 com apenas um fundo sólido vermelho: + +`magick convert -size {{800x600}} "xc:{{#ff0000}}" {{imagem.png}}` diff --git a/pages.pt_BR/common/man.md b/pages.pt_BR/common/man.md index 74f38b2c5..74e2590cb 100644 --- a/pages.pt_BR/common/man.md +++ b/pages.pt_BR/common/man.md @@ -1,7 +1,7 @@ # man > Formata e exibe páginas de manual. -> Mais informações: . +> Mais informações: . - Exibe a página de manual de um comando: diff --git a/pages.pt_BR/common/mpv.md b/pages.pt_BR/common/mpv.md index 7a2d28dd9..f5b27fb0a 100644 --- a/pages.pt_BR/common/mpv.md +++ b/pages.pt_BR/common/mpv.md @@ -33,4 +33,4 @@ - Mostra a saída da webcam ou de outro dispositivo de entrada de vídeo: -`mpv /dev/{{video0}}` +`mpv {{/dev/video0}}` diff --git a/pages.pt_BR/common/nth.md b/pages.pt_BR/common/nth.md index c28eb5930..8856bcb70 100644 --- a/pages.pt_BR/common/nth.md +++ b/pages.pt_BR/common/nth.md @@ -11,7 +11,7 @@ `nth -f {{caminho/para/hashes}}` -- Saída no formato json: +- Saída no formato JSON: `nth -t {{5f4dcc3b5aa765d61d8327deb882cf99}} -g` diff --git a/pages.pt_BR/common/pio-init.md b/pages.pt_BR/common/pio-init.md index 9cb38460e..b70f1abcc 100644 --- a/pages.pt_BR/common/pio-init.md +++ b/pages.pt_BR/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > Este comando é um apelido de `pio project`. diff --git a/pages.pt_BR/common/rsync.md b/pages.pt_BR/common/rsync.md index 2c526cc32..ac6fea194 100644 --- a/pages.pt_BR/common/rsync.md +++ b/pages.pt_BR/common/rsync.md @@ -10,28 +10,28 @@ - Usa o modo de arquivo (copia recursivamente diretórios, copia links simbólicos sem resolver e preserva permissões, propriedade e tempos de modificação): -`rsync --archive {{caminho/para/origem}} {{caminho/para/destino}}` +`rsync {{-a|--archive}} {{caminho/para/origem}} {{caminho/para/destino}}` - Comprime os dados à medida que são enviados ao destino, exibe progresso detalhado e legível, e mantém arquivos parcialmente transferidos se forem interrompidos: -`rsync --compress --verbose --human-readable --partial --progress {{caminho/para/origem}} {{caminho/para/destino}}` +`rsync {{-zvhP|--compress --verbose --human-readable --partial --progress}} {{caminho/para/origem}} {{caminho/para/destino}}` - Copia recursivamente diretórios: -`rsync --recursive {{caminho/para/origem}} {{caminho/para/destino}}` +`rsync {{-r|--recursive}} {{caminho/para/origem}} {{caminho/para/destino}}` - Transfere os conteúdos do diretório, mas não o diretório em si: -`rsync --recursive {{caminho/para/origem}}/ {{caminho/para/destino}}` +`rsync {{-r|--recursive}} {{caminho/para/origem}}/ {{caminho/para/destino}}` - Copia diretórios, usa o modo de arquivamento, resolve links simbólicos e ignora arquivos que são mais recentes no destino: -`rsync --archive --update --copy-links {{caminho/para/origem}} {{caminho/para/destino}}` +`rsync {{-auL|--archive --update --copy-links}} {{caminho/para/origem}} {{caminho/para/destino}}` - Transfere um diretório para um host remoto executando o `rsyncd` and exclui arquivos no destino que não existem na origem: -`rsync --recursive --delete rsync://{{host}}:{{caminho/para/origem}} {{caminho/para/destino}}` +`rsync {{-r|--recursive}} --delete rsync://{{host}}:{{caminho/para/origem}} {{caminho/para/destino}}` - Transfere um arquivo por SSH usando uma porta diferente da padrão (22) e mostra o progresso global: -`rsync --rsh 'ssh -p {{porta}}' --info=progress2 {{host}}:{{caminho/para/origem}} {{caminho/para/destino}}` +`rsync {{-e|--rsh}} 'ssh -p {{porta}}' --info=progress2 {{host}}:{{caminho/para/origem}} {{caminho/para/destino}}` diff --git a/pages.pt_BR/common/sudo.md b/pages.pt_BR/common/sudo.md index 6fb54f5eb..4a1db7a6b 100644 --- a/pages.pt_BR/common/sudo.md +++ b/pages.pt_BR/common/sudo.md @@ -15,7 +15,7 @@ `sudo --user={{usuário}} --group={{grupo}} {{id -a}}` -- Executa um comando anterior com o prefixo `sudo` (apenas em `bash`, `zsh`, etc.): +- Executa um comando anterior com o prefixo `sudo` (apenas em Bash, Zsh, etc.): `sudo !!` diff --git a/pages.pt_BR/common/tlmgr-arch.md b/pages.pt_BR/common/tlmgr-arch.md index 8afde4f11..1f3e9ae1e 100644 --- a/pages.pt_BR/common/tlmgr-arch.md +++ b/pages.pt_BR/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > Este comando é um apelido de `tlmgr platform`. > Mais informações: . diff --git a/pages.pt_BR/common/tree.md b/pages.pt_BR/common/tree.md index 2f57689bb..53a5aefe9 100644 --- a/pages.pt_BR/common/tree.md +++ b/pages.pt_BR/common/tree.md @@ -1,7 +1,7 @@ # tree > Exibe o conteúdo do diretório atual em formato de árvore. -> Mais informações: . +> Mais informações: . - Exibe os arquivos e diretórios de acordo com o nível de profundidade 'num' informado (onde 1 significa o diretório atual): diff --git a/pages.pt_BR/common/virsh-connect.md b/pages.pt_BR/common/virsh-connect.md index cf9901a87..01a0ca668 100644 --- a/pages.pt_BR/common/virsh-connect.md +++ b/pages.pt_BR/common/virsh-connect.md @@ -16,6 +16,6 @@ `virsh connect qemu:///session` -- Conecta como root a um hipervisor remoto usando ssh: +- Conecta como root a um hipervisor remoto usando SSH: `virsh connect qemu+ssh://{{nome_do_usuário@nome_do_host}}/system` diff --git a/pages.pt_BR/common/virsh.md b/pages.pt_BR/common/virsh.md index fd5369481..e7504f2db 100644 --- a/pages.pt_BR/common/virsh.md +++ b/pages.pt_BR/common/virsh.md @@ -2,7 +2,7 @@ > Gerenciar domínios de convidados do virsh. (NOTA: 'guest_id' pode ser o ID, nome ou UUID do convidado). > Alguns subcomandos, como `virsh list`, têm sua própria documentação de uso. -> Mais informações: . +> Mais informações: . - Conecta a uma sessão do hipervisor: diff --git a/pages.pt_BR/common/xkill.md b/pages.pt_BR/common/xkill.md index 621f76ea2..c9a4d04c7 100644 --- a/pages.pt_BR/common/xkill.md +++ b/pages.pt_BR/common/xkill.md @@ -12,6 +12,6 @@ `xkill -button any` -- Fecha uma janela com um id específico (use `xwininfo` para obter informações sobre janelas): +- Fecha uma janela com um ID específico (use `xwininfo` para obter informações sobre janelas): `xkill -id {{id}}` diff --git a/pages.pt_BR/common/xz.md b/pages.pt_BR/common/xz.md index 77b4f3ad3..b96fc81a8 100644 --- a/pages.pt_BR/common/xz.md +++ b/pages.pt_BR/common/xz.md @@ -1,6 +1,6 @@ # xz -> Compactar ou descompactar arquivos com a extensão .xz ou .lzma. +> Compactar ou descompactar arquivos XZ ou LZMA. > Mais informações: . - Compacta um arquivo no formato xz: @@ -11,11 +11,11 @@ `xz --decompress {{caminho/para/arquivo.xz}}` -- Compacta um arquivo no formato lzma: +- Compacta um arquivo no formato LZMA: `xz --format=lzma {{caminho/para/arquivo}}` -- Descompacta um arquivo no formato lzma: +- Descompacta um arquivo no formato LZMA: `xz --decompress --format=lzma {{caminho/para/arquivo.lzma}}` diff --git a/pages.pt_BR/common/zsh.md b/pages.pt_BR/common/zsh.md index a6b7de985..d92a913f5 100644 --- a/pages.pt_BR/common/zsh.md +++ b/pages.pt_BR/common/zsh.md @@ -32,6 +32,6 @@ `zsh --verbose` -- Executa um comando específico dentro do `zsh` com padrões glob desativados: +- Executa um comando específico dentro do Zsh com padrões glob desativados: `noglob {{comando}}` diff --git a/pages.pt_BR/linux/apt-file.md b/pages.pt_BR/linux/apt-file.md index 2c0b2da5c..5060d30e4 100644 --- a/pages.pt_BR/linux/apt-file.md +++ b/pages.pt_BR/linux/apt-file.md @@ -1,6 +1,6 @@ # apt-file -> Buscador de arquivos nos pacotes apt, incluindo os não instalados. +> Buscador de arquivos nos pacotes APT, incluindo os não instalados. > Mais informações: . - Atualiza as informações dos pacotes a partir de todos os repositórios remotos: diff --git a/pages.pt_BR/linux/dconf-reset.md b/pages.pt_BR/linux/dconf-reset.md index d24153bfb..63f06d9e2 100644 --- a/pages.pt_BR/linux/dconf-reset.md +++ b/pages.pt_BR/linux/dconf-reset.md @@ -6,8 +6,8 @@ - Redefine um valor de chave específico: -`dconf read {{/caminho/para/chave}}` +`dconf reset {{/caminho/para/chave}}` - Redefine um diretório específico: -`dconf read -d {{/caminho/para/diretório/}}` +`dconf reset -f {{/caminho/para/diretório/}}` diff --git a/pages.pt_BR/linux/dockerd.md b/pages.pt_BR/linux/dockerd.md index 7c75dddc0..f73ad3b14 100644 --- a/pages.pt_BR/linux/dockerd.md +++ b/pages.pt_BR/linux/dockerd.md @@ -1,7 +1,7 @@ # dockerd > Um processo persistente para iniciar e gerenciar contêineres Docker. -> Mais informações: . +> Mais informações: . - Executa o daemon do Docker: @@ -21,4 +21,4 @@ - Executa e define um nível de log específico: -`dockerd --log-level={{debug|info|warn|error|fatal}}` +`dockerd --log-level {{debug|info|warn|error|fatal}}` diff --git a/pages.pt_BR/linux/dolphin.md b/pages.pt_BR/linux/dolphin.md index 1e3481419..5a0257a2f 100644 --- a/pages.pt_BR/linux/dolphin.md +++ b/pages.pt_BR/linux/dolphin.md @@ -23,7 +23,7 @@ `dolphin --split {{caminho/para/diretorio1}} {{caminho/para/diretorio2}}` -- Inicializa o daemon do Dolphin (necessário apenas para usar a interface do DBus): +- Inicializa o daemon do Dolphin (necessário apenas para usar a interface do D-Bus): `dolphin --daemon` diff --git a/pages.pt_BR/linux/ip-route-list.md b/pages.pt_BR/linux/ip-route-list.md index 0bd6409b7..3286cbb66 100644 --- a/pages.pt_BR/linux/ip-route-list.md +++ b/pages.pt_BR/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> Este comando é um apelido de `ip-route-show`. +> Este comando é um apelido de `ip route show`. - Exibe documentação sobre o comando original: diff --git a/pages.pt_BR/linux/ip.md b/pages.pt_BR/linux/ip.md index f71d97d70..76cf6122a 100644 --- a/pages.pt_BR/linux/ip.md +++ b/pages.pt_BR/linux/ip.md @@ -2,7 +2,7 @@ > Mostra / manipula roteamento, dispositivos, roteamento baseado em póliticas e túneis. > Alguns subcomandos como `ip address` têm suas pŕoprias documentações de uso. -> Mais informações: . +> Mais informações: . - Lista interfaces com informações detalhadas: diff --git a/pages.pt_BR/linux/mkfs.fat.md b/pages.pt_BR/linux/mkfs.fat.md index 6738b9bb2..c09f187c0 100644 --- a/pages.pt_BR/linux/mkfs.fat.md +++ b/pages.pt_BR/linux/mkfs.fat.md @@ -11,7 +11,7 @@ `mkfs.fat -n {{nome_de_volume}} {{/dev/sdb1}}` -- Cria um sistema de arquivos com um id de volume: +- Cria um sistema de arquivos com um ID de volume: `mkfs.fat -i {{id_de_volume}} {{/dev/sdb1}}` diff --git a/pages.pt_BR/linux/poweroff.md b/pages.pt_BR/linux/poweroff.md index 25c12dce8..a36e426d4 100644 --- a/pages.pt_BR/linux/poweroff.md +++ b/pages.pt_BR/linux/poweroff.md @@ -1,7 +1,7 @@ # poweroff > Desliga o sistema. -> Mais informações: . +> Mais informações: . - Desliga o sistema: diff --git a/pages.pt_BR/linux/pw-cat.md b/pages.pt_BR/linux/pw-cat.md index 12e0bc313..76c187b31 100644 --- a/pages.pt_BR/linux/pw-cat.md +++ b/pages.pt_BR/linux/pw-cat.md @@ -1,6 +1,6 @@ # pw-cat -> Toca e grava arquivos de áudio através do pipewire. +> Toca e grava arquivos de áudio através do PipeWire. > Mais informações: . - Toca um arquivo WAV no alvo padrão: diff --git a/pages.pt_BR/linux/pw-cli.md b/pages.pt_BR/linux/pw-cli.md index e64d4ea98..d1bb54e00 100644 --- a/pages.pt_BR/linux/pw-cli.md +++ b/pages.pt_BR/linux/pw-cli.md @@ -1,7 +1,7 @@ # pw-cli > Gerencia módulos, objetos, nós, dispositivos, conexões e muito mais de uma instância PipeWire. -> Mais informações: . +> Mais informações: . - Exibe todos os nós (dispositivos de entrada e saída) com os seus IDs: diff --git a/pages.pt_BR/linux/pw-loopback.md b/pages.pt_BR/linux/pw-loopback.md index 038dfb999..a669d5e65 100644 --- a/pages.pt_BR/linux/pw-loopback.md +++ b/pages.pt_BR/linux/pw-loopback.md @@ -1,6 +1,6 @@ # pw-loopback -> Ferramenta para Cria dispositivos de loopback no pipewire. +> Ferramenta para Cria dispositivos de loopback no PipeWire. > Mais informações: . - Cria um dispositivo de loopback com o comportamento padrão de loopback: diff --git a/pages.pt_BR/linux/pw-play.md b/pages.pt_BR/linux/pw-play.md index e16adb713..94c2198b1 100644 --- a/pages.pt_BR/linux/pw-play.md +++ b/pages.pt_BR/linux/pw-play.md @@ -1,6 +1,6 @@ # pw-play -> Grava arquivos de áudio através do pipewire. +> Grava arquivos de áudio através do PipeWire. > Atalho para pw-cat --playback. > Mais informações: . diff --git a/pages.pt_BR/linux/pw-record.md b/pages.pt_BR/linux/pw-record.md index c65d2d1b4..972d4a5fa 100644 --- a/pages.pt_BR/linux/pw-record.md +++ b/pages.pt_BR/linux/pw-record.md @@ -1,6 +1,6 @@ # pw-record -> Grava arquivos de áudio através do pipewire. +> Grava arquivos de áudio através do PipeWire. > Atalho para pw-cat --record. > Mais informações: . diff --git a/pages.pt_BR/osx/date.md b/pages.pt_BR/osx/date.md index fae9ef3c2..474910d4e 100644 --- a/pages.pt_BR/osx/date.md +++ b/pages.pt_BR/osx/date.md @@ -17,4 +17,4 @@ - Exibe uma data específica (representada como um timestamp Unix) usando o formato padrão: -`date -r 1473305798` +`date -r {{1473305798}}` diff --git a/pages.pt_BR/osx/dd.md b/pages.pt_BR/osx/dd.md index 1b5236d08..d1ec14ffe 100644 --- a/pages.pt_BR/osx/dd.md +++ b/pages.pt_BR/osx/dd.md @@ -5,16 +5,16 @@ - Cria uma unidade USB inicializável a partir de um arquivo isohybrid (tal como `archlinux-xxx.iso`): -`dd if={{arquivo.iso}} of=/dev/{{unidade_usb}}` +`dd if={{caminho/para/arquivo.iso}} of={{/dev/unidade_usb}}` -- Clona uma unidade para outra unidade com bloco de 4 MB e ignora erro: +- Clona uma unidade para outra unidade com bloco de 4 MB e ignora qualquer erro: -`dd if=/dev/{{unidade_origem}} of=/dev/{{unidade_destino}} bs=4m conv=noerror` +`dd bs=4m conv=noerror if={{/dev/unidade_origem}} of={{/dev/unidade_destino}}` -- Gera um arquivo de 100 bytes aleatórios usando o driver aleatório do kernel: +- Gera um arquivo de número específico de bytes aleatórios usando o driver aleatório do kernel: -`dd if=/dev/urandom of={{arquivo_aleatório}} bs=100 count=1` +`dd bs={{100}} count={{1}} if=/dev/urandom of={{caminho/para/arquivo_aleatório}}` - Compara o desempenho de gravação de um disco: -`dd if=/dev/zero of={{arquivo_1GB}} bs=1024 count=1000000` +`dd bs={{1024}} count={{1000000}} if=/dev/zero of={{caminho/para/arquivo_1GB}}` diff --git a/pages.pt_BR/windows/whoami.md b/pages.pt_BR/windows/whoami.md index 479213b42..0cb5edd35 100644 --- a/pages.pt_BR/windows/whoami.md +++ b/pages.pt_BR/windows/whoami.md @@ -19,6 +19,6 @@ `whoami /upn` -- Mostra o id de logon do usuário atual: +- Mostra o ID de logon do usuário atual: `whoami /logonid` diff --git a/pages.pt_PT/android/bugreportz.md b/pages.pt_PT/android/bugreportz.md index 61232c049..97e50afb7 100644 --- a/pages.pt_PT/android/bugreportz.md +++ b/pages.pt_PT/android/bugreportz.md @@ -1,10 +1,10 @@ # bugreportz -> Gera um relatório de bugs do Android em formato .zip. +> Gera um relatório de bugs do Android em formato Zip. > Este comando só pode ser utilizado com a `adb shell`. > Mais informações: . -- Mostra um relatório completo de bugs de um dispositivo Android em formato .zip: +- Mostra um relatório completo de bugs de um dispositivo Android em formato Zip: `bugreportz` diff --git a/pages.pt_PT/common/7za.md b/pages.pt_PT/common/7za.md index b9dbaaa38..e6a2a1d90 100644 --- a/pages.pt_PT/common/7za.md +++ b/pages.pt_PT/common/7za.md @@ -10,7 +10,7 @@ - Encripta um arquivo existente (incluindo os nomes dos ficheiros): -`7za a {{caminho/para/ficheiro_encriptado.7z}} -p{{palavra-passe}} -mhe={{on}} {{caminho/para/ficheiro_compactado.7z}}` +`7za a {{caminho/para/ficheiro_encriptado.7z}} -p{{palavra-passe}} -mhe {{on}} {{caminho/para/ficheiro_compactado.7z}}` - Descompacta um arquivo mantendo a estrutura de diretórios original: diff --git a/pages.pt_PT/common/alacritty.md b/pages.pt_PT/common/alacritty.md index 059c3aff8..7339e4120 100644 --- a/pages.pt_PT/common/alacritty.md +++ b/pages.pt_PT/common/alacritty.md @@ -15,10 +15,10 @@ `alacritty -e {{comando}}` -- Define um caminho alternativo para o ficheiro de configuração (por omissão `$XDG_CONFIG_HOME/alacritty/alacritty.yml`): +- Define um caminho alternativo para o ficheiro de configuração (por omissão `$XDG_CONFIG_HOME/alacritty/alacritty.toml`): -`alacritty --config-file {{caminho/para/configuração.yml}}` +`alacritty --config-file {{caminho/para/configuração.toml}}` -- Executa com carregamento automático de configuração (pode ser definido por omissão em `alacritty.yml`): +- Executa com carregamento automático de configuração (pode ser definido por omissão em `alacritty.toml`): -`alacritty --live-config-reload --config-file {{caminho/para/configuração.yml}}` +`alacritty --live-config-reload --config-file {{caminho/para/configuração.toml}}` diff --git a/pages.pt_PT/common/clamav.md b/pages.pt_PT/common/clamav.md index d8094b08e..25464fc27 100644 --- a/pages.pt_PT/common/clamav.md +++ b/pages.pt_PT/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > Este comando é um alias de `clamdscan`. > Mais informações: . diff --git a/pages.pt_PT/common/fossil-ci.md b/pages.pt_PT/common/fossil-ci.md index 59fa5b89b..f02764560 100644 --- a/pages.pt_PT/common/fossil-ci.md +++ b/pages.pt_PT/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> Este comando é um alias de `fossil-commit`. +> Este comando é um alias de `fossil commit`. > Mais informações: . - Exibe documentação do comando original: diff --git a/pages.pt_PT/common/fossil-delete.md b/pages.pt_PT/common/fossil-delete.md index e92e8de35..4cb553f3d 100644 --- a/pages.pt_PT/common/fossil-delete.md +++ b/pages.pt_PT/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > Este comando é um alias de `fossil rm`. > Mais informações: . diff --git a/pages.pt_PT/common/fossil-forget.md b/pages.pt_PT/common/fossil-forget.md index fe5273310..bc07dcf00 100644 --- a/pages.pt_PT/common/fossil-forget.md +++ b/pages.pt_PT/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > Este comando é um alias de `fossil rm`. > Mais informações: . diff --git a/pages.pt_PT/common/fossil-new.md b/pages.pt_PT/common/fossil-new.md index eb21b7461..84ef044f8 100644 --- a/pages.pt_PT/common/fossil-new.md +++ b/pages.pt_PT/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> Este comando é um alias de `fossil-init`. +> Este comando é um alias de `fossil init`. > Mais informações: . - Exibe documentação do comando original: diff --git a/pages.pt_PT/common/gh-cs.md b/pages.pt_PT/common/gh-cs.md index 69cf18aad..f98f493b9 100644 --- a/pages.pt_PT/common/gh-cs.md +++ b/pages.pt_PT/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> Este comando é um alias de `gh-codespace`. +> Este comando é um alias de `gh codespace`. > Mais informações: . - Exibe documentação do comando original: diff --git a/pages.pt_PT/common/gnmic-sub.md b/pages.pt_PT/common/gnmic-sub.md index 55432454b..5ef740fb3 100644 --- a/pages.pt_PT/common/gnmic-sub.md +++ b/pages.pt_PT/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > Este comando é um alias de `gnmic subscribe`. > Mais informações: . diff --git a/pages.pt_PT/common/pio-init.md b/pages.pt_PT/common/pio-init.md index 56471fef6..dfb459b66 100644 --- a/pages.pt_PT/common/pio-init.md +++ b/pages.pt_PT/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > Este comando é um alias de `pio project`. diff --git a/pages.pt_PT/common/tlmgr-arch.md b/pages.pt_PT/common/tlmgr-arch.md index 744658b62..79eb3863b 100644 --- a/pages.pt_PT/common/tlmgr-arch.md +++ b/pages.pt_PT/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > Este comando é um alias de `tlmgr platform`. > Mais informações: . diff --git a/pages.pt_PT/linux/gedit.md b/pages.pt_PT/linux/gedit.md index 7da051e42..e55f69525 100644 --- a/pages.pt_PT/linux/gedit.md +++ b/pages.pt_PT/linux/gedit.md @@ -13,7 +13,7 @@ - Abre um ficheiro de texto com uma formatação específica: -`gedit --encoding={{UTF-8}} {{caminho/para/ficheiro}}` +`gedit --encoding {{UTF-8}} {{caminho/para/ficheiro}}` - Mostra a lista de formatações de texto disponíveis: diff --git a/pages.pt_PT/linux/ip-route-list.md b/pages.pt_PT/linux/ip-route-list.md index 99611d3c1..c35c01975 100644 --- a/pages.pt_PT/linux/ip-route-list.md +++ b/pages.pt_PT/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> Este comando é um alias de `ip-route-show`. +> Este comando é um alias de `ip route show`. - Exibe documentação do comando original: diff --git a/pages.pt_PT/linux/man.md b/pages.pt_PT/linux/man.md index 383af4d1d..a447873fd 100644 --- a/pages.pt_PT/linux/man.md +++ b/pages.pt_PT/linux/man.md @@ -25,7 +25,7 @@ - Exibe a página do manual usando uma localização específica: -`man --locale={{localização}} {{comando}}` +`man --locale {{localização}} {{comando}}` - Procura por páginas do manual que contenham uma certa string: diff --git a/pages.ru/common/7zr.md b/pages.ru/common/7zr.md index 5997cbd60..426f52d8d 100644 --- a/pages.ru/common/7zr.md +++ b/pages.ru/common/7zr.md @@ -1,7 +1,7 @@ # 7zr > Архиватор файлов с высокой степенью сжатия. -> То же, что и `7z`, но поддерживает только файлы `.7z`. +> То же, что и `7z`, но поддерживает только файлы 7z. > Больше информации: . - Архивировать ([a]rchive) файл или папку: diff --git a/pages.ru/common/ack.md b/pages.ru/common/ack.md index 877bddb05..a63c04242 100644 --- a/pages.ru/common/ack.md +++ b/pages.ru/common/ack.md @@ -18,11 +18,11 @@ - Ограничить поиск только файлами определённого типа: -`ack --type={{ruby}} "{{шаблон_поиска}}"` +`ack --type {{ruby}} "{{шаблон_поиска}}"` - Не искать в файлах определённого типа: -`ack --type=no{{ruby}} "{{шаблон_поиска}}"` +`ack --type no{{ruby}} "{{шаблон_поиска}}"` - Подсчитать общее количество найденных совпадений: diff --git a/pages.ru/common/asciidoctor.md b/pages.ru/common/asciidoctor.md index a6d17364c..f1539c496 100644 --- a/pages.ru/common/asciidoctor.md +++ b/pages.ru/common/asciidoctor.md @@ -9,7 +9,7 @@ - Преобразовать данный `.adoc` файл в HTML и привязать к таблице стилей CSS: -`asciidoctor -a stylesheet={{путь/до/таблицы-стилей.css}} {{путь/до/файла.adoc}}` +`asciidoctor -a stylesheet {{путь/до/таблицы-стилей.css}} {{путь/до/файла.adoc}}` - Преобразовать данный `.adoc` файл во встраиваемый HTML, убрав всё кроме самого текста: @@ -17,4 +17,4 @@ - Преобразовать данный `.adoc` файл в PDF с помощью библиотеки `asciidoctor-pdf`: -`asciidoctor --backend={{pdf}} --require={{asciidoctor-pdf}} {{путь/до/файла.adoc}}` +`asciidoctor --backend {{pdf}} --require {{asciidoctor-pdf}} {{путь/до/файла.adoc}}` diff --git a/pages.ru/common/cabal.md b/pages.ru/common/cabal.md index d20c1318a..4c81013a3 100644 --- a/pages.ru/common/cabal.md +++ b/pages.ru/common/cabal.md @@ -2,7 +2,7 @@ > Интерфейс командной строки для инфраструктуры пакетов Haskell (Cabal). > Управление Haskell-проектами и Cabal-пакетами из репозитория Hackage. -> Больше информации: . +> Больше информации: . - Искать и вывести список пакетов из Hackage: diff --git a/pages.ru/common/cat.md b/pages.ru/common/cat.md index 428e9eb98..22e7ed8d2 100644 --- a/pages.ru/common/cat.md +++ b/pages.ru/common/cat.md @@ -1,7 +1,7 @@ # cat > Выводит и объединяет файлы. -> Больше информации: . +> Больше информации: . - Выводит содержимое файла: diff --git a/pages.ru/common/clamav.md b/pages.ru/common/clamav.md index f486c0e2f..dcf3951df 100644 --- a/pages.ru/common/clamav.md +++ b/pages.ru/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > Эта команда — псевдоним для `clamdscan`. > Больше информации: . diff --git a/pages.ru/common/cut.md b/pages.ru/common/cut.md index 368edd00f..ca94cff7c 100644 --- a/pages.ru/common/cut.md +++ b/pages.ru/common/cut.md @@ -3,14 +3,14 @@ > Вырезать поля из стандартного ввода или файлов. > Больше информации: . -- Вывести указанный диапазон символов/полей каждой строки (`--characters|fields=1|1,10|1-10|1-|-10` далее обозначается как `диапазон`): +- Вывести указанный диапазон символов/полей каждой строки (`--characters|fields 1|1,10|1-10|1-|-10` далее обозначается как `диапазон`): -`{{команда}} | cut --{{characters|fields}}={{1|1,10|1-10|1-|-10}}` +`{{команда}} | cut --{{characters|fields}} {{1|1,10|1-10|1-|-10}}` - Вывести диапазон полей каждой строки с указанным разделителем: -`{{команда}} | cut --delimiter="{{,}}" --fields={{1}}` +`{{команда}} | cut --delimiter "{{,}}" --fields {{1}}` - Вывести диапазон символов каждой строки указанного файла: -`cut --characters={{1}} {{путь/к/файлу}}` +`cut --characters {{1}} {{путь/к/файлу}}` diff --git a/pages.ru/common/fossil-ci.md b/pages.ru/common/fossil-ci.md index 66e3db5af..7ce022e47 100644 --- a/pages.ru/common/fossil-ci.md +++ b/pages.ru/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> Эта команда — псевдоним для `fossil-commit`. +> Эта команда — псевдоним для `fossil commit`. > Больше информации: . - Смотри документацию для оригинальной команды: diff --git a/pages.ru/common/fossil-delete.md b/pages.ru/common/fossil-delete.md index 6520ee06a..3bf2020c3 100644 --- a/pages.ru/common/fossil-delete.md +++ b/pages.ru/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > Эта команда — псевдоним для `fossil rm`. > Больше информации: . diff --git a/pages.ru/common/fossil-forget.md b/pages.ru/common/fossil-forget.md index 6dc4881df..64a6bdc20 100644 --- a/pages.ru/common/fossil-forget.md +++ b/pages.ru/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > Эта команда — псевдоним для `fossil rm`. > Больше информации: . diff --git a/pages.ru/common/fossil-new.md b/pages.ru/common/fossil-new.md index 16cbde50c..01c3d9650 100644 --- a/pages.ru/common/fossil-new.md +++ b/pages.ru/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> Эта команда — псевдоним для `fossil-init`. +> Эта команда — псевдоним для `fossil init`. > Больше информации: . - Смотри документацию для оригинальной команды: diff --git a/pages.ru/common/gh-cs.md b/pages.ru/common/gh-cs.md index b81cf7958..a804e992b 100644 --- a/pages.ru/common/gh-cs.md +++ b/pages.ru/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> Эта команда — псевдоним для `gh-codespace`. +> Эта команда — псевдоним для `gh codespace`. > Больше информации: . - Смотри документацию для оригинальной команды: diff --git a/pages.ru/common/gnmic-sub.md b/pages.ru/common/gnmic-sub.md index 018a70053..89fe80f70 100644 --- a/pages.ru/common/gnmic-sub.md +++ b/pages.ru/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > Эта команда — псевдоним для `gnmic subscribe`. > Больше информации: . diff --git a/pages.ru/common/grep.md b/pages.ru/common/grep.md index a11491a56..4f9dca9dc 100644 --- a/pages.ru/common/grep.md +++ b/pages.ru/common/grep.md @@ -9,28 +9,28 @@ - Искать по заданной подстроке (регулярные выражения отключены): -`grep --fixed-strings "{{заданная_подстрока}}" {{путь/к/файлу}}` +`grep {{-F|--fixed-strings}} "{{заданная_подстрока}}" {{путь/к/файлу}}` - Искать по шаблону во всех файлах в директории рекурсивно, показывая номера строк, там где подстрока была найдена, исключая бинарные(двоичные) файлы: -`grep --recursive --line-number --binary-files={{without-match}} "{{шаблон_поиска}}" {{путь/к/директории}}` +`grep {{-r|--recursive}} {{-n|--line-number}} --binary-files={{without-match}} "{{шаблон_поиска}}" {{путь/к/директории}}` - Искать, используя расширенные регулярные выражения (поддержка `?`, `+`, `{}`, `()` и `|`), без учета регистра: -`grep --extended-regexp --ignore-case "{{шаблон_поиска}}" {{путь/к/файлу}}` +`grep {{-E|--extended-regexp}} {{-i|--ignore-case}} "{{шаблон_поиска}}" {{путь/к/файлу}}` - Вывести 3 строки содержимого, до или после каждого совпадения: -`grep --{{context|before-context|after-context}}={{3}} "{{шаблон_поиска}}" {{путь/к/файлу}}` +`grep --{{context|before-context|after-context}} 3 "{{шаблон_поиска}}" {{путь/к/файлу}}` - Вывести имя файла и номер строки для каждого совпадения: -`grep --with-filename --line-number --color=always "{{шаблон_поиска}}" {{путь/к/файлу}}` +`grep {{-H|--with-filename}} {{-n|--line-number}} --color=always "{{шаблон_поиска}}" {{путь/к/файлу}}` - Искать строки, где есть совпадение по шаблону поиска, вывод только совпадающей части текста: -`grep --only-matching "{{шаблон_поиска}}" {{путь/к/файлу}}` +`grep {{-o|--only-matching}} "{{шаблон_поиска}}" {{путь/к/файлу}}` - Искать строки в стандартном потоке ввода которые не совпадают с шаблоном поиска: -`cat {{путь/к/файлу}} | grep --invert-match "{{шаблон_поиска}}"` +`cat {{путь/к/файлу}} | grep {{-v|--invert-match}} "{{шаблон_поиска}}"` diff --git a/pages.ru/common/histexpand.md b/pages.ru/common/histexpand.md index 778f8aac9..8e1552764 100644 --- a/pages.ru/common/histexpand.md +++ b/pages.ru/common/histexpand.md @@ -1,6 +1,6 @@ # history expansion -> Повторное использование и подстановка команд из списка истории в `sh`, `bash`, `zsh`, `rbash` and `ksh`. +> Повторное использование и подстановка команд из списка истории в `sh`, Bash, Zsh, `rbash` and `ksh`. > Больше информации: . - Запустить предыдущую команду от имени суперпользователя (`!!` заменяется на предыдущую команду): diff --git a/pages.ru/common/history.md b/pages.ru/common/history.md index e60c46364..809529c05 100644 --- a/pages.ru/common/history.md +++ b/pages.ru/common/history.md @@ -7,15 +7,15 @@ `history` -- Отобразить последние 20 команд (в `zsh` отображает все команды, начиная с 20-й): +- Отобразить последние 20 команд (в Zsh отображает все команды, начиная с 20-й): `history {{20}}` -- Очистить список истории команд (только для текущей оболочки `bash`): +- Очистить список истории команд (только для текущей оболочки Bash): `history -c` -- Перезаписать файл истории историей текущей оболочки `bash` (часто комбинируется с `history -c` для очистки истории): +- Перезаписать файл истории историей текущей оболочки Bash (часто комбинируется с `history -c` для очистки истории): `history -w` diff --git a/pages.ru/common/jq.md b/pages.ru/common/jq.md index d0ad3d11c..7bc170008 100644 --- a/pages.ru/common/jq.md +++ b/pages.ru/common/jq.md @@ -1,9 +1,9 @@ # jq > Процессор JSON командной строки, использующий доменный язык. -> Больше информации: . +> Больше информации: . -- Выполнить указанное выражение (вывести цветной и отформатированный json): +- Выполнить указанное выражение (вывести цветной и отформатированный JSON): `{{cat путь/к/файлу.json}} | jq '.'` diff --git a/pages.ru/common/pio-init.md b/pages.ru/common/pio-init.md index 8546b85fe..65a3846b9 100644 --- a/pages.ru/common/pio-init.md +++ b/pages.ru/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > Эта команда — псевдоним для `pio project`. diff --git a/pages.ru/common/tlmgr-arch.md b/pages.ru/common/tlmgr-arch.md index 987716f61..951a33d35 100644 --- a/pages.ru/common/tlmgr-arch.md +++ b/pages.ru/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > Эта команда — псевдоним для `tlmgr platform`. > Больше информации: . diff --git a/pages.ru/common/zsh.md b/pages.ru/common/zsh.md index 15f39258b..a2410dd47 100644 --- a/pages.ru/common/zsh.md +++ b/pages.ru/common/zsh.md @@ -24,6 +24,6 @@ `zsh --verbose` -- Выполнить определённую команду внутри `zsh` с отключёнными glob-шаблонами: +- Выполнить определённую команду внутри Zsh с отключёнными glob-шаблонами: `noglob {{команда}}` diff --git a/pages.ru/linux/ip-route-list.md b/pages.ru/linux/ip-route-list.md index b6831d3a2..72b27feed 100644 --- a/pages.ru/linux/ip-route-list.md +++ b/pages.ru/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> Эта команда — псевдоним для `ip-route-show`. +> Эта команда — псевдоним для `ip route show`. - Смотри документацию для оригинальной команды: diff --git a/pages.ru/windows/date.md b/pages.ru/windows/date.md new file mode 100644 index 000000000..b6df0da9e --- /dev/null +++ b/pages.ru/windows/date.md @@ -0,0 +1,16 @@ +# date + +> Просмотр и изменение текущей системной даты. +> Больше информации: . + +- Отображение текущей системной даты, за которой следует запрос на ввод новой даты (Оставить пустым если не нужно вносить изменения): + +`date` + +- Отображает текущую дату без запроса на новую дату: + +`date /t` + +- Для изменения текущей даты, введите новую дату, на основе текущей конфигурации даты, а затем нажмите клавишу ВВОД: + +`date {{месяц}}-{{день}}-{{год}}` diff --git a/pages.ru/windows/mkdir.md b/pages.ru/windows/mkdir.md new file mode 100644 index 000000000..956e66385 --- /dev/null +++ b/pages.ru/windows/mkdir.md @@ -0,0 +1,12 @@ +# mkdir + +> Создает каталог или подкаталог в файловой системе. +> Больше информации: . + +- Создать новый каталог: + +`mkdir {{путь\до\папки}}` + +- Чтобы создать дерево каталогов в корневом каталоге введите: + +`mkdir {{путь\до\под_папки}}` diff --git a/pages.ru/windows/print.md b/pages.ru/windows/print.md new file mode 100644 index 000000000..1fa68d0b9 --- /dev/null +++ b/pages.ru/windows/print.md @@ -0,0 +1,12 @@ +# print + +> Вывод на печать текстового файла. +> Больше информации: . + +- Печать текстового файла используя локальный принтер: + +`print {{путь\до\папки}}` + +- Печать текстового файла используя сетевой принтер: + +`print /d:{{принтер}} {{путь\до\папки}}` diff --git a/pages.ru/windows/time.md b/pages.ru/windows/time.md new file mode 100644 index 000000000..6397e7f1a --- /dev/null +++ b/pages.ru/windows/time.md @@ -0,0 +1,12 @@ +# time + +> Просмотр и измененение системного времени. +> Больше информации: . + +- Отображение текущего системного времени, за которым следует запрос на ввод нового времени (Оставить пустым если не нужно вносить изменения): + +`time` + +- Отображает текущее системное время без запроса на новое время: + +`time /t` diff --git a/pages.sv/common/clamav.md b/pages.sv/common/clamav.md index 0c87f62e7..4681c9c8c 100644 --- a/pages.sv/common/clamav.md +++ b/pages.sv/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > Det här kommandot är ett alias för `clamdscan`. > Mer information: . diff --git a/pages.sv/common/fossil-ci.md b/pages.sv/common/fossil-ci.md index bfd805bdc..09890d20e 100644 --- a/pages.sv/common/fossil-ci.md +++ b/pages.sv/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> Det här kommandot är ett alias för `fossil-commit`. +> Det här kommandot är ett alias för `fossil commit`. > Mer information: . - Se dokumentationen för orginalkommandot: diff --git a/pages.sv/common/fossil-delete.md b/pages.sv/common/fossil-delete.md index e7f09ecdf..e6578049c 100644 --- a/pages.sv/common/fossil-delete.md +++ b/pages.sv/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > Det här kommandot är ett alias för `fossil rm`. > Mer information: . diff --git a/pages.sv/common/fossil-forget.md b/pages.sv/common/fossil-forget.md index 289d25ec8..c214e1063 100644 --- a/pages.sv/common/fossil-forget.md +++ b/pages.sv/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > Det här kommandot är ett alias för `fossil rm`. > Mer information: . diff --git a/pages.sv/common/fossil-new.md b/pages.sv/common/fossil-new.md index 691f47ee9..60c3b99e9 100644 --- a/pages.sv/common/fossil-new.md +++ b/pages.sv/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> Det här kommandot är ett alias för `fossil-init`. +> Det här kommandot är ett alias för `fossil init`. > Mer information: . - Se dokumentationen för orginalkommandot: diff --git a/pages.sv/common/gh-cs.md b/pages.sv/common/gh-cs.md index f225a4596..241762c7e 100644 --- a/pages.sv/common/gh-cs.md +++ b/pages.sv/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> Det här kommandot är ett alias för `gh-codespace`. +> Det här kommandot är ett alias för `gh codespace`. > Mer information: . - Se dokumentationen för orginalkommandot: diff --git a/pages.sv/common/gnmic-sub.md b/pages.sv/common/gnmic-sub.md index 45608f52d..5b9e2fb89 100644 --- a/pages.sv/common/gnmic-sub.md +++ b/pages.sv/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > Det här kommandot är ett alias för `gnmic subscribe`. > Mer information: . diff --git a/pages.sv/common/pio-init.md b/pages.sv/common/pio-init.md index f81a43539..ff162626f 100644 --- a/pages.sv/common/pio-init.md +++ b/pages.sv/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > Det här kommandot är ett alias för `pio project`. diff --git a/pages.sv/common/tlmgr-arch.md b/pages.sv/common/tlmgr-arch.md index e7d429018..28d454a4f 100644 --- a/pages.sv/common/tlmgr-arch.md +++ b/pages.sv/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > Det här kommandot är ett alias för `tlmgr platform`. > Mer information: . diff --git a/pages.sv/linux/ip-route-list.md b/pages.sv/linux/ip-route-list.md index 967b2befe..a1456ce87 100644 --- a/pages.sv/linux/ip-route-list.md +++ b/pages.sv/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> Det här kommandot är ett alias för `ip-route-show`. +> Det här kommandot är ett alias för `ip route show`. - Se dokumentationen för orginalkommandot: diff --git a/pages.ta/android/logcat.md b/pages.ta/android/logcat.md index 7708f9715..46a38f281 100644 --- a/pages.ta/android/logcat.md +++ b/pages.ta/android/logcat.md @@ -17,8 +17,8 @@ - ஒரு குறிப்பிட்ட PIDக்கான பதிவுகளை காண்பி: -`logcat --pid={{pid}}` +`logcat --pid {{pid}}` - ஒரு குறிப்பிட்ட தொகுப்பின் செயல்முறைக்கான பதிவுகளை காண்பி: -`logcat --pid=$(pidof -s {{package}})` +`logcat --pid $(pidof -s {{package}})` diff --git a/pages.ta/common/ack.md b/pages.ta/common/ack.md index d72310507..c2b15b741 100644 --- a/pages.ta/common/ack.md +++ b/pages.ta/common/ack.md @@ -18,11 +18,11 @@ - ஒரு குறிப்பிட்ட வகை கோப்புகளுக்கான தேடலை வரம்பிடவும்: -`ack --type={{ruby}} "{{தேடல்_முறை}}"` +`ack --type {{ruby}} "{{தேடல்_முறை}}"` - ஒரு குறிப்பிட்ட வகை கோப்புகளில் தேட வேண்டாம்: -`ack --type=no{{ruby}} "{{தேடல்_முறை}}"` +`ack --type no{{ruby}} "{{தேடல்_முறை}}"` - காணப்பட்ட மொத்த பொருத்தங்களின் எண்ணிக்கையை எண்ணுங்கள்: diff --git a/pages.ta/common/clamav.md b/pages.ta/common/clamav.md index 900163525..7ae42cef8 100644 --- a/pages.ta/common/clamav.md +++ b/pages.ta/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > திறந்த மூல வைரஸ் எதிர்ப்பு நிரல். > ClamAV ஒரு கட்டளை அல்ல, ஆனால் கட்டளைகளின் தொகுப்பு. diff --git a/pages.ta/common/fossil-ci.md b/pages.ta/common/fossil-ci.md index 5d03afdac..a1736707c 100644 --- a/pages.ta/common/fossil-ci.md +++ b/pages.ta/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> இக்கட்டளை `fossil-commit` கட்டளையின் மற்றொருப் பெயர். +> இக்கட்டளை `fossil commit`.கட்டளையின் மற்றொருப் பெயர். > மேலும் விவரத்திற்கு: . - அக்கட்டளையின் விளக்கத்தைக் காண: diff --git a/pages.ta/common/fossil-delete.md b/pages.ta/common/fossil-delete.md index b3c007a02..309e737f3 100644 --- a/pages.ta/common/fossil-delete.md +++ b/pages.ta/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > இக்கட்டளை `fossil rm` கட்டளையின் மற்றொருப் பெயர். > மேலும் விவரத்திற்கு: . diff --git a/pages.ta/common/fossil-forget.md b/pages.ta/common/fossil-forget.md index bb6cadddc..eafec2670 100644 --- a/pages.ta/common/fossil-forget.md +++ b/pages.ta/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > இக்கட்டளை `fossil rm` கட்டளையின் மற்றொருப் பெயர். > மேலும் விவரத்திற்கு: . diff --git a/pages.ta/common/fossil-new.md b/pages.ta/common/fossil-new.md index 2adaf1a65..28e8752be 100644 --- a/pages.ta/common/fossil-new.md +++ b/pages.ta/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> இக்கட்டளை `fossil-init` கட்டளையின் மற்றொருப் பெயர். +> இக்கட்டளை `fossil init`.கட்டளையின் மற்றொருப் பெயர். > மேலும் விவரத்திற்கு: . - அக்கட்டளையின் விளக்கத்தைக் காண: diff --git a/pages.ta/common/gh-cs.md b/pages.ta/common/gh-cs.md index c59e595a0..801fca85e 100644 --- a/pages.ta/common/gh-cs.md +++ b/pages.ta/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> இக்கட்டளை `gh-codespace` கட்டளையின் மற்றொருப் பெயர். +> இக்கட்டளை `gh codespace`.கட்டளையின் மற்றொருப் பெயர். > மேலும் விவரத்திற்கு: . - அக்கட்டளையின் விளக்கத்தைக் காண: diff --git a/pages.ta/common/gnmic-sub.md b/pages.ta/common/gnmic-sub.md index 57ee6f4e6..1599124f0 100644 --- a/pages.ta/common/gnmic-sub.md +++ b/pages.ta/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > இக்கட்டளை `gnmic subscribe` கட்டளையின் மற்றொருப் பெயர். > மேலும் விவரத்திற்கு: . diff --git a/pages.ta/common/grep.md b/pages.ta/common/grep.md index af558508f..df70f8dba 100644 --- a/pages.ta/common/grep.md +++ b/pages.ta/common/grep.md @@ -9,28 +9,28 @@ - தேடுகுறித்தொடரல்லா உருச்சரத்திற்குத் தேடு: -`grep --fixed-strings "{{உருச்சரம்}}" {{கோப்பு/பாதை}}` +`grep {{-F|--fixed-strings}} "{{உருச்சரம்}}" {{கோப்பு/பாதை}}` - அடைவிலும் சேய் அடைவுகளிலுமுள்ள இருமக் கோப்பல்லா அனைத்துக் கோப்புகளையும் தேடு; பொருத்தங்களின் வரி எண்ணைக் காட்டு: -`grep --recursive --line-number --binary-files={{without-match}} "{{தேடுதொடர்}}" {{அடைவிற்குப்/பாதை}}` +`grep {{-r|--recursive}} {{-n|--line-number}} --binary-files={{without-match}} "{{தேடுதொடர்}}" {{அடைவிற்குப்/பாதை}}` - எழுத்துயர்நிலை கருதாது விரிவுபட்ட தேடுகுறித்தொடர்களுடன் (`?`, `+`, `{}`, `|` ஆகியவற்றைப் பயன்படுத்தலாம்) தேடு: -`grep --extended-regexp --ignore-case "{{தேடுதொடர்}}" {{கோப்பு/பாதை}}` +`grep {{-E|--extended-regexp}} {{-i|--ignore-case}} "{{தேடுதொடர்}}" {{கோப்பு/பாதை}}` - ஒவ்வொருப் பொருத்தத்திற்கும் சூழ்ந்த, முந்தைய அல்லது பிந்தைய 3 வரிகளைக் காட்டு: -`grep --{{context|before-context|after-context}}={{3}} "{{தேடுதொடர்}}" {{கோப்பு/பாதை}}` +`grep --{{context|before-context|after-context}} 3 "{{தேடுதொடர்}}" {{கோப்பு/பாதை}}` - வண்ண வெளியீட்டில் ஒவ்வொரு பொருத்தத்திற்கும் கோப்பு பெயர் மற்றும் வரி எண்ணை அச்சிடவும்: -`grep --with-filename --line-number --color=always "{{தேடுதொடர்}}" {{கோப்பு/பாதை}}` +`grep {{-H|--with-filename}} {{-n|--line-number}} --color=always "{{தேடுதொடர்}}" {{கோப்பு/பாதை}}` - தேடுதொடருக்குத் தேடு, ஆனால் பொருந்திய பகுதிகளை மட்டும் காட்டு: -`grep --only-matching "{{தேடுதொடர்}}" {{கோப்பு/பாதை}}` +`grep {{-o|--only-matching}} "{{தேடுதொடர்}}" {{கோப்பு/பாதை}}` - இயல் உள்ளீட்டில் தேடுதொடருக்குப் பொருந்தா வரிகளை மட்டும் காட்டு: -`cat {{கோப்பு/பாதை}} | grep --invert-match "{{தேடுதொடர்}}"` +`cat {{கோப்பு/பாதை}} | grep {{-v|--invert-match}} "{{தேடுதொடர்}}"` diff --git a/pages.ta/common/man.md b/pages.ta/common/man.md index cf7200e4c..e1efc5cbc 100644 --- a/pages.ta/common/man.md +++ b/pages.ta/common/man.md @@ -1,7 +1,7 @@ # man > கையேடு பக்கங்களை வடிவமைத்து காட்டவும். -> மேலும் விவரத்திற்கு: . +> மேலும் விவரத்திற்கு: . - ஒரு கட்டளைக்கான மேன் பக்கத்தைக் காண்பி: diff --git a/pages.ta/common/pio-init.md b/pages.ta/common/pio-init.md index f42a0df98..ab8db4dad 100644 --- a/pages.ta/common/pio-init.md +++ b/pages.ta/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > இக்கட்டளை `pio project` கட்டளையின் மற்றொருப் பெயர். diff --git a/pages.ta/common/podman.md b/pages.ta/common/podman.md index b65bda604..f8619c695 100644 --- a/pages.ta/common/podman.md +++ b/pages.ta/common/podman.md @@ -1,4 +1,4 @@ -# Podman +# podman > காய்கள், கொள்கலன்கள் மற்றும் படங்களுக்கான எளிய மேலாண்மை கருவி. > போட்மேன் ஒரு Docker-CLI ஒப்பிடக்கூடிய கட்டளை வரியை வழங்குகிறது. எளிமையாகச் சொன்னால்: `alias docker=podman`. diff --git a/pages.ta/common/tlmgr-arch.md b/pages.ta/common/tlmgr-arch.md index f5b55c9bd..b6b3412f9 100644 --- a/pages.ta/common/tlmgr-arch.md +++ b/pages.ta/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > இக்கட்டளை `tlmgr platform` கட்டளையின் மற்றொருப் பெயர். > மேலும் விவரத்திற்கு: . diff --git a/pages.ta/common/vt.md b/pages.ta/common/vt.md index 0ba5a0ad2..b0901fda6 100644 --- a/pages.ta/common/vt.md +++ b/pages.ta/common/vt.md @@ -16,7 +16,7 @@ `vt analysis {{கோப்பு_ஐடி|பகுப்பாய்வு_ஐடி}}` -- என்க்ரிப்ட் செய்யப்பட்ட `.zip` வடிவத்தில் கோப்புகளைப் பதிவிறக்கவும் (பிரீமியம் கணக்கு தேவை): +- என்க்ரிப்ட் செய்யப்பட்ட Zip வடிவத்தில் கோப்புகளைப் பதிவிறக்கவும் (பிரீமியம் கணக்கு தேவை): `vt download {{கோப்பு_ஐடி}} --output {{அடைவிற்குப்/பாதை}} --zip --zip-password {{கடவுச்சொல்}}` diff --git a/pages.ta/linux/ip-route-list.md b/pages.ta/linux/ip-route-list.md index 69e8359ba..b5b80b878 100644 --- a/pages.ta/linux/ip-route-list.md +++ b/pages.ta/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> இக்கட்டளை `ip-route-show` கட்டளையின் மற்றொருப் பெயர். +> இக்கட்டளை `ip route show`.கட்டளையின் மற்றொருப் பெயர். - அக்கட்டளையின் விளக்கத்தைக் காண: diff --git a/pages.ta/sunos/prstat.md b/pages.ta/sunos/prstat.md index 23562bfd4..d16907675 100644 --- a/pages.ta/sunos/prstat.md +++ b/pages.ta/sunos/prstat.md @@ -21,4 +21,4 @@ - ஒவ்வொரு நொடியும் செயல்முறைகளைப் பயன்படுத்தி முதல் 5 CPU இன் பட்டியலை அச்சிடவும்: -`prstat -c -n {{5}} -s cpu {{1}}` +`prstat -c -n 5 -s cpu 1` diff --git a/pages.ta/windows/choco-apikey.md b/pages.ta/windows/choco-apikey.md index 96217a6fc..f91e7b730 100644 --- a/pages.ta/windows/choco-apikey.md +++ b/pages.ta/windows/choco-apikey.md @@ -1,4 +1,4 @@ -# choco-apikey +# choco apikey > சாக்லேட்டி மூலங்களுக்கான API விசைகளை நிர்வகிக்கவும். > மேலும் விவரத்திற்கு: . diff --git a/pages.th/common/fossil-ci.md b/pages.th/common/fossil-ci.md index e927ec032..a24c34cb7 100644 --- a/pages.th/common/fossil-ci.md +++ b/pages.th/common/fossil-ci.md @@ -1,4 +1,4 @@ -# fossil-ci +# fossil ci > คำสั่งนี้เป็นอีกชื่อหนึ่งของคำสั่ง `fossil-commit` > ข้อมูลเพิ่มเติม: diff --git a/pages.th/common/fossil-delete.md b/pages.th/common/fossil-delete.md index 6040fdc45..069cae532 100644 --- a/pages.th/common/fossil-delete.md +++ b/pages.th/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > คำสั่งนี้เป็นอีกชื่อหนึ่งของคำสั่ง `fossil rm` > ข้อมูลเพิ่มเติม: diff --git a/pages.th/common/fossil-forget.md b/pages.th/common/fossil-forget.md index c29a87b72..f25a36365 100644 --- a/pages.th/common/fossil-forget.md +++ b/pages.th/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > คำสั่งนี้เป็นอีกชื่อหนึ่งของคำสั่ง `fossil rm` > ข้อมูลเพิ่มเติม: diff --git a/pages.th/common/fossil-new.md b/pages.th/common/fossil-new.md index 629966844..2539466ef 100644 --- a/pages.th/common/fossil-new.md +++ b/pages.th/common/fossil-new.md @@ -1,4 +1,4 @@ -# fossil-new +# fossil new > คำสั่งนี้เป็นอีกชื่อหนึ่งของคำสั่ง `fossil-init` > ข้อมูลเพิ่มเติม: diff --git a/pages.th/common/gh-cs.md b/pages.th/common/gh-cs.md index 6c21f666e..a516f3480 100644 --- a/pages.th/common/gh-cs.md +++ b/pages.th/common/gh-cs.md @@ -1,4 +1,4 @@ -# gh-cs +# gh cs > คำสั่งนี้เป็นอีกชื่อหนึ่งของคำสั่ง `gh-codespace` > ข้อมูลเพิ่มเติม: diff --git a/pages.th/common/gnmic-sub.md b/pages.th/common/gnmic-sub.md index 9238028d6..de8c47a69 100644 --- a/pages.th/common/gnmic-sub.md +++ b/pages.th/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > คำสั่งนี้เป็นอีกชื่อหนึ่งของคำสั่ง `gnmic subscribe` > ข้อมูลเพิ่มเติม: diff --git a/pages.th/common/pio-init.md b/pages.th/common/pio-init.md index 8ba3ea730..4d611ff92 100644 --- a/pages.th/common/pio-init.md +++ b/pages.th/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > คำสั่งนี้เป็นอีกชื่อหนึ่งของคำสั่ง `pio project` diff --git a/pages.th/common/tlmgr-arch.md b/pages.th/common/tlmgr-arch.md index 290919e46..c27970baf 100644 --- a/pages.th/common/tlmgr-arch.md +++ b/pages.th/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > คำสั่งนี้เป็นอีกชื่อหนึ่งของคำสั่ง `tlmgr platform` > ข้อมูลเพิ่มเติม: diff --git a/pages.th/linux/apt-add-repository.md b/pages.th/linux/apt-add-repository.md index e8bcef02b..f2a7ff1c4 100644 --- a/pages.th/linux/apt-add-repository.md +++ b/pages.th/linux/apt-add-repository.md @@ -1,17 +1,17 @@ # apt-add-repository -> ควบคุมและจัดการที่อยู่ของคลัง apt. +> ควบคุมและจัดการที่อยู่ของคลัง APT. > ข้อมูลเพิ่มเติม: -- เพิ่มที่หมายของคลัง apt: +- เพิ่มที่หมายของคลัง APT: `apt-add-repository {{ที่อยู่จำเพาะของคลัง}}` -- ลบคลัง apt: +- ลบคลัง APT: `apt-add-repository --remove {{ที่อยู่จำเพาะของคลัง}}` -- อัพเดตข้อมูลแคชหลังจากเพิ่มคลัง apt: +- อัพเดตข้อมูลแคชหลังจากเพิ่มคลัง APT: `apt-add-repository --update {{ที่อยู่จำเพาะของคลัง}}` diff --git a/pages.th/linux/ip-route-list.md b/pages.th/linux/ip-route-list.md index 376065939..eb91773b9 100644 --- a/pages.th/linux/ip-route-list.md +++ b/pages.th/linux/ip-route-list.md @@ -1,4 +1,4 @@ -# ip-route-list +# ip route list > คำสั่งนี้เป็นอีกชื่อหนึ่งของคำสั่ง `ip-route-show` diff --git a/pages.tr/common/cat.md b/pages.tr/common/cat.md index 3bdaca76b..af859736a 100644 --- a/pages.tr/common/cat.md +++ b/pages.tr/common/cat.md @@ -1,7 +1,7 @@ # cat > Dosyaları yazdır ve birleştir. -> Daha fazla bilgi için: . +> Daha fazla bilgi için: . - Bir dosyanın içeriğini standart çıktıya yazdır: diff --git a/pages.tr/common/clamav.md b/pages.tr/common/clamav.md index 80647a7e8..8fdddb4cd 100644 --- a/pages.tr/common/clamav.md +++ b/pages.tr/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > Bu komut `clamdscan` için bir takma addır. > Daha fazla bilgi için: . diff --git a/pages.tr/common/diff.md b/pages.tr/common/diff.md index ad8321a65..3c39e1f48 100644 --- a/pages.tr/common/diff.md +++ b/pages.tr/common/diff.md @@ -1,7 +1,7 @@ # diff > Dosyaları ve dizinleri karşılaştırın. -> Daha fazla bilgi için: . +> Daha fazla bilgi için: . - Dosyaları karşılaştır (`eski_dosya`'yı `yeni_dosya`'ya dönüştürmek için yapılan değişiklikleri listeler): diff --git a/pages.tr/common/docker-build.md b/pages.tr/common/docker-build.md index 1467cc6dd..387e8584b 100644 --- a/pages.tr/common/docker-build.md +++ b/pages.tr/common/docker-build.md @@ -3,15 +3,15 @@ > Bir Dockerfile'dan imge yaratın. > Daha fazla bilgi için: . -- Mevcut dizindeki Dockerfile'dan bir docker imgesi oluşturun: +- Mevcut dizindeki Dockerfile'dan bir Docker imgesi oluşturun: `docker build .` -- Belirtilen URL'deki Dockerfile'dan bir docker imgesi oluşturun: +- Belirtilen URL'deki Dockerfile'dan bir Docker imgesi oluşturun: `docker build {{ornekadres.com/ornek-dizin/ornek-docker-projesi}}` -- Bir docker imgesi oluşturun ve etiketleyin: +- Bir Docker imgesi oluşturun ve etiketleyin: `docker build --tag {{isim:etiket}} .` @@ -19,7 +19,7 @@ `docker build --no-cache --tag {{isim:etiket}} .` -- Belirtilen Dockerfile ile bir docker imgesi oluşturun: +- Belirtilen Dockerfile ile bir Docker imgesi oluşturun: `docker build --file {{Dockerfile}} .` diff --git a/pages.tr/common/docker-compose.md b/pages.tr/common/docker-compose.md index 6ad0d3eba..5eb53151e 100644 --- a/pages.tr/common/docker-compose.md +++ b/pages.tr/common/docker-compose.md @@ -1,6 +1,6 @@ # docker compose -> Çoklu konteynerli docker uygulamalarını çalıştırın ve yönetin. +> Çoklu konteynerli Docker uygulamalarını çalıştırın ve yönetin. > Daha fazla bilgi için: . - Tüm konteynerleri listele: diff --git a/pages.tr/common/docker-exec.md b/pages.tr/common/docker-exec.md index e12b6bb85..8a96e782c 100644 --- a/pages.tr/common/docker-exec.md +++ b/pages.tr/common/docker-exec.md @@ -19,7 +19,7 @@ `docker exec --interactive --detach {{konteyner_ismi}} {{komut}}` -- Çalışmakta olan bir bash oturumu içinde bir çevre değişkeni belirle: +- Çalışmakta olan bir Bash oturumu içinde bir çevre değişkeni belirle: `docker exec --interactive --tty --env {{değişken_ismi}}={{value}} {{konteyner_ismi}} {{/bin/bash}}` diff --git a/pages.tr/common/docker-machine.md b/pages.tr/common/docker-machine.md index 92fdf994f..9b6f449a6 100644 --- a/pages.tr/common/docker-machine.md +++ b/pages.tr/common/docker-machine.md @@ -1,13 +1,13 @@ # docker-machine > Docker çalıştıran makineler oluştur ve onları yönet. -> Daha fazla bilgi için: . +> Daha fazla bilgi için: . -- Halihazırda çalışan docker makinelerini sırala: +- Halihazırda çalışan Docker makinelerini sırala: `docker-machine ls` -- Belirli bir isim ile docker makinesi oluştur: +- Belirli bir isim ile Docker makinesi oluştur: `docker-machine create {{isim}}` diff --git a/pages.tr/common/docker-ps.md b/pages.tr/common/docker-ps.md index 2c34ceb57..5176f854c 100644 --- a/pages.tr/common/docker-ps.md +++ b/pages.tr/common/docker-ps.md @@ -3,11 +3,11 @@ > Docker konteynerlerini sırala. > Daha fazla bilgi için: . -- Halihazırda çalışan docker konteynerlerini listele: +- Halihazırda çalışan Docker konteynerlerini listele: `docker ps` -- Tüm (durmuş veya çalışan) docker konteynerlerini listele: +- Tüm (durmuş veya çalışan) Docker konteynerlerini listele: `docker ps --all` @@ -29,8 +29,8 @@ - Konteynerleri mevcut durumlarına (oluşturulma, çalışma, silinme, durma, çıkma ve ölme) göre sırala: -`docker ps --filter="status={{mevcut_durum}}"` +`docker ps --filter "status={{mevcut_durum}}"` - Belirtilmiş bir hacmi gömen veya belirtilmiş bir yola gömülmüş hacmi içeren konteynerleri filtrele: -`docker ps --filter="volume={{örnek/dizin}}" --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Mounts}}"` +`docker ps --filter "volume={{örnek/dizin}}" --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Mounts}}"` diff --git a/pages.tr/common/docker-save.md b/pages.tr/common/docker-save.md index 798bf7342..da6de4745 100644 --- a/pages.tr/common/docker-save.md +++ b/pages.tr/common/docker-save.md @@ -1,6 +1,6 @@ # docker save -> Bir veya daha fazla docker imgesini arşivlemek için dışa aktar. +> Bir veya daha fazla Docker imgesini arşivlemek için dışa aktar. > Daha fazla bilgi için: . - Bir imgeyi, `stdout`'u tar arşivine yönlendirerek kaydet: diff --git a/pages.tr/common/docker-service.md b/pages.tr/common/docker-service.md index 179483290..62cd2a9d2 100644 --- a/pages.tr/common/docker-service.md +++ b/pages.tr/common/docker-service.md @@ -1,9 +1,9 @@ # docker service -> Bir docker daemon'unun üzerindeki servisleri yönet. +> Bir Docker daemon'unun üzerindeki servisleri yönet. > Daha fazla bilgi için: . -- Bir docker daeomon'unun üzerindeki servisleri listele: +- Bir Docker daeomon'unun üzerindeki servisleri listele: `docker service ls` diff --git a/pages.tr/common/docker-start.md b/pages.tr/common/docker-start.md index 0fed5b597..50614b4bd 100644 --- a/pages.tr/common/docker-start.md +++ b/pages.tr/common/docker-start.md @@ -7,7 +7,7 @@ `docker start` -- Bir docker konteynerini başlat: +- Bir Docker konteynerini başlat: `docker start {{konteyner}}` diff --git a/pages.tr/common/docker-system.md b/pages.tr/common/docker-system.md index 130eb9c6a..984831eca 100644 --- a/pages.tr/common/docker-system.md +++ b/pages.tr/common/docker-system.md @@ -21,7 +21,7 @@ - Kullanılmayan ve geçmişte birden çok kez oluşturulan veriyi sil: -`docker system prune --filter="until={{saat}}h{{dakika}}m"` +`docker system prune --filter "until={{saat}}h{{dakika}}m"` - Docker deamon'dan tam-zamanlı eylemleri görüntüle: diff --git a/pages.tr/common/docker.md b/pages.tr/common/docker.md index 55ac3857c..8bd8173ad 100644 --- a/pages.tr/common/docker.md +++ b/pages.tr/common/docker.md @@ -4,7 +4,7 @@ > `docker run` gibi bazı alt komutların kendi dökümantasyonu bulunmaktadır. > Daha fazla bilgi için: . -- Tüm (çalışan veya duran) docker konteynerlerini listele: +- Tüm (çalışan veya duran) Docker konteynerlerini listele: `docker ps --all` @@ -16,7 +16,7 @@ `docker {{start|stop}} {{konteyner_ismi}}` -- Bir docker kaydından imge çek: +- Bir Docker kaydından imge çek: `docker pull {{imge}}` diff --git a/pages.tr/common/fossil-ci.md b/pages.tr/common/fossil-ci.md index de9e2097c..f55ddd398 100644 --- a/pages.tr/common/fossil-ci.md +++ b/pages.tr/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> Bu komut `fossil-commit` için bir takma addır. +> Bu komut `fossil commit`.için bir takma addır. > Daha fazla bilgi için: . - Asıl komutun belgelerini görüntüleyin: diff --git a/pages.tr/common/fossil-delete.md b/pages.tr/common/fossil-delete.md index e19b103cf..bfa3eb02d 100644 --- a/pages.tr/common/fossil-delete.md +++ b/pages.tr/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > Bu komut `fossil rm` için bir takma addır. > Daha fazla bilgi için: . diff --git a/pages.tr/common/fossil-forget.md b/pages.tr/common/fossil-forget.md index 3bb6d6a70..e1b9ba79e 100644 --- a/pages.tr/common/fossil-forget.md +++ b/pages.tr/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > Bu komut `fossil rm` için bir takma addır. > Daha fazla bilgi için: . diff --git a/pages.tr/common/fossil-new.md b/pages.tr/common/fossil-new.md index 90db1968b..6b5c8dc6d 100644 --- a/pages.tr/common/fossil-new.md +++ b/pages.tr/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> Bu komut `fossil-init` için bir takma addır. +> Bu komut `fossil init`.için bir takma addır. > Daha fazla bilgi için: . - Asıl komutun belgelerini görüntüleyin: diff --git a/pages.tr/common/gh-cs.md b/pages.tr/common/gh-cs.md index 8b10416db..d51c94854 100644 --- a/pages.tr/common/gh-cs.md +++ b/pages.tr/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> Bu komut `gh-codespace` için bir takma addır. +> Bu komut `gh codespace`.için bir takma addır. > Daha fazla bilgi için: . - Asıl komutun belgelerini görüntüleyin: diff --git a/pages.tr/common/git-instaweb.md b/pages.tr/common/git-instaweb.md index 5b5aa7fbb..00eb491dc 100644 --- a/pages.tr/common/git-instaweb.md +++ b/pages.tr/common/git-instaweb.md @@ -15,7 +15,7 @@ `git instaweb --start --port {{1234}}` -- Belirtilmiş bir http daemon'u kullan: +- Belirtilmiş bir HTTP daemon'u kullan: `git instaweb --start --httpd {{lighttpd|apache2|mongoose|plackup|webrick}}` diff --git a/pages.tr/common/git-lfs.md b/pages.tr/common/git-lfs.md index 6bb76cc49..44076d3d4 100644 --- a/pages.tr/common/git-lfs.md +++ b/pages.tr/common/git-lfs.md @@ -1,7 +1,7 @@ # git lfs > Git depolarındaki büyük dosyalarla çalış. -> Daha fazla bilgi için: . +> Daha fazla bilgi için: . - Git LFS'i başlat: diff --git a/pages.tr/common/gitk.md b/pages.tr/common/gitk.md index 1afaba479..9f6922d25 100644 --- a/pages.tr/common/gitk.md +++ b/pages.tr/common/gitk.md @@ -21,4 +21,4 @@ - Tüm dallarda en fazla 100 değişiklik göster: -` gitk --max-count={{100}} --all` +`gitk --max-count={{100}} --all` diff --git a/pages.tr/common/gnmic-sub.md b/pages.tr/common/gnmic-sub.md index 04cdbac6a..32efeebdd 100644 --- a/pages.tr/common/gnmic-sub.md +++ b/pages.tr/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > Bu komut `gnmic subscribe` için bir takma addır. > Daha fazla bilgi için: . diff --git a/pages.tr/common/grep.md b/pages.tr/common/grep.md index 8401db3db..51faffd66 100644 --- a/pages.tr/common/grep.md +++ b/pages.tr/common/grep.md @@ -9,28 +9,28 @@ - Tam bir dize ara (düzenli ifadeleri devre dışı bırakır): -`grep --fixed-strings "{{tam_dize}}" {{dosya/yolu}}` +`grep {{-F|--fixed-strings}} "{{tam_dize}}" {{dosya/yolu}}` - Bir dizindeki tüm dosyalarda bir kalıbı tekrarlı olarak ara, eşleşmelerin satır numaralarını göster, binary dosyaları göz ardı et: -`grep --recursive --line-number --binary-files={{without-match}} "{{aranan_kalıp}}" {{dosya/yolu}}` +`grep {{-r|--recursive}} {{-n|--line-number}} --binary-files={{without-match}} "{{aranan_kalıp}}" {{dosya/yolu}}` - Büyük/küçük harfe duyarsız modda genişletilmiş düzenli ifadeleri (`?`, `+`, `{}`, `()` ve `|` destekler) kullan: -`grep --extended-regexp --ignore-case "{{aranan_kalıp}}" {{dosya/yolu}}` +`grep {{-E|--extended-regexp}} {{-i|--ignore-case}} "{{aranan_kalıp}}" {{dosya/yolu}}` - Her eşleşmenin etrafında, öncesinde veya sonrasında 3 satır içerik yazdır: -`grep --{{context|before-context|after-context}}={{3}} "{{aranan_kalıp}}" {{dosya/yolu}}` +`grep --{{context|before-context|after-context}} 3 "{{aranan_kalıp}}" {{dosya/yolu}}` - Renkli çıktı ile her eşleşme için dosya adını ve satır numarasını yazdır: -`grep --with-filename --line-number --color=always "{{aranan_kalıp}}" {{dosya/yolu}}` +`grep {{-H|--with-filename}} {{-n|--line-number}} --color=always "{{aranan_kalıp}}" {{dosya/yolu}}` - Bir kalıpla eşleşen satırları ara, yalnızca eşleşen metni yazdır: -`grep --only-matching "{{aranan_kalıp}}" {{dosya/yolu}}` +`grep {{-o|--only-matching}} "{{aranan_kalıp}}" {{dosya/yolu}}` - Bir kalıpla eşleşmeyen satırlar için `stdin`'de arama yap: -`cat {{dosya/yolu}} | grep --invert-match "{{aranan_kalıp}}"` +`cat {{dosya/yolu}} | grep {{-v|--invert-match}} "{{aranan_kalıp}}"` diff --git a/pages.tr/common/man.md b/pages.tr/common/man.md index 5d1551170..64a61f31a 100644 --- a/pages.tr/common/man.md +++ b/pages.tr/common/man.md @@ -1,7 +1,7 @@ # man > Kılavuz sayfalarını biçimlendir ve göster. -> Daha fazla bilgi için: . +> Daha fazla bilgi için: . - Bir komut için man sayfasını görüntüle: diff --git a/pages.tr/common/pio-init.md b/pages.tr/common/pio-init.md index 26feb0084..d2b455fc8 100644 --- a/pages.tr/common/pio-init.md +++ b/pages.tr/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > Bu komut `pio project` için bir takma addır. diff --git a/pages.tr/common/tlmgr-arch.md b/pages.tr/common/tlmgr-arch.md index 9467e04b8..dacc90214 100644 --- a/pages.tr/common/tlmgr-arch.md +++ b/pages.tr/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > Bu komut `tlmgr platform` için bir takma addır. > Daha fazla bilgi için: . diff --git a/pages.tr/common/tree.md b/pages.tr/common/tree.md index d4fcf55d6..898f58bf3 100644 --- a/pages.tr/common/tree.md +++ b/pages.tr/common/tree.md @@ -1,7 +1,7 @@ # tree > Mevcut dizinin içeriğini ağaç biçiminde göster. -> Daha fazla bilgi için: . +> Daha fazla bilgi için: . - Dosya ve dizinleri `num` değeri kadar derinlikte göster (1 olması durumunda mevcut dizin gösterilir): diff --git a/pages.tr/linux/ip-link.md b/pages.tr/linux/ip-link.md index 92b062c6f..1102d75c6 100644 --- a/pages.tr/linux/ip-link.md +++ b/pages.tr/linux/ip-link.md @@ -1,7 +1,7 @@ # ip link > Ağ arayüzlerini yönet. -> Daha fazla bilgi için: . +> Daha fazla bilgi için: . - Tüm ağ arayüzleriyle ilgili bilgileri göster: diff --git a/pages.tr/linux/ip-route-list.md b/pages.tr/linux/ip-route-list.md index cccb46f6f..179527433 100644 --- a/pages.tr/linux/ip-route-list.md +++ b/pages.tr/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> Bu komut `ip-route-show` için bir takma addır. +> Bu komut `ip route show`.için bir takma addır. - Asıl komutun belgelerini görüntüleyin: diff --git a/pages.tr/linux/ip-rule.md b/pages.tr/linux/ip-rule.md index 8cc1341d8..ddd069212 100644 --- a/pages.tr/linux/ip-rule.md +++ b/pages.tr/linux/ip-rule.md @@ -1,7 +1,7 @@ # ip rule > IP yönlendirme politikası veri tabanı yönetimi. -> Daha fazla bilgi için: . +> Daha fazla bilgi için: . - Yönlendirme politikasını göster: diff --git a/pages.tr/linux/ip.md b/pages.tr/linux/ip.md index 00cba00b2..5b02cc694 100644 --- a/pages.tr/linux/ip.md +++ b/pages.tr/linux/ip.md @@ -2,7 +2,7 @@ > Yönlendirmeyi, aygıtları, kural yönlendirmesini ve tünelleri görüntüle / değiştir. > `ip address` gibi bazı alt komutların kendi kullanım belgeleri vardır. -> Daha fazla bilgi için: . +> Daha fazla bilgi için: . - Arayüzlerin bilgilerini ayrıntılı bir şekilde listele: diff --git a/pages.tr/linux/pulseaudio.md b/pages.tr/linux/pulseaudio.md index 9abd1abbd..bc6e39d41 100644 --- a/pages.tr/linux/pulseaudio.md +++ b/pages.tr/linux/pulseaudio.md @@ -11,7 +11,7 @@ `pulseaudio --start` -- Arkaplanda çalışan tüm pulseaudio uygulamalarını öldür: +- Arkaplanda çalışan tüm PulseAudio uygulamalarını öldür: `pulseaudio --kill` diff --git a/pages.tr/linux/pw-cli.md b/pages.tr/linux/pw-cli.md index 7e876735a..701095dbc 100644 --- a/pages.tr/linux/pw-cli.md +++ b/pages.tr/linux/pw-cli.md @@ -1,7 +1,7 @@ # pw-cli > Pipewire komut satır arayüzü. -> Daha fazla bilgi için: . +> Daha fazla bilgi için: . - Tüm düğümleri (taban ve kaynakları) ID'leri ile birlikte yazdır: diff --git a/pages.tr/sunos/prstat.md b/pages.tr/sunos/prstat.md index 7b1d2f1c5..c6ea309da 100644 --- a/pages.tr/sunos/prstat.md +++ b/pages.tr/sunos/prstat.md @@ -21,4 +21,4 @@ - Saniye başı en çok CPU kullanan 5 işlemin listesini yazdır: -`prstat -c -n {{5}} -s cpu {{1}}` +`prstat -c -n 5 -s cpu 1` diff --git a/pages.uk/android/logcat.md b/pages.uk/android/logcat.md index 3646dd078..380670e47 100644 --- a/pages.uk/android/logcat.md +++ b/pages.uk/android/logcat.md @@ -17,8 +17,8 @@ - Вивести логи для специфічного процесу (PID): -`logcat --pid={{pid}}` +`logcat --pid {{pid}}` - Вивести логи для процесу специфічного пакету: -`logcat --pid=$(pidof -s {{пакет}})` +`logcat --pid $(pidof -s {{пакет}})` diff --git a/pages.uk/common/clamav.md b/pages.uk/common/clamav.md index 67cad0380..e41057275 100644 --- a/pages.uk/common/clamav.md +++ b/pages.uk/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > Ця команда є псевдонімом для `clamdscan`. > Більше інформації: . diff --git a/pages.uk/common/fossil-ci.md b/pages.uk/common/fossil-ci.md index 0fc67574d..ecf19d5c6 100644 --- a/pages.uk/common/fossil-ci.md +++ b/pages.uk/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> Ця команда є псевдонімом для `fossil-commit`. +> Ця команда є псевдонімом для `fossil commit`. > Більше інформації: . - Дивись документацію для оригінальної команди: diff --git a/pages.uk/common/fossil-delete.md b/pages.uk/common/fossil-delete.md index dd111656f..d93e53f78 100644 --- a/pages.uk/common/fossil-delete.md +++ b/pages.uk/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > Ця команда є псевдонімом для `fossil rm`. > Більше інформації: . diff --git a/pages.uk/common/fossil-forget.md b/pages.uk/common/fossil-forget.md index 216d0fd1e..da9594f48 100644 --- a/pages.uk/common/fossil-forget.md +++ b/pages.uk/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > Ця команда є псевдонімом для `fossil rm`. > Більше інформації: . diff --git a/pages.uk/common/fossil-new.md b/pages.uk/common/fossil-new.md index f2a0c6d72..c733073c2 100644 --- a/pages.uk/common/fossil-new.md +++ b/pages.uk/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> Ця команда є псевдонімом для `fossil-init`. +> Ця команда є псевдонімом для `fossil init`. > Більше інформації: . - Дивись документацію для оригінальної команди: diff --git a/pages.uk/common/gh-cs.md b/pages.uk/common/gh-cs.md index 48e6f38b1..29b253818 100644 --- a/pages.uk/common/gh-cs.md +++ b/pages.uk/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> Ця команда є псевдонімом для `gh-codespace`. +> Ця команда є псевдонімом для `gh codespace`. > Більше інформації: . - Дивись документацію для оригінальної команди: diff --git a/pages.uk/common/gnmic-sub.md b/pages.uk/common/gnmic-sub.md index 6d6c3aab4..494034553 100644 --- a/pages.uk/common/gnmic-sub.md +++ b/pages.uk/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > Ця команда є псевдонімом для `gnmic subscribe`. > Більше інформації: . diff --git a/pages.uk/common/pio-init.md b/pages.uk/common/pio-init.md index 7b3979156..40816cad2 100644 --- a/pages.uk/common/pio-init.md +++ b/pages.uk/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > Ця команда є псевдонімом для `pio project`. diff --git a/pages.uk/common/tlmgr-arch.md b/pages.uk/common/tlmgr-arch.md index 1586c3cc9..f2469dce1 100644 --- a/pages.uk/common/tlmgr-arch.md +++ b/pages.uk/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > Ця команда є псевдонімом для `tlmgr platform`. > Більше інформації: . diff --git a/pages.uk/linux/adduser.md b/pages.uk/linux/adduser.md new file mode 100644 index 000000000..6b66dc41d --- /dev/null +++ b/pages.uk/linux/adduser.md @@ -0,0 +1,24 @@ +# adduser + +> Утиліта додавання користувачів. +> Більше інформації: . + +- Створити нового користувача з домашнім каталогом за замовчуванням і попросити користувача встановити пароль: + +`adduser {{юзернейм}}` + +- Створити нового користувача без домашнього каталогу: + +`adduser --no-create-home {{юзернейм}}` + +- Створити нового користувача з домашнім каталогом за вказаним шляхом: + +`adduser --home {{шлях/до/дому}} {{юзернейм}}` + +- Створити нового користувача з указаною оболонкою, встановленою як оболонка входу: + +`adduser --shell {{шлях/до/оболонки}} {{юзернейм}}` + +- Створити нового користувача, що належить до вказаної групи: + +`adduser --ingroup {{група}} {{юзернейм}}` diff --git a/pages.uk/linux/apt-add-repository.md b/pages.uk/linux/apt-add-repository.md new file mode 100644 index 000000000..5a9573049 --- /dev/null +++ b/pages.uk/linux/apt-add-repository.md @@ -0,0 +1,20 @@ +# apt-add-repository + +> Керує взаємодією з репозиторіями `apt`. +> Більше інформації: . + +- Додайте новий репозиторій `apt`: + +`apt-add-repository {{репозиторій}}` + +- Видалити репозиторій `apt`: + +`apt-add-repository --remove {{репозиторій}}` + +- Оновити кеш пакетів після додавання репозиторію: + +`apt-add-repository --update {{репозиторій}}` + +- Увімкнути вихідні пакети: + +`apt-add-repository --enable-source {{репозиторій}}` diff --git a/pages.uk/linux/apt-file.md b/pages.uk/linux/apt-file.md new file mode 100644 index 000000000..0823c8e6a --- /dev/null +++ b/pages.uk/linux/apt-file.md @@ -0,0 +1,20 @@ +# apt-file + +> Пошук файлів в пакетах `apt`, включно з тими, що ще не встановлені. +> Більше інформації: . + +- Оновити базу метаданих: + +`sudo apt update` + +- Пошук пакетів, які містять вказаний файл або шлях: + +`apt-file {{search|find}} {{частковий_шлях/до/файлу}}` + +- Список вмісту конкретного пакета: + +`apt-file {{show|list}} {{пакет}}` + +- Пошук пакетів, які відповідають `регулярному_виразу`: + +`apt-file {{search|find}} --regexp {{регулярний_вираз}}` diff --git a/pages.uk/linux/apt-key.md b/pages.uk/linux/apt-key.md new file mode 100644 index 000000000..795942e7a --- /dev/null +++ b/pages.uk/linux/apt-key.md @@ -0,0 +1,25 @@ +# apt-key + +> Утиліта керування ключами для диспетчера пакетів APT в Debian та Ubuntu. +> Примітка: `apt-key` застарілий (за винятком використання `apt-key del` у сценаріях підтримки). +> Більше інформації: . + +- Список довірених ключів: + +`apt-key list` + +- Додати ключ до довіреного сховища ключів: + +`apt-key add {{public_key_file.asc}}` + +- Видалити ключ з довіреного сховища ключів: + +`apt-key del {{key_id}}` + +- Додайте віддалений ключ до надійного сховища ключів: + +`wget -qO - {{https://host.tld/filename.key}} | apt-key add -` + +- Додати ключ із сервера ключів лише з ідентифікатором ключа: + +`apt-key adv --keyserver {{pgp.mit.edu}} --recv {{KEYID}}` diff --git a/pages.uk/linux/apt-moo.md b/pages.uk/linux/apt-moo.md index a9292b17d..5a9d82134 100644 --- a/pages.uk/linux/apt-moo.md +++ b/pages.uk/linux/apt-moo.md @@ -3,6 +3,6 @@ > Пасхалка від менеджеру пакетів `APT`. > Більше інформації: . -- Друкує коров'ячу пасхалку: +- Друкує пасхалку з коровою: `apt moo` diff --git a/pages.uk/linux/cat.md b/pages.uk/linux/cat.md new file mode 100644 index 000000000..068bad43a --- /dev/null +++ b/pages.uk/linux/cat.md @@ -0,0 +1,28 @@ +# cat + +> Зчитування та об'єднання файлів. +> Більше інформації: . + +- Вивести вміст файлу в `stdout`: + +`cat {{шлях/до/файлу}}` + +- Об’єднати кілька файлів у вихідний файл: + +`cat {{шлях/до/файлу1 шлях/до/файлу2 ...}} > {{шлях/до/вихідного_файлу}}` + +- Додайте кілька файлів до вихідного файлу: + +`cat {{шлях/до/файлу1 шлях/до/файлу2 ...}} >> {{шлях/до/вихідного_файлу}}` + +- Записати `stdin` у файл: + +`cat - > {{шлях/до/файлу}}` + +- Пронумерувати всі вихідні рядки: + +`cat -n {{шлях/до/файлу}}` + +- Відобразити недруковані символи та пробіли (з префіксом `M-`, якщо не ASCII): + +`cat -v -t -e {{шлях/до/файлу}}` diff --git a/pages.uk/linux/help.md b/pages.uk/linux/help.md new file mode 100644 index 000000000..8eab01fa6 --- /dev/null +++ b/pages.uk/linux/help.md @@ -0,0 +1,28 @@ +# help + +> Відображення інформації про вбудовані команди Bash. +> Більше інформації: . + +- Показати повний список вбудованих команд: + +`help` + +- Надрукувати інструкції щодо використання конструкції циклу `while`: + +`help while` + +- Надрукувати інструкції щодо використання конструкції циклу `for`: + +`help for` + +- Надрукуйте інструкції щодо використання `[[ ]]` для умовних команд: + +`help [[ ]]` + +- Надрукувати інструкцію щодо використання `(( ))` для обчислення математичних виразів: + +`help \( \)` + +- Надрукувати інструкції щодо використання команди `cd`: + +`help cd` diff --git a/pages.uk/linux/ip-route-list.md b/pages.uk/linux/ip-route-list.md index 8767b962e..62d322023 100644 --- a/pages.uk/linux/ip-route-list.md +++ b/pages.uk/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> Ця команда є псевдонімом для `ip-route-show`. +> Ця команда є псевдонімом для `ip route show`. - Дивись документацію для оригінальної команди: diff --git a/pages.uk/linux/locale.md b/pages.uk/linux/locale.md new file mode 100644 index 000000000..3fd20a571 --- /dev/null +++ b/pages.uk/linux/locale.md @@ -0,0 +1,20 @@ +# locale + +> Отримайте інформацію, що стосується локалізації. +> Більше інформації: . + +- Список усіх глобальних змінних середовища, що описують локалізацію користувача: + +`locale` + +- Список всії наявних локалізацій: + +`locale --all-locales` + +- Показати всі доступні локалізації та пов'язані метадані: + +`locale --all-locales --verbose` + +- Відображення поточного формату дати: + +`locale date_fmt` diff --git a/pages.uk/linux/nala.md b/pages.uk/linux/nala.md new file mode 100644 index 000000000..0ae8c9ab3 --- /dev/null +++ b/pages.uk/linux/nala.md @@ -0,0 +1,37 @@ +# nala + +> Утиліта керування пакетами з кращим форматуванням. +> Фронтенд для API `python-apt`. +> Більше інформації: . + +- Встановити пакет або оновити його до останньої версії: + +`sudo nala install {{пакет}}` + +- Видалити пакет: + +`sudo nala remove {{пакет}}` + +- Видалити пакет та його конфігураційні файли: + +`nala purge {{пакет}}` + +- Пошук назв пакетів і описів за допомогою слова, регулярного виразу (за замовчуванням) або glob: + +`nala search "{{паттерн}}"` + +- Оновити список доступних пакетів та оновити систему: + +`sudo nala upgrade` + +- Видалити усі невикористовувані пакети та залежності з вашої системи: + +`sudo nala autoremove` + +- Отримати швидші дзеркала, щоб покращити швидкість завантаження: + +`sudo nala fetch` + +- Показати історію всіх транзакцій: + +`nala history` diff --git a/pages.uk/linux/rm.md b/pages.uk/linux/rm.md new file mode 100644 index 000000000..6a9e97633 --- /dev/null +++ b/pages.uk/linux/rm.md @@ -0,0 +1,25 @@ +# rm + +> Видалити файли або директорії. +> Дивіться також: `rmdir`. +> Більше інформації: . + +- Видалити певні файли: + +`rm {{шлях/до/файлу1 шлях/до/файлу2 ...}}` + +- Видалити певні файли, ігноруючи неіснуючі: + +`rm --force {{шлях/до/файлу1 шлях/до/файлу2 ...}}` + +- Видалити певні файли інтерактивно запитуючи перед кожним видаленням: + +`rm --interactive {{шлях/до/файлу1 шлях/до/файлу2 ...}}` + +- Видалити певні файли, друкуючи інформацію про кожне видалення: + +`rm --verbose {{шлях/до/файлу1 шлях/до/файлу2 ...}}` + +- Видалити певні файли та директорії рекурсивно: + +`rm --recursive {{шлях/до/файлу_або_папки1 шлях/до/файлу_або_папки2 ...}}` diff --git a/pages.uk/linux/rpi-eeprom-update.md b/pages.uk/linux/rpi-eeprom-update.md new file mode 100644 index 000000000..d2bb95b4c --- /dev/null +++ b/pages.uk/linux/rpi-eeprom-update.md @@ -0,0 +1,20 @@ +# rpi-eeprom-update + +> Оновити EEPROM та переглянути іншу інформацію про EEPROM. +> Більше інформації: . + +- Переглянути інформацію про поточний встановлений EEPROM raspberry pi: + +`sudo rpi-eeprom-update` + +- Оновити Raspberry Pi EEPROM: + +`sudo rpi-eeprom-update -a` + +- Скасувати незавершене оновлення: + +`sudo rpi-eeprom-update -r` + +- Показати довідку: + +`rpi-eeprom-update -h` diff --git a/pages.uk/linux/sleep.md b/pages.uk/linux/sleep.md new file mode 100644 index 000000000..c66e33c6d --- /dev/null +++ b/pages.uk/linux/sleep.md @@ -0,0 +1,20 @@ +# sleep + +> Затримка на певний час. +> Більше інформації: . + +- Затримка в секундах: + +`sleep {{секунди}}` + +- Затримка в хвилинах (також можна використовувати інші одиниці ([д]ень, [г]одина, [с]екунда, вічність): + +`sleep {{хвилини}}m` + +- Затримка на 1 день 3 години: + +`sleep 1d 3h` + +- Виконати певну команду через 20 хвилин затримки: + +`sleep 20m && {{command}}` diff --git a/pages.uz/android/bugreportz.md b/pages.uz/android/bugreportz.md index 0fb0691a3..d354e75ea 100644 --- a/pages.uz/android/bugreportz.md +++ b/pages.uz/android/bugreportz.md @@ -12,10 +12,10 @@ `bugreportz -p` -- `bugreportz` ni versiyasini ko'rsatish: - -`bugreportz -v` - - Yordam ko'rsatish: `bugreportz -h` + +- Ni versiyasini ko'rsatish `bugreportz`: + +`bugreportz -v` diff --git a/pages.uz/android/dumpsys.md b/pages.uz/android/dumpsys.md index db226f74c..c42d71ba7 100644 --- a/pages.uz/android/dumpsys.md +++ b/pages.uz/android/dumpsys.md @@ -12,7 +12,7 @@ `dumpsys {{service}}` -- `dumpsys` buyrug'idagi barcha xizmatlarni chiqaradi: +- Buyrug'idagi barcha xizmatlarni chiqaradi `dumpsys`: `dumpsys -l` diff --git a/pages.zh/common/!.md b/pages.zh/common/!.md index 3fe21dcae..aeb73c54e 100644 --- a/pages.zh/common/!.md +++ b/pages.zh/common/!.md @@ -22,3 +22,7 @@ - 调取上一个命令的参数给`当前命令`： `{{当前命令}} !*` + +- 调取上一个命令的最后一个参数给`当前命令`： + +`{{当前命令}} !$` diff --git a/pages.zh/common/2to3.md b/pages.zh/common/2to3.md index 451618951..bd32b66cc 100644 --- a/pages.zh/common/2to3.md +++ b/pages.zh/common/2to3.md @@ -13,11 +13,11 @@ - 将 Python 2 语言特性转化为 Python 3： -`2to3 --write {{文件.py}} --fix={{raw_input}} --fix={{print}}` +`2to3 --write {{文件.py}} --fix {{raw_input}} --fix {{print}}` - 除了某个语言特性外将所有其他的 Python 2 语言特性转化为 Python 3： -`2to3 --write {{文件.py}} --nofix={{has_key}} --nofix={{isinstance}}` +`2to3 --write {{文件.py}} --nofix {{has_key}} --nofix {{isinstance}}` - 列出 Python 2 所有可转化为 Python 3 的语言特性： @@ -25,8 +25,8 @@ - 将某一文件夹的所有 Python 2 文件转化为 Python 3： -`2to3 --output-dir={{Python 3 文件夹}} --write-unchanged-files --nobackups {{Python 2 文件夹}}` +`2to3 --output-dir {{Python 3 文件夹}} --write-unchanged-files --nobackups {{Python 2 文件夹}}` - 使用多线程运行 2to3： -`2to3 --processes={{4}} --output-dir={{Python 3 文件夹}} --write --nobackups --no-diff {{Python 2 文件夹}}` +`2to3 --processes {{4}} --output-dir {{Python 3 文件夹}} --write --nobackups --no-diff {{Python 2 文件夹}}` diff --git a/pages.zh/common/7z.md b/pages.zh/common/7z.md index 7849c2875..adabb9986 100644 --- a/pages.zh/common/7z.md +++ b/pages.zh/common/7z.md @@ -30,3 +30,7 @@ - 列出一个归档文件的内容： `7z l {{归档文件.7z}}` + +- 设置压缩级别（数字越高表示压缩越多，但速度更慢）： + +`7z a {{归档文件.7z}} -mx={{0|1|3|5|7|9}} {{文件或目录}}` diff --git a/pages.zh/common/7za.md b/pages.zh/common/7za.md index 368d7eb23..55158f6c6 100644 --- a/pages.zh/common/7za.md +++ b/pages.zh/common/7za.md @@ -10,7 +10,7 @@ - 加密一个已存在的归档文件（包括文件名）： -`7za a {{加密文件.7z}} -p{{密码}} -mhe=on {{归档文件.7z}}` +`7za a {{加密文件.7z}} -p{{密码}} -mhe={{on}} {{归档文件.7z}}` - 提取一个已存在的 7z 文件，并保持原来的目录结构： @@ -26,8 +26,12 @@ - 使用指定的类型来归档文件： -`7za a -t{{7z|bzip2|gzip|lzip|tar|zip}} {{归档文件.7z}} {{文件或目录}}` +`7za a -t{{7z|bzip2|gzip|lzip|tar|...}} {{归档文件.7z}} {{文件或目录}}` - 列出一个归档文件的内容： `7za l {{归档文件.7z}}` + +- 设置压缩级别（数字越高表示压缩越多，但速度更慢）： + +`7za a {{归档文件.7z}} -mx={{0|1|3|5|7|9}} {{文件或目录}}` diff --git a/pages.zh/common/7zr.md b/pages.zh/common/7zr.md index b80c5253a..55ad44983 100644 --- a/pages.zh/common/7zr.md +++ b/pages.zh/common/7zr.md @@ -1,7 +1,7 @@ # 7zr > 一个高压缩率的文件归档器。 -> 类似于 `7z`，只支持 `.7z` 文件。 +> 类似于 `7z`，只支持 7z 文件。 > 更多信息：. - 归档一个文件或目录： @@ -27,3 +27,7 @@ - 列出一个归档文件的内容： `7zr l {{归档文件.7z}}` + +- 设置压缩级别（数字越高表示压缩越多，但速度更慢）： + +`7zr a {{归档文件.7z}} -mx={{0|1|3|5|7|9}} {{文件或目录}}` diff --git a/pages.zh/common/^.md b/pages.zh/common/^.md new file mode 100644 index 000000000..43f572bf8 --- /dev/null +++ b/pages.zh/common/^.md @@ -0,0 +1,17 @@ +# Caret + +> 在 Bash 中，有一个内建命令可以快速替换前一个命令中的字符串并执行结果。 +> 相当于 `!!:s^string1^string2`。 +> 更多信息：. + +- 运行前一个命令，将`字符串1`替换为`字符串2`： + +`^{{字符串1}}^{{字符串2}}` + +- 从前一个命令中移除`字符串1`： + +`^{{字符串1}}^` + +- 在前一个命令中将`字符串1`替换为`字符串2`，并在末尾添加`字符串3`： + +`^{{字符串1}}^{{字符串2}}^{{字符串3}}` diff --git a/pages.zh/common/a2ping.md b/pages.zh/common/a2ping.md new file mode 100644 index 000000000..b76ba436b --- /dev/null +++ b/pages.zh/common/a2ping.md @@ -0,0 +1,32 @@ +# a2ping + +> 将图像转换为 EPS 或 PDF 文件。 +> 更多信息：. + +- 将图像转换为 PDF（注意：指定输出文件名是可选的）： + +`a2ping {{图像文件}} {{输出PDF文件}}` + +- 使用指定的方法压缩文档： + +`a2ping --nocompress {{none|zip|best|flate}} {{文件}}` + +- 如果存在，则扫描 HiResBoundingBox（默认为是）： + +`a2ping --nohires {{文件}}` + +- 允许页面内容位于原点的下方和左侧（默认为否）： + +`a2ping --below {{文件}}` + +- 将额外的参数传递给 `gs`： + +`a2ping --gsextra {{参数}} {{文件}}` + +- 将额外的参数传递给外部程序（如 `pdftops`）： + +`a2ping --extra {{参数}} {{文件}}` + +- 显示帮助信息： + +`a2ping -h` diff --git a/pages.zh/common/ab.md b/pages.zh/common/ab.md index 46143aad8..14499502f 100644 --- a/pages.zh/common/ab.md +++ b/pages.zh/common/ab.md @@ -22,3 +22,7 @@ - 为基准测试设置最大的测试时间（单位：秒）： `ab -t {{60}} {{url}}` + +- 将结果写入到一个 CSV 文件中： + +`ab -e {{路径/到/文件.csv}}` diff --git a/pages.zh/common/accelerate.md b/pages.zh/common/accelerate.md new file mode 100644 index 000000000..5d41e51d5 --- /dev/null +++ b/pages.zh/common/accelerate.md @@ -0,0 +1,28 @@ +# Accelerate + +> 一个使得可以在任何分布式配置中运行相同的 PyTorch 代码的库。 +> 更多信息：. + +- 打印环境信息： + +`accelerate env` + +- 交互式地创建配置文件： + +`accelerate config` + +- 打印使用不同数据类型运行 Hugging Face 模型的估计 GPU 内存成本： + +`accelerate estimate-memory {{名字/模型}}` + +- 测试一个 Accelerate 配置文件： + +`accelerate test --config_file {{路径/到/配置文件.yaml}}` + +- 使用 Accelerate 在 CPU 上运行一个模型： + +`accelerate launch {{路径/到/脚本.py}} {{--cpu}}` + +- 使用 Accelerate 在多 GPU 上运行一个模型，使用 2 台机器： + +`accelerate launch {{路径/到/脚本.py}} --multi_gpu --num_machines 2` diff --git a/pages.zh/common/ack.md b/pages.zh/common/ack.md index 20b220947..4bd164ffb 100644 --- a/pages.zh/common/ack.md +++ b/pages.zh/common/ack.md @@ -18,11 +18,11 @@ - 限制搜索特定类型的文件： -`ack --type={{ruby}} "{{search_pattern}}"` +`ack --type {{ruby}} "{{search_pattern}}"` - 不在特定类型的文件中搜索： -`ack --type=no{{ruby}} "{{search_pattern}}"` +`ack --type no{{ruby}} "{{search_pattern}}"` - 计算找到的匹配文件的总数： diff --git a/pages.zh/common/adb-logcat.md b/pages.zh/common/adb-logcat.md index 436233427..0e8693a45 100644 --- a/pages.zh/common/adb-logcat.md +++ b/pages.zh/common/adb-logcat.md @@ -1,4 +1,4 @@ -# adb-logcat +# adb logcat > 转储系统消息日志。 > 更多信息：. diff --git a/pages.zh/common/age-keygen.md b/pages.zh/common/age-keygen.md new file mode 100644 index 000000000..714e73cf2 --- /dev/null +++ b/pages.zh/common/age-keygen.md @@ -0,0 +1,13 @@ +# age-keygen + +> 生成 `age` 密钥对。 +> 参见：`age` 用于加密/解密文件。 +> 更多信息：. + +- 生成密钥对，将其保存到未加密文件，并将公钥打印到标准输出： + +`age-keygen --output {{路径/到/文件}}` + +- 将身份转换为接收者，并将公钥打印到标准输出： + +`age-keygen -y {{路径/到/文件}}` diff --git a/pages.zh/common/age.md b/pages.zh/common/age.md index 78e8cf3ed..2ceeefd47 100644 --- a/pages.zh/common/age.md +++ b/pages.zh/common/age.md @@ -1,23 +1,20 @@ # age > 一个简单、现代、安全的文件加密工具。 +> 参见：`age-keygen` 用于生成密钥对。 > 更多信息：. - 生成一个可以用密码短语（passphrase）解密的加密文件： `age --passphrase --output {{路径/到/已加密文件}} {{路径/到/未加密文件}}` -- 生成一个密钥对，将私钥保存到一个未加密的文件，并将公钥打印到标准输出： - -`age-keygen --output {{路径/到/文件}}` - - 用一个或多个公钥加密一个文件，这些公钥以字面形式输入： -`age --recipient {{公钥_1}} --recipient {{公钥_2}} {{路径/到/未加密文件}} --output {{路径/到/已加密文件}}` +`age --recipient {{公钥}} --output {{路径/到/已加密文件}} {{路径/到/未加密文件}}` - 用收件人文件中指定的一个或多个公钥来加密一个文件： -`age --recipients-file {{路径/到/收件人文件}} {{路径/到/未加密文件}} --output {{路径/到/已加密文件}}` +`age --recipients-file {{路径/到/收件人文件}} --output {{路径/到/已加密文件}} {{路径/到/未加密文件}}` - 用密码短语解密一个文件： diff --git a/pages.zh/common/airdecap-ng.md b/pages.zh/common/airdecap-ng.md new file mode 100644 index 000000000..88a8219ea --- /dev/null +++ b/pages.zh/common/airdecap-ng.md @@ -0,0 +1,25 @@ +# airdecap-ng + +> 解密 WEP、WPA 或 WPA2 加密的捕获文件。 +> 是 Aircrack-ng 网络软件套件的一部分。 +> 更多信息：. + +- 从开放网络捕获文件中移除无线头，并使用接入点的 MAC 地址进行过滤： + +`airdecap-ng -b {{ap_mac}} {{路径/到/捕获文件.cap}}` + +- 使用十六进制格式的密钥解密 WEP 加密的捕获文件： + +`airdecap-ng -w {{hex_key}} {{路径/到/捕获文件.cap}}` + +- 使用接入点的 ESSID 和密码解密 WPA/WPA2 加密的捕获文件： + +`airdecap-ng -e {{essid}} -p {{密码}} {{路径/到/捕获文件.cap}}` + +- 使用接入点的 ESSID 和密码解密 WPA/WPA2 加密的捕获文件，并保留头部信息： + +`airdecap-ng -l -e {{essid}} -p {{密码}} {{路径/到/捕获文件.cap}}` + +- 使用接入点的 MAC 地址进行过滤，并使用接入点的 ESSID 和密码解密 WPA/WPA2 加密的捕获文件： + +`airdecap-ng -b {{ap_mac}} -e {{essid}} -p {{密码}} {{路径/到/捕获文件.cap}}` diff --git a/pages.zh/common/airodump-ng.md b/pages.zh/common/airodump-ng.md index 169a97ec0..6bdc97d36 100644 --- a/pages.zh/common/airodump-ng.md +++ b/pages.zh/common/airodump-ng.md @@ -6,8 +6,16 @@ - 捕获数据包并显示有关无线网络的信息： -`sudo airodump-ng {{interface}}` +`sudo airodump-ng {{网络接口}}` + +- 捕获数据包并显示关于 5GHz 频段无线网络的信息： + +`sudo airodump-ng {{网络接口}} --band a` + +- 捕获数据包并显示关于 2.4GHz 和 5GHz 频段无线网络的信息： + +`sudo airodump-ng {{网络接口}} --band abg` - 捕获数据包并显示有关无线网络的信息，给定 MAC 地址和信道，并将输出保存到文件中： -`sudo airodump-ng --channel {{信道}} --write {{路径/到/文件}} --bssid {{mac}} {{interface}}` +`sudo airodump-ng --channel {{信道}} --write {{路径/到/文件}} --bssid {{mac}} {{网络接口}}` diff --git a/pages.zh/common/airshare.md b/pages.zh/common/airshare.md new file mode 100644 index 000000000..6a299e2f6 --- /dev/null +++ b/pages.zh/common/airshare.md @@ -0,0 +1,28 @@ +# airshare + +> 在本地网络中传输数据的工具。 +> 更多信息：. + +- 共享文件或目录： + +`airshare {{code}} {{路径/到/文件或目录1 路径/到/文件或目录2 ...}}` + +- 接收文件： + +`airshare {{code}}` + +- 主机接收服务器（使用此选项可以通过 Web 接口上传文件）： + +`airshare --upload {{code}}` + +- 将文件或目录发送到接收服务器： + +`airshare --upload {{code}} {{路径/到/文件或目录1 路径/到/文件或目录2 ...}}` + +- 发送已复制到剪贴板的文件路径： + +`airshare --file-path {{code}}` + +- 接收文件并将其复制到剪贴板： + +`airshare --clip-receive {{code}}` diff --git a/pages.zh/common/alacritty.md b/pages.zh/common/alacritty.md index e4bef929c..c106fd7de 100644 --- a/pages.zh/common/alacritty.md +++ b/pages.zh/common/alacritty.md @@ -15,10 +15,10 @@ `alacritty -e {{命令}}` -- 指定备用配置文件（默认在 `$XDG_CONFIG_HOME/alacritty/alacritty.yml`）： +- 指定备用配置文件（默认在 `$XDG_CONFIG_HOME/alacritty/alacritty.toml`）： -`alacritty --config-file {{路径/config.yml}}` +`alacritty --config-file {{路径/config.toml}}` -- 在启用实时配置重新加载的情况下运行（默认情况下也可以在 `alacritty.yml` 中启用）： +- 在启用实时配置重新加载的情况下运行（默认情况下也可以在 `alacritty.toml` 中启用）： -`alacritty --live-config-reload --config-file {{路径/config.yml}}` +`alacritty --live-config-reload --config-file {{路径/config.toml}}` diff --git a/pages.zh/common/alex.md b/pages.zh/common/alex.md new file mode 100644 index 000000000..fc34a2a74 --- /dev/null +++ b/pages.zh/common/alex.md @@ -0,0 +1,20 @@ +# alex + +> 捕捉文本中的不敏感、不考虑他人的写作风格。它帮助您找出文本中的性别偏向、极端化、种族相关、宗教考虑不周等不平等表达。 +> 更多信息：. + +- 从标准输入分析文本： + +`echo {{His network looks good}} | alex --stdin` + +- 分析当前目录中的所有文件： + +`alex` + +- 分析特定文件： + +`alex {{路径/到/文件.md}}` + +- 分析除了 `示例文件.md` 之外的所有 Markdown 文件： + +`alex *.md !{{示例文件.md}}` diff --git a/pages.zh/common/alias.md b/pages.zh/common/alias.md index 7593f723c..a65d1faa6 100644 --- a/pages.zh/common/alias.md +++ b/pages.zh/common/alias.md @@ -1,9 +1,13 @@ # alias -> 创建别名 -- 用给定的字符串指代特定的命令。 -> 别名只会在当前的 shell 会话中生效，除非它们在 shell 的配置文件中被定义，例如`~/.bashrc`. +> 创建别名——用给定的字符串指代特定的命令。 +> 别名只会在当前的 shell 会话中生效，除非它们在 shell 的配置文件中被定义，例如`~/.bashrc`。 > 更多信息：. +- 列出所有别名： + +`alias` + - 创建一个通用的别名： `alias {{别名}}="{{命令}}"` diff --git a/pages.zh/common/amass.md b/pages.zh/common/amass.md index c465781cd..7c8999632 100644 --- a/pages.zh/common/amass.md +++ b/pages.zh/common/amass.md @@ -1,20 +1,20 @@ # amass > 深度攻击面探测与资产发现工具。 -> 此命令也有关于其子命令的文件，例如：`amass db`. -> 更多信息：. +> 此命令也有关于其子命令的文件，例如：`amass intel`. +> 更多信息：. - 执行 Amass 子命令： -`amass {{子命令}}` +`amass {{intel|enum}} {{options}}` - 展示帮助信息： `amass -help` -- 展示子命令帮助信息（如 `intel`、`enum` 等）： +- 展示子命令帮助信息： -`amass -help {{子命令}}` +`amass {{intel|enum}} -help` - 查看 Amass 版本： diff --git a/pages.zh/common/bat.md b/pages.zh/common/bat.md index 4be93b4ba..67903e2fa 100644 --- a/pages.zh/common/bat.md +++ b/pages.zh/common/bat.md @@ -20,7 +20,7 @@ `bat --number {{文件}}` -- 高亮一个 `json` 文件： +- 高亮一个 JSON 文件： `bat --language json {{文件.json}}` diff --git a/pages.zh/common/bc.md b/pages.zh/common/bc.md index 8b726d66e..d172231d4 100644 --- a/pages.zh/common/bc.md +++ b/pages.zh/common/bc.md @@ -2,7 +2,7 @@ > 一个任意精度计算器语言。 > 另请参阅：`dc`. -> 更多信息：. +> 更多信息：. - 启动交互式会话： diff --git a/pages.zh/common/browser-sync.md b/pages.zh/common/browser-sync.md index d4711c9b9..eabed6d20 100644 --- a/pages.zh/common/browser-sync.md +++ b/pages.zh/common/browser-sync.md @@ -7,7 +7,7 @@ `browser-sync start --server {{路径/到/目录}} --files {{路径/到/目录}}` -- 启动当前目录服务，同时监听指定目录下 `css` 文件的变动： +- 启动当前目录服务，同时监听指定目录下 CSS 文件的变动： `browser-sync start --server --files '{{路径/到/目录/*.css}}'` diff --git a/pages.zh/common/cargo-add.md b/pages.zh/common/cargo-add.md new file mode 100644 index 000000000..1591de386 --- /dev/null +++ b/pages.zh/common/cargo-add.md @@ -0,0 +1,32 @@ +# cargo add + +> 向 Rust 项目的 `Cargo.toml` 文件添加依赖项。 +> 更多信息：. + +- 将最新版本的依赖项添加到当前项目： + +`cargo add {{依赖项}}` + +- 添加特定版本的依赖项： + +`cargo add {{依赖项}}@{{版本号}}` + +- 添加依赖项并启动一个或多个特定功能： + +`cargo add {{依赖项}} --features {{功能1}},{{功能2}}` + +- 添加一个可选的依赖项，然后将其作为包(crate)的一个功能暴露出来： + +`cargo add {{依赖项}} --optional` + +- 将本地包(crate)添加为依赖项： + +`cargo add --path {{path/to/directory}}` + +- 添加一个开发或构建依赖项： + +`cargo add {{依赖项}} --{{dev|build}}` + +- 添加一个禁用所有默认功能的依赖项： + +`cargo add {{依赖项}} --no-default-features` diff --git a/pages.zh/common/cargo-bench.md b/pages.zh/common/cargo-bench.md new file mode 100644 index 000000000..17e3fedb5 --- /dev/null +++ b/pages.zh/common/cargo-bench.md @@ -0,0 +1,36 @@ +# cargo bench + +> 编译并执行基准测试。 +> 更多信息：. + +- 执行包的所有基准测试： + +`cargo bench` + +- 在基准测试失败时不停止： + +`cargo bench --no-fail-fast` + +- 编译，但不运行基准测试： + +`cargo bench --no-run` + +- 对指定的基准进行基准测试： + +`cargo bench --bench {{基准测试名称}}` + +- 使用给定的配置文件进行基准测试 (默认为 `bench`)： + +`cargo bench --profile {{配置文件}}` + +- 对所有示例目标进行基准测试： + +`cargo bench --examples` + +- 对所有二进制目标进行基准测试： + +`cargo bench --bins` + +- 对包的库(lib)进行基准测试： + +`cargo bench --lib` diff --git a/pages.zh/common/cargo-build.md b/pages.zh/common/cargo-build.md new file mode 100644 index 000000000..b3f1b5682 --- /dev/null +++ b/pages.zh/common/cargo-build.md @@ -0,0 +1,32 @@ +# cargo build + +> 编译本地包及其所有依赖项。 +> 更多信息：. + +- 在本地路径中构建由 `Cargo.toml` 清单文件定义的一个或多个包： + +`cargo build` + +- 以 release 模式构建，并进行优化： + +`cargo build --release` + +- 要求 `Cargo.lock` 文件为最新版本： + +`cargo build --locked` + +- 构建工作区中的所有包： + +`cargo build --workspace` + +- 构建特定的包： + +`cargo build --package {{包名}}` + +- 仅构建指定的二进制文件： + +`cargo build --bin {{名称}}` + +- 仅构建指定的测试目标： + +`cargo build --test {{测试名称}}` diff --git a/pages.zh/common/cargo-check.md b/pages.zh/common/cargo-check.md new file mode 100644 index 000000000..56ef1fbf4 --- /dev/null +++ b/pages.zh/common/cargo-check.md @@ -0,0 +1,24 @@ +# cargo check + +> 检查本地软件包及其所有依赖包是否有错误。 +> 更多信息：. + +- 检查当前包： + +`cargo check` + +- 检查所有测试： + +`cargo check --tests` + +- 检查 `tests/integration_test1.rs` 中的集成测试： + +`cargo check --test {{integration_test1}}` + +- 使用 `feature1` 和 `feature2` 功能检查当前包： + +`cargo check --features {{feature1,feature2}}` + +- 禁用默认功能后检测当前包： + +`cargo check --no-default-features` diff --git a/pages.zh/common/cargo-clean.md b/pages.zh/common/cargo-clean.md new file mode 100644 index 000000000..2f6554b8f --- /dev/null +++ b/pages.zh/common/cargo-clean.md @@ -0,0 +1,20 @@ +# cargo clean + +> 删除 `target` 目录中生成的构建产物。 +> 更多信息：. + +- 删除整个 `target` 目录： + +`cargo clean` + +- 删除文档构建产物 (`target/doc` 目录)： + +`cargo clean --doc` + +- 删除 release 模式的构建产物 (`target/release` 目录)： + +`cargo clean --release` + +- 删除给定配置文件的目录中的构建产物（在本例中为 `target/debug`)： + +`cargo clean --profile {{dev}}` diff --git a/pages.zh/common/cargo-clippy.md b/pages.zh/common/cargo-clippy.md new file mode 100644 index 000000000..f18762d64 --- /dev/null +++ b/pages.zh/common/cargo-clippy.md @@ -0,0 +1,32 @@ +# cargo clippy + +> 一系列 lint 工具，用于捕获常见错误并改进 Rust 代码。 +> 更多信息：. + +- 对当前目录中的代码运行检查： + +`cargo clippy` + +- 要求 `Cargo.lock` 文件是最新的： + +`cargo clippy --locked` + +- 对工作区中的所有包进行检查： + +`cargo clippy --workspace` + +- 对某个包进行检查： + +`cargo clippy --package {{包名}}` + +- 将警告视为错误： + +`cargo clippy -- --deny warnings` + +- 运行检查并忽略警告： + +`cargo clippy -- --allow warnings` + +- 自动应用 Clippy 的建议： + +`cargo clippy --fix` diff --git a/pages.zh/common/cargo-doc.md b/pages.zh/common/cargo-doc.md new file mode 100644 index 000000000..a4d158cdb --- /dev/null +++ b/pages.zh/common/cargo-doc.md @@ -0,0 +1,20 @@ +# cargo doc + +> 构建 Rust 包的文档。 +> 更多信息：. + +- 为当前项目及所有依赖项构建文档： + +`cargo doc` + +- 不为依赖项构建文档： + +`cargo doc --no-deps` + +- 构建并在浏览器中打开文档： + +`cargo doc --open` + +- 构建并查看特定包的文档： + +`cargo doc --open --package {{包名}}` diff --git a/pages.zh/common/cargo-fetch.md b/pages.zh/common/cargo-fetch.md new file mode 100644 index 000000000..36f3ccac6 --- /dev/null +++ b/pages.zh/common/cargo-fetch.md @@ -0,0 +1,12 @@ +# cargo fetch + +> 从网络获取包的依赖项。 +> 更多信息：. + +- 获取 `Cargo.lock` 中指定的依赖项 (对所有目标)： + +`cargo fetch` + +- 为指定目标获取依赖项： + +`cargo fetch --target {{目标三元组}}` diff --git a/pages.zh/common/cargo-fix.md b/pages.zh/common/cargo-fix.md new file mode 100644 index 000000000..6418fea88 --- /dev/null +++ b/pages.zh/common/cargo-fix.md @@ -0,0 +1,28 @@ +# cargo fix + +> 自动修复 `rustc` 报告的 lint 警告。 +> 更多信息：. + +- 即使已经有编译器错误，也要修复代码： + +`cargo fix --broken-code` + +- 即使工作目录有更改，也要修复代码： + +`cargo fix --allow-dirty` + +- 将一个包迁移到下一个 Rust 版本： + +`cargo fix --edition` + +- 修复包的库： + +`cargo fix --lib` + +- 修复指定的集成测试： + +`cargo fix --test {{名称}}` + +- 修复工作区中的所有成员： + +`cargo fix --workspace` diff --git a/pages.zh/common/cargo-fmt.md b/pages.zh/common/cargo-fmt.md new file mode 100644 index 000000000..68da445e0 --- /dev/null +++ b/pages.zh/common/cargo-fmt.md @@ -0,0 +1,16 @@ +# cargo fmt + +> 在 Rust 项目中对所有源文件运行 `rustfmt`。 +> 更多信息：. + +- 格式化所有源文件： + +`cargo fmt` + +- 检查格式错误，不对文件进行写入操作： + +`cargo fmt --check` + +- 将参数传递给每个 rustfmt 调用： + +`cargo fmt -- {{rustfmt参数}}` diff --git a/pages.zh/common/cargo-generate-lockfile.md b/pages.zh/common/cargo-generate-lockfile.md new file mode 100644 index 000000000..2057c0f95 --- /dev/null +++ b/pages.zh/common/cargo-generate-lockfile.md @@ -0,0 +1,9 @@ +# cargo generate-lockfile + +> 为当前包生成 Cargo.lock 文件。类似于 cargo update，但选项更少。 +> 如果锁定文件已经存在，它将使用每个包的最新版本重新构建。 +> 更多信息：. + +- 使用每个包的最新版本生成Cargo.lock文件： + +`cargo generate-lockfile` diff --git a/pages.zh/common/cargo-help.md b/pages.zh/common/cargo-help.md new file mode 100644 index 000000000..97cdac0f6 --- /dev/null +++ b/pages.zh/common/cargo-help.md @@ -0,0 +1,12 @@ +# cargo help + +> 显示有关 cargo 及其子命令的帮助信息。 +> 更多信息：. + +- 显示一般帮助： + +`cargo help` + +- 显示子命令的帮助信息： + +`cargo help {{子命令}}` diff --git a/pages.zh/common/cargo-init.md b/pages.zh/common/cargo-init.md new file mode 100644 index 000000000..5953919a5 --- /dev/null +++ b/pages.zh/common/cargo-init.md @@ -0,0 +1,25 @@ +# cargo init + +> 创建一个新的 Cargo 包。 +> 相当于 `cargo new`，但是指定目录是可选的。 +> 更多信息：. + +- 在当前目录中初始化一个带有二进制目标的 Rust 项目： + +`cargo init` + +- 在指定目录中初始化一个带有二进制目标的 Rust 项目： + +`cargo init {{path/to/directory}}` + +- 在当前目录中初始化一个带有库目标的 Rust 项目： + +`cargo init --lib` + +- 在项目目录中初始化版本控制系统仓库 (默认为git)： + +`cargo init --vcs {{git|hg|pijul|fossil|none}}` + +- 设置包名称 (默认为目录名称)： + +`cargo init --name {{name}}` diff --git a/pages.zh/common/cargo-install.md b/pages.zh/common/cargo-install.md new file mode 100644 index 000000000..b5739f8ad --- /dev/null +++ b/pages.zh/common/cargo-install.md @@ -0,0 +1,20 @@ +# cargo install + +> 构建并安装一个 Rust 二进制文件。 +> 更多信息：. + +- 从 安装一个包 (版本是可选的，默认为最新版本)： + +`cargo install {{包名}}@{{版本号}}` + +- 从指定的 Git 仓库安装一个包： + +`cargo install --git {{仓库URL}}` + +- 从 Git 仓库安装时，根据指定的 branch/tag/commit 构建： + +`cargo install --git {{仓库URL}} --{{branch|tag|rev}} {{branch_name|tag|commit_hash}}` + +- 列出所有已安装的包及其版本： + +`cargo install --list` diff --git a/pages.zh/common/cargo-locate-project.md b/pages.zh/common/cargo-locate-project.md new file mode 100644 index 000000000..4bdf3bac6 --- /dev/null +++ b/pages.zh/common/cargo-locate-project.md @@ -0,0 +1,21 @@ +# cargo locate-project + +> 打印项目的 `Cargo.toml` 清单文件的完整路径。 +> 如果项目是工作区的一部分，则显示项目的清单文件，而不是工作区的清单文件。 +> 更多信息：. + +- 显示包含完整路径到 `Cargo.toml` 清单文件的 JSON 对象： + +`cargo locate-project` + +- 以指定格式显示项目路径： + +`cargo locate-project --message-format {{plain|json}}` + +- 显示位于工作区根目录而不是当前工作区成员的 `Cargo.toml` 清单文件： + +`cargo locate-project --workspace` + +- 显示特定目录中的 `Cargo.toml` 清单文件： + +`cargo locate-project --manifest-path {{path/to/Cargo.toml}}` diff --git a/pages.zh/common/cargo-login.md b/pages.zh/common/cargo-login.md new file mode 100644 index 000000000..4e7f2af65 --- /dev/null +++ b/pages.zh/common/cargo-login.md @@ -0,0 +1,13 @@ +# cargo login + +> 将 API 令牌保存到本地的凭据存储中。 +> 该令牌用于对包注册表进行身份验证。您可以使用 `cargo logout` 来删除它。 +> 更多信息：. + +- 将 API 令牌添加到本地凭据存储中 (位于 `$CARGO_HOME/credentials.toml`)： + +`cargo login` + +- 使用指定的注册表 (注册表名称可以在配置中定义，默认为 )： + +`cargo login --registry {{名称}}` diff --git a/pages.zh/common/cargo-logout.md b/pages.zh/common/cargo-logout.md new file mode 100644 index 000000000..9452d4c31 --- /dev/null +++ b/pages.zh/common/cargo-logout.md @@ -0,0 +1,13 @@ +# cargo logout + +> 从本地注册表中删除 API 令牌。 +> 该令牌用于对包注册表进行身份验证。您可以使用 `cargo login` 将其添加回来。 +> 更多信息：. + +- 从本地凭据存储中 (位于 `$CARGO_HOME/credentials.toml`) 移除 API 令牌： + +`cargo logout` + +- 使用指定的注册表 (注册表名称可以在配置中定义，默认为 )： + +`cargo logout --registry {{名称}}` diff --git a/pages.zh/common/cargo-metadata.md b/pages.zh/common/cargo-metadata.md new file mode 100644 index 000000000..0f8609fa4 --- /dev/null +++ b/pages.zh/common/cargo-metadata.md @@ -0,0 +1,21 @@ +# cargo metadata + +> 以 JSON 格式输出当前包的工作空间成员和已解析的依赖关系。 +> 注意：输出格式可能在未来的 Cargo 版本中发生变化。 +> 更多信息：. + +- 打印当前包的工作空间成员和已解析的依赖关系： + +`cargo metadata` + +- 仅打印工作空间成员，不获取依赖项： + +`cargo metadata --no-deps` + +- 根据指定版本打印特定格式的元数据： + +`cargo metadata --format-version {{版本号}}` + +- 打印带有 `resolve` 字段的元数据，仅包括给定目标三元组的依赖关系 (注意：`packages` 数组仍将包括所有目标的依赖关系)： + +`cargo metadata --filter-platform {{目标三元组}}` diff --git a/pages.zh/common/cargo-new.md b/pages.zh/common/cargo-new.md new file mode 100644 index 000000000..fcfe93660 --- /dev/null +++ b/pages.zh/common/cargo-new.md @@ -0,0 +1,9 @@ +# cargo new + +> 创建一个新的 Cargo 包。 +> 相当于 `cargo init`，但是需要指定一个目录。 +> 更多信息：. + +- 使用二进制目标创建一个新的 Rust 项目： + +`cargo new {{path/to/directory}}` diff --git a/pages.zh/common/cargo-owner.md b/pages.zh/common/cargo-owner.md new file mode 100644 index 000000000..1994184e1 --- /dev/null +++ b/pages.zh/common/cargo-owner.md @@ -0,0 +1,20 @@ +# cargo owner + +> 管理包在注册表上的所有者。 +> 更多信息：. + +- 邀请指定的用户或团队作为所有者： + +`cargo owner --add {{用户名|github:机构名称:团队名称}} {{包名}}` + +- 将指定的用户或团队从所有者中删除： + +`cargo owner --remove {{用户名|github:机构名称:团队名称}} {{包名}}` + +- 列出一个包的所有者： + +`cargo owner --list {{包名}}` + +- 使用指定的注册表 (注册表名称可以在配置中定义，默认为 )： + +`cargo owner --registry {{名称}}` diff --git a/pages.zh/common/cargo-package.md b/pages.zh/common/cargo-package.md new file mode 100644 index 000000000..336f7b519 --- /dev/null +++ b/pages.zh/common/cargo-package.md @@ -0,0 +1,13 @@ +# cargo package + +> 将本地包装成一个可分发的 tarball 文件（`.crate` 文件）。 +> 类似于 `cargo publish --dry-run`，但具有更多选项。 +> 更多信息：. + +- 执行检查并创建一个 `.crate` 文件 (相当于 `cargo publish --dry-run`)： + +`cargo package` + +- 显示将包含在tarball中的文件，而不实际创建它： + +`cargo package --list` diff --git a/pages.zh/common/cargo-pkgid.md b/pages.zh/common/cargo-pkgid.md new file mode 100644 index 000000000..27d92ca1c --- /dev/null +++ b/pages.zh/common/cargo-pkgid.md @@ -0,0 +1,12 @@ +# cargo pkgid + +> 打印当前工作空间中包或依赖项的完全限定包 ID 指定符。 +> 更多信息：. + +- 打印当前项目的完全限定包规范： + +`cargo pkgid` + +- 打印指定包的完全限定包规范： + +`cargo pkgid {{部分包规范}}` diff --git a/pages.zh/common/cargo-publish.md b/pages.zh/common/cargo-publish.md new file mode 100644 index 000000000..c22e7494f --- /dev/null +++ b/pages.zh/common/cargo-publish.md @@ -0,0 +1,17 @@ +# cargo publish + +> 将包上传到注册表。 +> 注意：在发布包之前，您必须使用 `cargo login` 添加身份验证令牌。 +> 更多信息：. + +- 执行检查，创建一个 `.crate` 文件并将其上传到注册表： + +`cargo publish` + +- 执行检查，创建一个 `.crate` 文件，但不上传它 (相当于 `cargo package`)： + +`cargo publish --dry-run` + +- 使用指定的注册表 (注册表名称可以在配置中定义，默认为 )： + +`cargo publish --registry {{名称}}` diff --git a/pages.zh/common/cargo-remove.md b/pages.zh/common/cargo-remove.md new file mode 100644 index 000000000..11daef929 --- /dev/null +++ b/pages.zh/common/cargo-remove.md @@ -0,0 +1,16 @@ +# cargo remove + +> 从 Rust 项目的 `Cargo.toml` 清单中移除依赖关系。 +> 更多信息：. + +- 从当前项目中移除一个依赖项： + +`cargo remove {{依赖项}}` + +- 移除开发或构建依赖项： + +`cargo remove --{{dev|build}} {{依赖项}}` + +- 移除给定目标平台的依赖项： + +`cargo remove --target {{目标平台}} {{依赖项}}` diff --git a/pages.zh/common/cargo-report.md b/pages.zh/common/cargo-report.md new file mode 100644 index 000000000..4ef9fbc20 --- /dev/null +++ b/pages.zh/common/cargo-report.md @@ -0,0 +1,16 @@ +# cargo report + +> 显示各种类型的报告。 +> 更多信息：. + +- 显示一个报告： + +`cargo report {{future-incompatibilities|...}}` + +- 显示具有指定由 Cargo 生成的 id 的报告： + +`cargo report {{future-incompatibilities|...}} --id {{id}}` + +- 为指定的包显示报告： + +`cargo report {{future-incompatibilities|...}} --package {{package}}` diff --git a/pages.zh/common/cargo-run.md b/pages.zh/common/cargo-run.md new file mode 100644 index 000000000..62a3cbae6 --- /dev/null +++ b/pages.zh/common/cargo-run.md @@ -0,0 +1,33 @@ +# cargo run + +> 运行当前的 Cargo 包。 +> 注意: 执行的二进制文件的工作目录将设置为当前工作目录。 +> 更多信息：. + +- 运行默认的二进制目标： + +`cargo run` + +- 运行指定的二进制文件： + +`cargo run --bin {{名称}}` + +- 运行指定的示例： + +`cargo run --example {{示例名}}` + +- 激活一系列以空格或逗号分隔的功能： + +`cargo run --features {{功能1 功能2 ...}}` + +- 禁用默认功能： + +`cargo run --no-default-features` + +- 激活所有可用的功能： + +`cargo run --all-features` + +- 使用指定的配置文件运行： + +`cargo run --profile {{配置文件名称}}` diff --git a/pages.zh/common/cargo-rustc.md b/pages.zh/common/cargo-rustc.md new file mode 100644 index 000000000..9de3b66cb --- /dev/null +++ b/pages.zh/common/cargo-rustc.md @@ -0,0 +1,37 @@ +# cargo rustc + +> 编译一个 Rust 包。类似于 `cargo build`，但您可以向编译器传递额外的选项。 +> 查看 `rustc --help` 获取所有可用选项。 +> 更多信息：. + +- 构建包并向 `rustc` 传递选项： + +`cargo rustc -- {{rustc_options}}` + +- 在 release 模式下构建构建，启用优化： + +`cargo rustc --release` + +- 使用针对当前 CPU 的特定架构优化编译： + +`cargo rustc --release -- -C target-cpu=native` + +- 使用速度优化编译： + +`cargo rustc -- -C opt-level {{1|2|3}}` + +- 使用 [s]ize 优化编译（`z` 也会关闭循环向量化）： + +`cargo rustc -- -C opt-level {{s|z}}` + +- 检查您的包是否使用了不安全的代码： + +`cargo rustc --lib -- -D unsafe-code` + +- 构建特定的包： + +`cargo rustc --package {{package}}` + +- 仅构建指定的二进制文件： + +`cargo --bin {{名称}}` diff --git a/pages.zh/common/cargo-rustdoc.md b/pages.zh/common/cargo-rustdoc.md new file mode 100644 index 000000000..8d96c5474 --- /dev/null +++ b/pages.zh/common/cargo-rustdoc.md @@ -0,0 +1,33 @@ +# cargo rustdoc + +> 构建 Rust 包的文档。 +> 类似于 `cargo doc`，但您可以向 `rustdoc` 传递选项。查看 `rustdoc --help` 获取所有可用选项。 +> 更多信息：. + +- 向 `rustdoc` 传递选项： + +`cargo rustdoc -- {{rustdoc_options}}` + +- 关于文档 lint 发出警告： + +`cargo rustdoc -- --warn rustdoc::{{lint_name}}` + +- 忽略文档 lint: + +`cargo rustdoc -- --allow rustdoc::{{lint_name}}` + +- 为包的库生成文档： + +`cargo rustdoc --lib` + +- 为指定的二进制文件生成文档： + +`cargo rustdoc --bin {{名称}}` + +- 为指定的示例生成文档： + +`cargo rustdoc --example {{名称}}` + +- 为指定的集成测试生成文档： + +`cargo rustdoc --test {{名称}}` diff --git a/pages.zh/common/cargo-search.md b/pages.zh/common/cargo-search.md new file mode 100644 index 000000000..05bb0e347 --- /dev/null +++ b/pages.zh/common/cargo-search.md @@ -0,0 +1,13 @@ +# cargo search + +> 在 https://crates.io 上搜索包。 +> 显示包及其描述，以 TOML 格式显示，可复制到 `Cargo.toml` 中。 +> 更多信息：. + +- 搜索包： + +`cargo search {{查询词}}` + +- 显示 n 个结果 (默认为 10，最多为 100)： + +`cargo search --limit {{n}} {{查询词}}` diff --git a/pages.zh/common/cargo-test.md b/pages.zh/common/cargo-test.md new file mode 100644 index 000000000..eb1b06a4d --- /dev/null +++ b/pages.zh/common/cargo-test.md @@ -0,0 +1,28 @@ +# cargo test + +> 执行 Rust 包的单元测试和集成测试。 +> 更多信息：. + +- 仅运行包含特定字符串在其名称中的测试： + +`cargo test {{测试名称}}` + +- 设置并行运行测试用例的数量： + +`cargo test -- --test-threads {{数量}}` + +- 在 release 模式下测试构建，启用优化： + +`cargo test --release` + +- 测试工作区中的所有包： + +`cargo test --workspace` + +- 为特定包运行测试： + +`cargo test --package {{包名}}` + +- 运行测试时不隐藏测试执行的输出： + +`cargo test -- --nocapture` diff --git a/pages.zh/common/cargo-tree.md b/pages.zh/common/cargo-tree.md new file mode 100644 index 000000000..5c4783f09 --- /dev/null +++ b/pages.zh/common/cargo-tree.md @@ -0,0 +1,25 @@ +# cargo tree + +> 显示依赖图的树形可视化。 +> 注意：在树中，标有 `(*)` 的包的依赖已在图的其他位置显示过，因此不会重复显示。 +> 更多信息：. + +- 显示当前项目的依赖树： + +`cargo tree` + +- 仅显示到指定深度的依赖 (例如，当 `n` 为 1 时，仅显示直接依赖)： + +`cargo tree --depth {{n}}` + +- 在树中不显示给定的包（及其依赖)： + +`cargo tree --prune {{package_spec}}` + +- 显示重复依赖的所有出现： + +`cargo tree --no-dedupe` + +- 仅显示 normal/build/dev 依赖： + +`cargo tree --edges {{normal|build|dev}}` diff --git a/pages.zh/common/cargo-uninstall.md b/pages.zh/common/cargo-uninstall.md new file mode 100644 index 000000000..c6577d4ea --- /dev/null +++ b/pages.zh/common/cargo-uninstall.md @@ -0,0 +1,8 @@ +# cargo uninstall + +> 移除使用 `cargo install` 安装的 Rust 二进制文件。 +> 更多信息：. + +- 移除一个已安装的二进制文件： + +`cargo remove {{package_spec}}` diff --git a/pages.zh/common/cargo-update.md b/pages.zh/common/cargo-update.md new file mode 100644 index 000000000..f92bfa139 --- /dev/null +++ b/pages.zh/common/cargo-update.md @@ -0,0 +1,20 @@ +# cargo update + +> 更新记录在 `Cargo.lock` 中的依赖关系。 +> 更多信息：. + +- 将 `Cargo.lock` 中的依赖项更新为可能的最新版本： + +`cargo update` + +- 显示将会更新的内容，但实际上不写入锁定文件： + +`cargo update --dry-run` + +- 仅更新指定的依赖项： + +`cargo update --package {{依赖项1}} --package {{依赖项2}} --package {{依赖项3}}` + +- 将特定依赖项设置为特定版本： + +`cargo update --package {{依赖项}} --precise {{1.2.3}}` diff --git a/pages.zh/common/cargo-vendor.md b/pages.zh/common/cargo-vendor.md new file mode 100644 index 000000000..48cfa6f43 --- /dev/null +++ b/pages.zh/common/cargo-vendor.md @@ -0,0 +1,8 @@ +# cargo vendor + +> 将项目的所有依赖项存储到指定目录中（默认为 `vendor`）。 +> 更多信息：. + +- 将依赖项存储到指定目录，并配置在当前项目中使用这些存储的源代码： + +`cargo vendor {{path/to/directory}} > .cargo/config.toml` diff --git a/pages.zh/common/cargo-verify-project.md b/pages.zh/common/cargo-verify-project.md new file mode 100644 index 000000000..4e27b5df6 --- /dev/null +++ b/pages.zh/common/cargo-verify-project.md @@ -0,0 +1,12 @@ +# cargo verify-project + +> 检查 `Cargo.toml` 文件清单的正确性，并将结果以 JSON 对象的形式打印出来。 +> 更多信息：. + +- 检查当前项目清单的正确性： + +`cargo verify-project` + +- 检查指定清单文件的正确性： + +`cargo verify-project --manifest-path {{path/to/Cargo.toml}}` diff --git a/pages.zh/common/cargo-version.md b/pages.zh/common/cargo-version.md new file mode 100644 index 000000000..4ac2d6037 --- /dev/null +++ b/pages.zh/common/cargo-version.md @@ -0,0 +1,12 @@ +# cargo version + +> 显示 `cargo` 版本信息。 +> 更多信息：. + +- 显示版本： + +`cargo version` + +- 显示额外的构建信息： + +`cargo version --verbose` diff --git a/pages.zh/common/cargo-yank.md b/pages.zh/common/cargo-yank.md new file mode 100644 index 000000000..225093bd3 --- /dev/null +++ b/pages.zh/common/cargo-yank.md @@ -0,0 +1,17 @@ +# cargo yank + +> 从索引中移除发布的包。应该只在意外发布了一个严重错误的包时使用。 +> 注意：这不会删除任何数据。包在被撤回后仍然存在，只是阻止新项目使用它。 +> 更多信息：. + +- 撤回指定版本的包： + +`cargo yank {{包名}}@{{版本号}}` + +- 撤销撤回 (即允许再次下载)： + +`cargo yank --undo {{包名}}@{{版本号}}` + +- 使用指定的注册表 (注册表名称可以在配置中定义 - 默认为 )： + +`cargo yank --registry {{名称}} {{包名}}@{{版本号}}` diff --git a/pages.zh/common/cargo.md b/pages.zh/common/cargo.md new file mode 100644 index 000000000..71df2f335 --- /dev/null +++ b/pages.zh/common/cargo.md @@ -0,0 +1,37 @@ +# cargo + +> 管理 Rust 项目及其模块依赖项（crates）。 +> 一些子命令，如 `build`，具有自己的用法文档。 +> 更多信息：. + +- 搜索包： + +`cargo search {{搜索关键词}}` + +- 下载二进制包（crate)： + +`cargo install {{包名}}` + +- 列出已安装的二进制包（crate)： + +`cargo install --list` + +- 在指定目录 （或默认情况下在当前工作目录) 中创建一个新的二进制或库 Rust项目： + +`cargo init --{{bin|lib}} {{path/to/directory}}` + +- 向当前目录的 `Cargo.toml` 添加一个依赖： + +`cargo add {{依赖项目}}` + +- 使用 release 模式在当前目录中构建 Rust 项目： + +`cargo build --release` + +- 使用最新的编译器在当前目录中构建 Rust 项目 （需要 `rustup`)： + +`cargo +nightly build` + +- 使用特定数量的线程构建 （默认为逻辑 CPU 的数量)： + +`cargo build --jobs {{线程数}}` diff --git a/pages.zh/common/cat.md b/pages.zh/common/cat.md index 8e5cba7c0..e3ad5f67f 100644 --- a/pages.zh/common/cat.md +++ b/pages.zh/common/cat.md @@ -1,7 +1,7 @@ # cat > 打印和拼接文件的工具。 -> 更多信息：. +> 更多信息：. - 以标准输出，打印文件内容： diff --git a/pages.zh/common/clamav.md b/pages.zh/common/clamav.md index b19d29b96..8801f0e89 100644 --- a/pages.zh/common/clamav.md +++ b/pages.zh/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > 这是 `clamdscan` 命令的一个别名。 > 更多信息：. diff --git a/pages.zh/common/docker-build.md b/pages.zh/common/docker-build.md index f111885bf..ef2e679a0 100644 --- a/pages.zh/common/docker-build.md +++ b/pages.zh/common/docker-build.md @@ -3,19 +3,19 @@ > 从 Dockerfile 打包镜像。 > 更多信息：. -- 使用当前目录下的 Dockerfile 打包一个 docker 镜像： +- 使用当前目录下的 Dockerfile 打包一个 Docker 镜像： `docker build .` -- 从指定 URL 的 Dockerfile 打包 docker 镜像： +- 从指定 URL 的 Dockerfile 打包 Docker 镜像： `docker build {{github.com/creack/docker-firefox}}` -- 打包一个 docker 镜像并指定镜像的标签： +- 打包一个 Docker 镜像并指定镜像的标签： `docker build --tag {{name:tag}} .` -- 打包一个没有上下文的 docker 镜像： +- 打包一个没有上下文的 Docker 镜像： `docker build --tag {{name:tag}} - < {{Dockerfile}}` @@ -23,7 +23,7 @@ `docker build --no-cache --tag {{name:tag}} .` -- 使用指定的 Dockerfile 打包一个 docker 镜像： +- 使用指定的 Dockerfile 打包一个 Docker 镜像： `docker build --file {{Dockerfile}} .` diff --git a/pages.zh/common/docker.md b/pages.zh/common/docker.md index b03608263..5e8f186a1 100644 --- a/pages.zh/common/docker.md +++ b/pages.zh/common/docker.md @@ -4,7 +4,7 @@ > 此命令也有关于其子命令的文件，例如：`docker run`. > 更多信息：. -- 列出所有 docker 容器（包括停止的容器）： +- 列出所有 Docker 容器（包括停止的容器）： `docker ps --all` @@ -16,7 +16,7 @@ `docker {{start|stop}} {{容器名称}}` -- 从 docker registry 中拉取镜像： +- 从 Docker registry 中拉取镜像： `docker pull {{镜像}}` diff --git a/pages.zh/common/duf.md b/pages.zh/common/duf.md new file mode 100644 index 000000000..b12fc48e1 --- /dev/null +++ b/pages.zh/common/duf.md @@ -0,0 +1,32 @@ +# duf + +> 磁盘占用/空闲实用工具。 +> 更多信息：. + +- 列出可访问设备： + +`duf` + +- 列出所有（如伪文件系统，重复文件系统或不可访问的文件系统）： + +`duf --all` + +- 只显示指定的设备或挂载点： + +`duf {{路径/到/文件夹1 路径/到/文件夹2 ...}}` + +- 根据指定条件排序输出： + +`duf --sort {{size|used|avail|usage}}` + +- 显示或隐藏指定文件系统： + +`duf --{{only-fs|hide-fs}} {{tmpfs|vfat|ext4|xfs}}` + +- 根据键排序输出： + +`duf --sort {{mountpoint|size|used|avail|usage|inodes|inodes_used|inodes_avail|inodes_usage|type|filesystem}}` + +- 更改主题（如果 `duf` 未能使用正确的主题）： + +`duf --theme {{dark|light}}` diff --git a/pages.zh/common/fossil-ci.md b/pages.zh/common/fossil-ci.md index 56f461d0d..0b6b62aab 100644 --- a/pages.zh/common/fossil-ci.md +++ b/pages.zh/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> 这是 `fossil-commit` 命令的一个别名。 +> 这是 `fossil commit`.命令的一个别名。 > 更多信息：. - 原命令的文档在： diff --git a/pages.zh/common/fossil-delete.md b/pages.zh/common/fossil-delete.md index 6716215ac..0794c021d 100644 --- a/pages.zh/common/fossil-delete.md +++ b/pages.zh/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > 这是 `fossil rm` 命令的一个别名。 > 更多信息：. diff --git a/pages.zh/common/fossil-forget.md b/pages.zh/common/fossil-forget.md index 576dfbcb0..087c7e5c6 100644 --- a/pages.zh/common/fossil-forget.md +++ b/pages.zh/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > 这是 `fossil rm` 命令的一个别名。 > 更多信息：. diff --git a/pages.zh/common/fossil-new.md b/pages.zh/common/fossil-new.md index d918b27ac..c5844c3f9 100644 --- a/pages.zh/common/fossil-new.md +++ b/pages.zh/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> 这是 `fossil-init` 命令的一个别名。 +> 这是 `fossil init`.命令的一个别名。 > 更多信息：. - 原命令的文档在： diff --git a/pages.zh/common/gh-cs.md b/pages.zh/common/gh-cs.md index df0dcab9f..b81694aa5 100644 --- a/pages.zh/common/gh-cs.md +++ b/pages.zh/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> 这是 `gh-codespace` 命令的一个别名。 +> 这是 `gh codespace`.命令的一个别名。 > 更多信息：. - 原命令的文档在： diff --git a/pages.zh/common/gnmic-sub.md b/pages.zh/common/gnmic-sub.md index 8a922afb4..383a5d184 100644 --- a/pages.zh/common/gnmic-sub.md +++ b/pages.zh/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > 这是 `gnmic subscribe` 命令的一个别名。 > 更多信息：. diff --git a/pages.zh/common/grep.md b/pages.zh/common/grep.md index aaffb8fc5..f19f290f1 100644 --- a/pages.zh/common/grep.md +++ b/pages.zh/common/grep.md @@ -9,28 +9,28 @@ - 在文件中精确地查找字符串（禁用正则表达式）： -`grep --fixed-strings "{{字符串}}" {{路径/到/文件}}` +`grep {{-F|--fixed-strings}} "{{字符串}}" {{路径/到/文件}}` - 在指定目录下的所有文件中递归地查找模式，显示匹配的行号并忽略二进制文件： -`grep --recursive --line-number --binary-files={{without-match}} "{{模式字符串}}" {{路径/到/目录}}` +`grep {{-r|--recursive}} {{-n|--line-number}} --binary-files={{without-match}} "{{模式字符串}}" {{路径/到/目录}}` - 使用大小写不敏感的扩展正则表达式（支持 `?`、`+`、`{}`、`()` 和 `|`）： -`grep --extended-regexp --ignore-case "{{模式字符串}}" {{路径/到/文件}}` +`grep {{-E|--extended-regexp}} {{-i|--ignore-case}} "{{模式字符串}}" {{路径/到/文件}}` - 在每个匹配前后、之前或之后打印 3 行上下文： -`grep --{{context|before-context|after-context}}={{3}} "{{模式字符串}}" {{路径/到/文件}}` +`grep --{{context|before-context|after-context}} 3 "{{模式字符串}}" {{路径/到/文件}}` - 以带有颜色的方式，打印每个匹配的文件名和行号： -`grep --with-filename --line-number --color=always "{{模式字符串}}" {{路径/到/文件}}` +`grep {{-H|--with-filename}} {{-n|--line-number}} --color=always "{{模式字符串}}" {{路径/到/文件}}` - 只打印文件中与模式匹配的行： -`grep --only-matching "{{模式字符串}}" {{路径/到/文件}}` +`grep {{-o|--only-matching}} "{{模式字符串}}" {{路径/到/文件}}` - 从 `stdin`（标准输入）中查找与模式不匹配的行： -`cat {{路径/到/文件}} | grep --invert-match "{{模式字符串}}"` +`cat {{路径/到/文件}} | grep {{-v|--invert-match}} "{{模式字符串}}"` diff --git a/pages.zh/common/gunicorn.md b/pages.zh/common/gunicorn.md index 3a04eec8d..8580f5feb 100644 --- a/pages.zh/common/gunicorn.md +++ b/pages.zh/common/gunicorn.md @@ -1,6 +1,6 @@ # gunicorn -> Python 的 WSGI http 服务器。 +> Python 的 WSGI HTTP 服务器。 > 更多信息：. - 运行 Python web 应用程序： @@ -23,6 +23,6 @@ `gunicorn --threads {{4}} {{导入路径：应用程序}}` -- 通过 https 运行应用程序： +- 通过 HTTPS 运行应用程序： `gunicorn --certfile {{cert.pem}} --keyfile {{key.pem}} {{导入路径：应用程序}}` diff --git a/pages.zh/common/htop.md b/pages.zh/common/htop.md new file mode 100644 index 000000000..3c87d24d0 --- /dev/null +++ b/pages.zh/common/htop.md @@ -0,0 +1,32 @@ +# htop + +> 显示正在运行的进程的动态实时信息。`top` 的增强版。 +> 更多信息：. + +- 启动 `htop`: + +`htop` + +- 启动 `htop`, 显示指定用户拥有的进程： + +`htop --user {{用户名}}` + +- 使用指定的 `sort_item` 对进程排序（使用 `htop --sort help` 获取可用选项）： + +`htop --sort {{sort_item}}` + +- 以指定的更新间隔启动 `htop`, 以十分之一秒为单位（即 50 = 5 秒）： + +`htop --delay {{50}}` + +- 运行 `htop` 时查看交互式命令： + +`?` + +- 切换到不同的标签： + +`tab` + +- 显示帮助： + +`htop --help` diff --git a/pages.zh/common/jhat.md b/pages.zh/common/jhat.md index ec175a900..53951a4aa 100644 --- a/pages.zh/common/jhat.md +++ b/pages.zh/common/jhat.md @@ -3,11 +3,11 @@ > Java 堆分析工具。 > 更多信息：. -- 分析堆转储文件（来自 jmap），通过 http 端口 7000 进行查看： +- 分析堆转储文件（来自 jmap），通过 HTTP 端口 7000 进行查看： `jhat {{路径/堆转储文件}}` -- 分析堆转储文件，为 http 服务指定备用端口： +- 分析堆转储文件，为 HTTP 服务指定备用端口： `jhat -p {{端口}} {{路径/堆转储文件}}` diff --git a/pages.zh/common/kitex.md b/pages.zh/common/kitex.md index cd57366c8..bf368acb2 100644 --- a/pages.zh/common/kitex.md +++ b/pages.zh/common/kitex.md @@ -10,7 +10,7 @@ - 生成客户端代码，项目不在 `$GOPATH` 目录下： -` kitex -module {{github.com/xx-org/xx-name}} {{路径/到/IDL文件.thrift}}` +`kitex -module {{github.com/xx-org/xx-name}} {{路径/到/IDL文件.thrift}}` - 根据 protobuf IDL 文件生成客户端代码： diff --git a/pages.zh/common/mpv.md b/pages.zh/common/mpv.md index 356830baa..201ced2bb 100644 --- a/pages.zh/common/mpv.md +++ b/pages.zh/common/mpv.md @@ -29,4 +29,4 @@ - 播放摄像头或其他设备的输出： -`mpv /dev/{{video0}}` +`mpv {{/dev/video0}}` diff --git a/pages.zh/common/netstat.md b/pages.zh/common/netstat.md index 68b44f986..5724ec33e 100644 --- a/pages.zh/common/netstat.md +++ b/pages.zh/common/netstat.md @@ -1,7 +1,7 @@ # netstat > 显示与网络相关的信息，如打开的连接、打开的套接字端口等。 -> 更多信息：. +> 更多信息：. - 列出所有端口： diff --git a/pages.zh/common/nmap.md b/pages.zh/common/nmap.md index 905d7d00e..90691e3df 100644 --- a/pages.zh/common/nmap.md +++ b/pages.zh/common/nmap.md @@ -2,7 +2,7 @@ > 网络探索工具和安全/端口扫描程序。 > 仅当以特权运行 Nmap 时，某些功能才激活。 -> 更多信息：. +> 更多信息：. - 检查 IP 地址是否可用，并猜测远程主机的操作系统： diff --git a/pages.zh/common/pio-init.md b/pages.zh/common/pio-init.md index 0def2501c..6c786804f 100644 --- a/pages.zh/common/pio-init.md +++ b/pages.zh/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > 这是 `pio project` 命令的一个别名。 diff --git a/pages.zh/common/rsync.md b/pages.zh/common/rsync.md index 57cdc31c0..b8b42bc87 100644 --- a/pages.zh/common/rsync.md +++ b/pages.zh/common/rsync.md @@ -10,28 +10,28 @@ - 使用归档模式递归拷贝文件，并保留所有属性，不解析软链接： -`rsync --archive {{路径/到/来源}} {{路径/到/目标}}` +`rsync {{-a|--archive}} {{路径/到/来源}} {{路径/到/目标}}` - 将文件以归档模式并保留几乎所有属性进行传输，并以人类可读方式输出详细信息和进度条，中断时保留部分信息： -`rsync --compress --verbose --human-readable --partial --progress {{路径/到/来源}} {{路径/到/目标}}` +`rsync {{-zvhP|--compress --verbose --human-readable --partial --progress}} {{路径/到/来源}} {{路径/到/目标}}` - 以递归模式传输文件： -`rsync --recursive {{路径/到/来源}} {{路径/到/目标}}` +`rsync {{-r|--recursive}} {{路径/到/来源}} {{路径/到/目标}}` - 将目录下的所有内容（不包含该目录），以递归方式传输： -`rsync --recursive {{路径/到/来源}}/ {{路径/到/目标}}` +`rsync {{-r|--recursive}} {{路径/到/来源}}/ {{路径/到/目标}}` - 归档方式传输目录，保留几乎所有属性，解析软连接，并忽略已传输的文件： -`rsync --archive --update --copy-links {{路径/到/来源}} {{路径/到/目标}}` +`rsync {{-auL|--archive --update --copy-links}} {{路径/到/来源}} {{路径/到/目标}}` - 传输目录到运行 `rsyncd` 的远端，并删除目标目录中源目录中不存在的文件： -`rsync --recursive --delete rsync://{{host}}:{{路径/到/来源}} {{路径/到/目标}}` +`rsync {{-r|--recursive}} --delete rsync://{{host}}:{{路径/到/来源}} {{路径/到/目标}}` - 指定本地和远程之间通信方式，使用指定端口，并显示进度条： -`rsync --rsh 'ssh -p {{端口}}' --info=progress2 {{host}}:{{路径/到/来源}} {{路径/到/目标}}` +`rsync {{-e|--rsh}} 'ssh -p {{端口}}' --info=progress2 {{host}}:{{路径/到/来源}} {{路径/到/目标}}` diff --git a/pages.zh/common/sleep.md b/pages.zh/common/sleep.md new file mode 100644 index 000000000..1f9ca8ad4 --- /dev/null +++ b/pages.zh/common/sleep.md @@ -0,0 +1,12 @@ +# sleep + +> 延迟指定的一段时间。 +> 更多信息：. + +- 按秒数延迟： + +`sleep {{seconds}}` + +- 在20秒延迟后执行指定命令： + +`sleep 20 && {{command}}` diff --git a/pages.zh/common/ssh-add.md b/pages.zh/common/ssh-add.md index 052fbfca2..03c649534 100644 --- a/pages.zh/common/ssh-add.md +++ b/pages.zh/common/ssh-add.md @@ -4,7 +4,7 @@ > 需要确保 ssh 代理已启动并正在运行以加载其中的密钥。 > 更多信息：. -- 将 `~/.ssh` 中的默认 ssh 密钥添加到 `ssh` 代理： +- 将 `~/.ssh` 中的默认 SSH 密钥添加到 SSH 代理： `ssh-add` diff --git a/pages.zh/common/sshuttle.md b/pages.zh/common/sshuttle.md index c909093e5..2b5a428a3 100644 --- a/pages.zh/common/sshuttle.md +++ b/pages.zh/common/sshuttle.md @@ -1,10 +1,10 @@ # sshuttle -> 通过 ssh 连接传输流量的透明代理服务器。 -> 不需要管理员或远程 ssh 服务器上的任何特殊设置。 +> 通过 SSH 连接传输流量的透明代理服务器。 +> 不需要管理员或远程 SSH 服务器上的任何特殊设置。 > 更多信息：. -- 通过远程 ssh 服务器转发所有 IPv4 TCP 流量： +- 通过远程 SSH 服务器转发所有 IPv4 TCP 流量： `sshuttle --remote={{用户名}}@{{服务器名}} {{0.0.0.0/0}}` diff --git a/pages.zh/common/steam.md b/pages.zh/common/steam.md new file mode 100644 index 000000000..c98089f34 --- /dev/null +++ b/pages.zh/common/steam.md @@ -0,0 +1,28 @@ +# steam + +> Valve 的电子游戏平台。 +> 更多信息：. + +- 启动 Steam 同时将调试信息输出到 `stdout`: + +`steam` + +- 启动 Steam 并启用内置调试控制台标签页： + +`steam -console` + +- 在运行的 Steam 实例中启用并打开控制台标签页： + +`steam steam://open/console` + +- 使用指定认证信息登录 Steam: + +`steam -login {{username}} {{password}}` + +- 以大屏幕模式启动 Steam: + +`steam -tenfoot` + +- 退出 Steam: + +`steam -shutdown` diff --git a/pages.zh/common/tlmgr-arch.md b/pages.zh/common/tlmgr-arch.md index 72ed21a40..f8b5919a9 100644 --- a/pages.zh/common/tlmgr-arch.md +++ b/pages.zh/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > 这是 `tlmgr platform` 命令的一个别名。 > 更多信息：. diff --git a/pages.zh/common/touch.md b/pages.zh/common/touch.md new file mode 100644 index 000000000..6c8076ff1 --- /dev/null +++ b/pages.zh/common/touch.md @@ -0,0 +1,20 @@ +# touch + +> 创建文件并设置访问/修改时间。 +> 更多信息：. + +- 创建指定的文件： + +`touch {{路径/到/文件名1 路径/到/文件名2 ...}}` + +- 将文件的访问(a)或修改时间(m)设置为当前时间，如果文件不存在则不创建(-c)： + +`touch -c -{{a|m}} {{路径/到/文件1 路径/到/文件2 ...}}` + +- 将文件时间(-t)设置为指定值，如果文件不存在则不创建(-c)： + +`touch -c -t {{YYYYMMDDHHMM.SS}} {{路径/到/文件名1 路径/到/文件名2 ...}}` + +- 将文件时间设置为另一文件(-r,即文件3)的时间，如果文件不存在则不创建(-c)： + +`touch -c -r {{路径/到/文件3}} {{路径/到/文件名1 路径/到/文件名2 ...}}` diff --git a/pages.zh/common/tree.md b/pages.zh/common/tree.md index cb8f957b9..d7fe63392 100644 --- a/pages.zh/common/tree.md +++ b/pages.zh/common/tree.md @@ -1,7 +1,7 @@ # tree > 以树的形式显示当前目录的内容。 -> 更多信息：. +> 更多信息：. - 显示深度达到 “级数” 级的文件和目录（其中 1 表示当前目录）： diff --git a/pages.zh/common/unzip.md b/pages.zh/common/unzip.md index ee1b7be6d..3617b0b5f 100644 --- a/pages.zh/common/unzip.md +++ b/pages.zh/common/unzip.md @@ -1,6 +1,6 @@ # unzip -> 从 ZIP 压缩包中提取文件或目录。 +> 从 Zip 压缩包中提取文件或目录。 > 参见：`zip`. > 更多信息：. diff --git a/pages.zh/common/uptime.md b/pages.zh/common/uptime.md new file mode 100644 index 000000000..b8f878f10 --- /dev/null +++ b/pages.zh/common/uptime.md @@ -0,0 +1,20 @@ +# uptime + +> 告知当前系统运行多长时间和其他信息。 +> 更多信息：. + +- 打印当前时间，运行时间，登录用户数量和其他信息： + +`uptime` + +- 仅显示系统已启动的时间长度： + +`uptime --pretty` + +- 打印系统启动的日期和时间： + +`uptime --since` + +- 显示版本信息： + +`uptime --version` diff --git a/pages.zh/common/whereis.md b/pages.zh/common/whereis.md index 3beff1eab..ef37a5d98 100644 --- a/pages.zh/common/whereis.md +++ b/pages.zh/common/whereis.md @@ -3,7 +3,7 @@ > 找到命令的二进制，源文件和手册文件。 > 更多信息：. -- 找到 `ssh` 命令的二进制、源文件和手册页： +- 找到 SSH 命令的二进制、源文件和手册页： `whereis {{ssh}}` diff --git a/pages.zh/common/xz.md b/pages.zh/common/xz.md new file mode 100644 index 000000000..b23581126 --- /dev/null +++ b/pages.zh/common/xz.md @@ -0,0 +1,36 @@ +# xz + +> 解压缩 XZ 和 LZMA 文件。 +> 更多信息：. + +- 使用 xz 压缩文件： + +`xz {{路径/到/文件}}` + +- 解压 XZ 文件： + +`xz --decompress {{路径/到/文件.xz}}` + +- 使用 lzma 压缩文件： + +`xz --format=lzma {{路径/到/文件}}` + +- 解压 LZMA 文件： + +`xz --decompress --format=lzma {{路径/到/文件.lzma}}` + +- 解压文件并输出到 `stdout`（暗示 `--keep`）： + +`xz --decompress --stdout {{路径/到/文件.xz}}` + +- 压缩文件但不删除原文件： + +`xz --keep {{路径/到/文件}}` + +- 使用最快方式压缩文件： + +`xz -0 {{路径/到/文件}}` + +- 使用最好方式压缩文件： + +`xz -9 {{路径/到/文件}}` diff --git a/pages.zh/linux/add-apt-repository.md b/pages.zh/linux/add-apt-repository.md index c2084159d..e7663652b 100644 --- a/pages.zh/linux/add-apt-repository.md +++ b/pages.zh/linux/add-apt-repository.md @@ -3,11 +3,11 @@ > apt 仓库管理。 > 更多信息：. -- 添加一个新的 apt 仓库： +- 添加一个新的 APT 仓库： `add-apt-repository {{指定仓库}}` -- 移除一个 apt 仓库： +- 移除一个 APT 仓库： `add-apt-repository --remove {{指定仓库}}` diff --git a/pages.zh/linux/apt-add-repository.md b/pages.zh/linux/apt-add-repository.md index dd2a4a68f..851cd3b9f 100644 --- a/pages.zh/linux/apt-add-repository.md +++ b/pages.zh/linux/apt-add-repository.md @@ -1,17 +1,17 @@ # apt-add-repository -> 管理 apt 仓库。 +> 管理 APT 仓库。 > 更多信息：. -- 添加一个 apt 仓库： +- 添加一个 APT 仓库： `apt-add-repository {{repository_spec}}` -- 移除一个 apt 仓库： +- 移除一个 APT 仓库： `apt-add-repository --remove {{repository_spec}}` -- 添加一个 apt 仓库之后更新包缓存： +- 添加一个 APT 仓库之后更新包缓存： `apt-add-repository --update {{repository_spec}}` diff --git a/pages.zh/linux/apt-file.md b/pages.zh/linux/apt-file.md index aba0df23d..ef27551f4 100644 --- a/pages.zh/linux/apt-file.md +++ b/pages.zh/linux/apt-file.md @@ -1,6 +1,6 @@ # apt-file -> 在 apt 软件包中查找文件，其中也包括未安装的软件。 +> 在 APT 软件包中查找文件，其中也包括未安装的软件。 > 更多信息：. - 更新元数据的数据库： diff --git a/pages.zh/linux/apt.md b/pages.zh/linux/apt.md index 1ec335891..92997a0d3 100644 --- a/pages.zh/linux/apt.md +++ b/pages.zh/linux/apt.md @@ -4,7 +4,7 @@ > 在 Ubuntu 16.04 及之后版本推荐用它代替 `apt-get` 。 > 更多信息：. -- 更新可用软件包及其版本列表（推荐在运行其他 apt 命令前首先运行该命令）： +- 更新可用软件包及其版本列表（推荐在运行其他 APT 命令前首先运行该命令）： `sudo apt update` diff --git a/pages.zh/linux/arch-chroot.md b/pages.zh/linux/arch-chroot.md index 73e157a8a..fb2ad7182 100644 --- a/pages.zh/linux/arch-chroot.md +++ b/pages.zh/linux/arch-chroot.md @@ -3,7 +3,7 @@ > 辅助 Arch Linux 安装流程的更强 `chroot` 命令。 > 更多信息：. -- 在新的根目录下开启一个交互外壳程序（默认是 `bash`）： +- 在新的根目录下开启一个交互外壳程序（默认是 Bash）： `arch-chroot {{新根目录}}` @@ -11,10 +11,10 @@ `arch-chroot -u {{用户名}} {{新根目录}}` -- 在新的根目录下运行一个自定义命令（取代默认的 `bash`）： +- 在新的根目录下运行一个自定义命令（取代默认的 Bash）： `arch-chroot {{新根目录}} {{命令}} {{命令参数}}` -- 指定除默认的 `bash` 以外的外壳程序（以下例子需要现在目标系统中先安装 `zsh`）： +- 指定除默认的 Bash 以外的外壳程序（以下例子需要现在目标系统中先安装 `zsh`）： `arch-chroot {{新根目录}} {{zsh}}` diff --git a/pages.zh/linux/asterisk.md b/pages.zh/linux/asterisk.md index 40637ba3f..19dafc634 100644 --- a/pages.zh/linux/asterisk.md +++ b/pages.zh/linux/asterisk.md @@ -2,7 +2,7 @@ > 电话和交换（手机）服务器。 > 用于管理服务器自身和管理已经在运行的实例。 -> 更多信息：. +> 更多信息：. - 重新连接一个正在运行的服务器，并打开 3 级的日志详细度： diff --git a/pages.zh/linux/blkdiscard.md b/pages.zh/linux/blkdiscard.md index fa4cf4207..3b59c8f82 100644 --- a/pages.zh/linux/blkdiscard.md +++ b/pages.zh/linux/blkdiscard.md @@ -5,12 +5,12 @@ - 丢弃设备上的所有扇区，删除所有数据： -`blkdiscard /dev/{{设备名}}` +`blkdiscard {{/dev/设备名}}` - 安全地丢弃设备上的所有块，删除所有数据： -`blkdiscard --secure /dev/{{设备名}}` +`blkdiscard --secure {{/dev/设备名}}` - 丢弃设备的前 100 MB： -`blkdiscard --length {{100MB}} /dev/{{设备名}}` +`blkdiscard --length {{100MB}} {{/dev/设备名}}` diff --git a/pages.zh/linux/bootctl.md b/pages.zh/linux/bootctl.md index 52f9d2ec9..4ce177a36 100644 --- a/pages.zh/linux/bootctl.md +++ b/pages.zh/linux/bootctl.md @@ -1,7 +1,7 @@ # bootctl > 控制EFI固件启动设置并管理启动加载器。 -> 更多信息：。 +> 更多信息：. - 显示系统固件和启动加载器的信息： diff --git a/pages.zh/linux/dnf.md b/pages.zh/linux/dnf.md new file mode 100644 index 000000000..f32c58712 --- /dev/null +++ b/pages.zh/linux/dnf.md @@ -0,0 +1,37 @@ +# dnf + +> RHEL, Fedora 和 CentOS 的软件包管理工具（yum 的替代品）。 +> 对于其他包管理器中的等效命令，请见 . +> 更多信息：. + +- 更新已安装的包到最新可用版本： + +`sudo dnf upgrade` + +- 通过关键词搜索包： + +`dnf search {{关键词1 关键词2 ...}}` + +- 显示软件包的描述： + +`dnf info {{包}}` + +- 安装软件包（使用 `-y` 自动确认所有提示）： + +`sudo dnf install {{包1 包2 ...}}` + +- 删除软件包： + +`sudo dnf remove {{包1 包2 ...}}` + +- 列出已安装的包： + +`dnf list --installed` + +- 查找哪些包提供给定命令： + +`dnf provides {{命令}}` + +- 查看所有过去的操作： + +`dnf history` diff --git a/pages.zh/linux/ip-route-list.md b/pages.zh/linux/ip-route-list.md index 930ed6d8b..7fd9c0431 100644 --- a/pages.zh/linux/ip-route-list.md +++ b/pages.zh/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> 这是 `ip-route-show` 命令的一个别名。 +> 这是 `ip route show`.命令的一个别名。 - 原命令的文档在： diff --git a/pages.zh/linux/lvs.md b/pages.zh/linux/lvs.md index 8c522f99e..7a80eb891 100644 --- a/pages.zh/linux/lvs.md +++ b/pages.zh/linux/lvs.md @@ -2,7 +2,7 @@ > 显示逻辑卷信息。 > 另见：`lvm`. -> 更多信息：. +> 更多信息：. - 显示逻辑卷信息： diff --git a/pages.zh/linux/mkfs.btrfs.md b/pages.zh/linux/mkfs.btrfs.md new file mode 100644 index 000000000..e47121fd6 --- /dev/null +++ b/pages.zh/linux/mkfs.btrfs.md @@ -0,0 +1,17 @@ +# mkfs.btrfs + +> 创建一个 BTRFS 文件系统。 +> 默认情况下是 `raid1`，指定了数据块的两份拷贝分布在两个不同的设备上。 +> 更多信息：. + +- 在单个设备上创建一个 btrfs 文件系统： + +`sudo mkfs.btrfs --metadata single --data single {{/dev/sda}}` + +- 在多个设备上使用 raid1 创建一个 btrfs 文件系统： + +`sudo mkfs.btrfs --metadata raid1 --data raid1 {{/dev/sda}} {{/dev/sdb}} {{/dev/sdN}}` + +- 为文件系统设置一个标签（可选）： + +`sudo mkfs.btrfs --label "{{label}}" {{/dev/sda}} [{{/dev/sdN}}]` diff --git a/pages.zh/linux/mkfs.cramfs.md b/pages.zh/linux/mkfs.cramfs.md new file mode 100644 index 000000000..dc1cc80db --- /dev/null +++ b/pages.zh/linux/mkfs.cramfs.md @@ -0,0 +1,12 @@ +# mkfs.cramfs + +> 创建一个 ROM 文件系统，放置在分区内。 +> 更多信息：. + +- 在设备 b 的第 1 个分区内创建一个 ROM 文件系统（`sdb1`）： + +`mkfs.cramfs {{/dev/sdb1}}` + +- 创建一个带有卷名的 ROM 文件系统： + +`mkfs.cramfs -n {{volume_name}} {{/dev/sdb1}}` diff --git a/pages.zh/linux/mkfs.exfat.md b/pages.zh/linux/mkfs.exfat.md new file mode 100644 index 000000000..befe10bf5 --- /dev/null +++ b/pages.zh/linux/mkfs.exfat.md @@ -0,0 +1,16 @@ +# mkfs.exfat + +> 在分区内创建一个 exFAT 文件系统。 +> 更多信息：. + +- 在设备 b 的分区 1 内创建一个 exFAT 文件系统（`sdb1`）： + +`mkfs.exfat {{/dev/sdb1}}` + +- 创建一个带有卷名的文件系统： + +`mkfs.exfat -n {{volume_name}} {{/dev/sdb1}}` + +- 创建一个带有卷 ID 的文件系统： + +`mkfs.exfat -i {{volume_id}} {{/dev/sdb1}}` diff --git a/pages.zh/linux/mkfs.ext4.md b/pages.zh/linux/mkfs.ext4.md new file mode 100644 index 000000000..18a8cabbd --- /dev/null +++ b/pages.zh/linux/mkfs.ext4.md @@ -0,0 +1,12 @@ +# mkfs.ext4 + +> 在分区内创建一个 ext4 文件系统。 +> 更多信息：. + +- 在设备 b 的分区 1 内创建一个 ext4 文件系统（`sdb1`）： + +`sudo mkfs.ext4 {{/dev/sdb1}}` + +- 创建一个带有卷标签的 ext4 文件系统： + +`sudo mkfs.ext4 -L {{volume_label}} {{/dev/sdb1}}` diff --git a/pages.zh/linux/mkfs.f2fs.md b/pages.zh/linux/mkfs.f2fs.md new file mode 100644 index 000000000..cc7a5690a --- /dev/null +++ b/pages.zh/linux/mkfs.f2fs.md @@ -0,0 +1,12 @@ +# mkfs.f2fs + +> 在分区内创建一个 F2FS 文件系统。 +> 更多信息：. + +- 在设备 b 的第 1 个分区内创建一个 F2FS 文件系统（`sdb1`）： + +`sudo mkfs.f2fs {{/dev/sdb1}}` + +- 创建一个带有卷标签的 F2FS 文件系统： + +`sudo mkfs.f2fs -l {{volume_label}} {{/dev/sdb1}}` diff --git a/pages.zh/linux/mkfs.fat.md b/pages.zh/linux/mkfs.fat.md new file mode 100644 index 000000000..b66de538b --- /dev/null +++ b/pages.zh/linux/mkfs.fat.md @@ -0,0 +1,20 @@ +# mkfs.fat + +> 在分区内创建一个 MS-DOS 文件系统。 +> 更多信息：. + +- 在设备 b 的分区 1 内创建一个 FAT 文件系统（`sdb1`）： + +`mkfs.fat {{/dev/sdb1}}` + +- 创建一个带有卷名的文件系统： + +`mkfs.fat -n {{volume_name}} {{/dev/sdb1}}` + +- 创建一个带有卷 ID 的文件系统： + +`mkfs.fat -i {{volume_id}} {{/dev/sdb1}}` + +- 使用 5 个而不是 2 个文件分配表： + +`mkfs.fat -f 5 {{/dev/sdb1}}` diff --git a/pages.zh/linux/mkfs.md b/pages.zh/linux/mkfs.md new file mode 100644 index 000000000..a1c31af36 --- /dev/null +++ b/pages.zh/linux/mkfs.md @@ -0,0 +1,17 @@ +# mkfs + +> 在硬盘分区上建立一个 Linux 文件系统。 +> 该命令已被废弃，建议使用特定文件系统的 mkfs. 工具。 +> 更多信息：. + +- 在分区上建立一个 Linux ext2 文件系统： + +`mkfs {{path/to/partition}}` + +- 建立指定类型的文件系统： + +`mkfs -t {{ext4}} {{path/to/partition}}` + +- 建立指定类型的文件系统并检查坏块： + +`mkfs -c -t {{ntfs}} {{path/to/partition}}` diff --git a/pages.zh/linux/mkfs.minix.md b/pages.zh/linux/mkfs.minix.md new file mode 100644 index 000000000..1dab3970a --- /dev/null +++ b/pages.zh/linux/mkfs.minix.md @@ -0,0 +1,8 @@ +# mkfs.minix + +> 在分区内创建一个 Minix 文件系统。 +> 更多信息：. + +- 在设备 b 的分区 1 内创建一个 Minix 文件系统（`sdb1`）： + +`mkfs.minix {{/dev/sdb1}}` diff --git a/pages.zh/linux/mkfs.ntfs.md b/pages.zh/linux/mkfs.ntfs.md new file mode 100644 index 000000000..c9903bb15 --- /dev/null +++ b/pages.zh/linux/mkfs.ntfs.md @@ -0,0 +1,16 @@ +# mkfs.ntfs + +> 在分区内创建一个 NTFS 文件系统。 +> 更多信息：. + +- 在设备 b 的分区 1 内创建一个 NTFS 文件系统（`sdb1`）： + +`mkfs.ntfs {{/dev/sdb1}}` + +- 创建一个带有卷标签的文件系统： + +`mkfs.ntfs -L {{volume_label}} {{/dev/sdb1}}` + +- 创建一个带有特定 UUID 的文件系统： + +`mkfs.ntfs -U {{UUID}} {{/dev/sdb1}}` diff --git a/pages.zh/linux/mkfs.vfat.md b/pages.zh/linux/mkfs.vfat.md new file mode 100644 index 000000000..04ad841fd --- /dev/null +++ b/pages.zh/linux/mkfs.vfat.md @@ -0,0 +1,20 @@ +# mkfs.vfat + +> 在分区内创建一个 MS-DOS 文件系统。 +> 更多信息：. + +- 在设备 b 的分区 1 内创建一个 vfat 文件系统（`sdb1`）： + +`mkfs.vfat {{/dev/sdb1}}` + +- 创建一个带有卷名的文件系统： + +`mkfs.vfat -n {{volume_name}} {{/dev/sdb1}}` + +- 创建一个带有卷 ID 的文件系统： + +`mkfs.vfat -i {{volume_id}} {{/dev/sdb1}}` + +- 使用 5 个而不是 2 个文件分配表： + +`mkfs.vfat -f 5 {{/dev/sdb1}}` diff --git a/pages.zh/linux/poweroff.md b/pages.zh/linux/poweroff.md index 72ed7b764..b4663067f 100644 --- a/pages.zh/linux/poweroff.md +++ b/pages.zh/linux/poweroff.md @@ -1,7 +1,7 @@ # poweroff > 关闭系统。 -> 更多信息：. +> 更多信息：. - 关闭系统电源： diff --git a/pages.zh/linux/readelf.md b/pages.zh/linux/readelf.md index ec13133dc..f5ed432b4 100644 --- a/pages.zh/linux/readelf.md +++ b/pages.zh/linux/readelf.md @@ -1,7 +1,7 @@ # readelf > 显示 EFI 文件信息。 -> 更多信息：. +> 更多信息：. - 显示 ELF 所有文件信息： diff --git a/pages.zh/linux/sed.md b/pages.zh/linux/sed.md new file mode 100644 index 000000000..13d16ece2 --- /dev/null +++ b/pages.zh/linux/sed.md @@ -0,0 +1,33 @@ +# sed + +> 以脚本方式编辑文本。 +> 参见：`awk`, `ed`. +> 更多信息：. + +- 将所有输入行中出现的 `apple`（基本正则语法）替换为 `mango`（基本正则语法），并将结果打印到 `stdout`： + +`{{命令}} | sed 's/apple/mango/g'` + +- 将所有输入行中出现的 `apple`（扩展正则语法）替换为 `APPLE` （扩展正则语法），并将结果打印到 `stdout`： + +`{{命令}} | sed -E 's/(apple)/\U\1/g'` + +- 用 `mango`（基本正则语法）替换特定文件中出现的所有 `apple`（基本正则语法），并覆盖原文件： + +`sed -i 's/apple/mango/g' {{路径/到/文件}}` + +- 执行特定的脚本，并将结果打印到 `stdout`： + +`{{命令}} | sed -f {{路径/到/脚本.sed}}` + +- 打印第一行到 `stdout`： + +`{{命令}} | sed -n '1p'` + +- 删除文件第一行： + +`sed -i 1d {{路径/到/文件}}` + +- 插入新行到文件的第一行： + +`sed -i '1i\your new line text\' {{路径/到/文件}}` diff --git a/pages.zh/linux/sleep.md b/pages.zh/linux/sleep.md new file mode 100644 index 000000000..a025c861d --- /dev/null +++ b/pages.zh/linux/sleep.md @@ -0,0 +1,20 @@ +# sleep + +> 延迟指定的一段时间。 +> 更多信息：. + +- 按秒数延迟： + +`sleep {{seconds}}` + +- 延迟 [m]分钟（其他元素 [d]天，[h]小时，[s]秒，[inf]无穷 也可以使用）： + +`sleep {{minutes}}m` + +- 延迟 1 [d]天 3 [h]小时： + +`sleep 1d 3h` + +- 在 20 [m]分钟 延迟后执行指定命令： + +`sleep 20m && {{command}}` diff --git a/pages.zh/osx/date.md b/pages.zh/osx/date.md index c8d61a344..b3c86996d 100644 --- a/pages.zh/osx/date.md +++ b/pages.zh/osx/date.md @@ -17,4 +17,4 @@ - 使用默认格式显示特定日期（格式化指定 UNIX 时间戳）： -`date -r 1473305798` +`date -r {{1473305798}}` diff --git a/pages.zh/osx/dd.md b/pages.zh/osx/dd.md index d5abbbcd3..d1194baad 100644 --- a/pages.zh/osx/dd.md +++ b/pages.zh/osx/dd.md @@ -5,16 +5,16 @@ - 从 isohybrid 文件（如 archlinux-xxx.iso）制作可用于引导系统启动的 USB 驱动器： -`dd if={{文件.iso}} of=/dev/{{usb 设备}}` +`dd if={{文件.iso}} of={{/dev/usb 设备}}` - 将驱动器克隆到具有 4MB 块的另一个驱动器并忽略错误： -`dd if=/dev/{{源设备}} of=/dev/{{目标设备}} bs=4m conv=noerror` +`dd bs=4m conv=noerror if={{/dev/源设备}} of={{/dev/目标设备}}` -- 使用内核随机驱动程序生成 100 个随机字节的文件： +- 使用内核随机驱动程序生成指定数量个随机字节的文件： -`dd if=/dev/urandom of={{目标驱动器，接收随机数据文件名}} bs=100 count=1` +`dd bs={{100}} count={{1}} if=/dev/urandom of={{目标驱动器，接收随机数据文件名}}` - 对磁盘的写入性能进行基准测试： -`dd if=/dev/zero of={{1GB 的文件名}} bs=1024 count=1000000` +`dd bs={{1024}} count={{1000000}} if=/dev/zero of={{1GB 的文件名}}` diff --git a/pages.zh/osx/ping.md b/pages.zh/osx/ping.md index 899a79043..64fc54b5c 100644 --- a/pages.zh/osx/ping.md +++ b/pages.zh/osx/ping.md @@ -11,18 +11,18 @@ `ping -c {{次数}} "{{主机}}"` -- Ping `主机` , 指定请求之间的间隔（以`秒`为单位）（默认为 1 秒）： +- Ping 主机 , 指定请求之间的间隔（以秒为单位）（默认为 1 秒）： `ping -i {{秒}} "{{主机}}"` -- Ping `主机`, 但不尝试查找地址的符号名： +- Ping 主机, 但不尝试查找地址的符号名： `ping -n "{{主机}}"` -- Ping `主机` 并在收到数据包时响铃（如果您的终端支持）： +- Ping 主机 并在收到数据包时响铃（如果您的终端支持）： `ping -a "{{主机}}"` -- Ping `主机` 并打印接收数据包的时间（此选项是 Apple 的附加项）： +- Ping 主机 并打印接收数据包的时间（此选项是 Apple 的附加项）： `ping --apple-time "{{主机}}"` diff --git a/pages.zh/osx/qlmanage.md b/pages.zh/osx/qlmanage.md index 0559ef1c2..cfa1d83d4 100644 --- a/pages.zh/osx/qlmanage.md +++ b/pages.zh/osx/qlmanage.md @@ -7,7 +7,7 @@ `qlmanage -p {{路径/到/文件1 路径/到/文件2 ...}}` -- 计算生成当前目录中所有 jpeg 文件的缩略图，300px 宽 png 格式，并将它们放在一个指定目录中： +- 计算生成当前目录中所有 JPEG 文件的缩略图，300px 宽 PNG 格式，并将它们放在一个指定目录中： `qlmanage {{*.jpg}} -t -s {{300}} {{指定目录}}` diff --git a/pages.zh/osx/shuf.md b/pages.zh/osx/shuf.md index c2997180a..c57554684 100644 --- a/pages.zh/osx/shuf.md +++ b/pages.zh/osx/shuf.md @@ -9,12 +9,12 @@ - 只输出结果的前 5 条： -`shuf --head-count={{5}} {{文件名}}` +`shuf --head-count=5 {{路径/到/文件}}` - 将结果输出写入另一个文件： -`shuf {{文件名}} --output={{输出_文件名}}` +`shuf {{路径/到/输入文件}} --output={{路径/到/输出文件}}` - 生成范围（1-10）内的随机数： -`shuf --input-range={{1-10}}` +`shuf --input-range=1-10` diff --git a/pages.zh/osx/split.md b/pages.zh/osx/split.md index 456f00e50..0a699da56 100644 --- a/pages.zh/osx/split.md +++ b/pages.zh/osx/split.md @@ -5,12 +5,12 @@ - 分割一个文件，每个分割部分有 10 行（除了最后一个）： -`split -l {{10}} {{文件名}}` +`split -l 10 {{路径/到/文件}}` - 用正则表达式拆分文件。匹配行将是下一个输出文件的第一行： -`split -p {{cat|^[dh]og}} {{文件名}}` +`split -p {{cat|^[dh]og}} {{路径/到/文件}}` - 拆分一个文件，每个拆分中有 512 个字节（除了最后一个文件，使用 512K 表示 Kb，512M 表示 Mb）： -`split -b {{512}} {{文件名}}` +`split -b 512 {{路径/到/文件}}` diff --git a/pages.zh/osx/uptime.md b/pages.zh/osx/uptime.md new file mode 100644 index 000000000..b29f0b962 --- /dev/null +++ b/pages.zh/osx/uptime.md @@ -0,0 +1,8 @@ +# uptime + +> 告知当前系统运行多长时间和其他信息。 +> 更多信息：. + +- 打印当前时间，运行时间，登录用户数量和其他信息： + +`uptime` diff --git a/pages.zh/windows/logoff.md b/pages.zh/windows/logoff.md index 8e18a386b..13d45fd07 100644 --- a/pages.zh/windows/logoff.md +++ b/pages.zh/windows/logoff.md @@ -7,7 +7,7 @@ `logoff` -- 通过名称和 id 注销会话： +- 通过名称和 ID 注销会话： `logoff {{会话名|会话 id}}` diff --git a/pages.zh/windows/taskkill.md b/pages.zh/windows/taskkill.md index d2102e1ef..2be89d59e 100644 --- a/pages.zh/windows/taskkill.md +++ b/pages.zh/windows/taskkill.md @@ -1,9 +1,9 @@ # taskkill -> 按进程 id 或进程名终止进程。 +> 按进程 ID 或进程名终止进程。 > 更多信息：. -- 通过进程 id 终止进程： +- 通过进程 ID 终止进程： `taskkill /pid {{进程 id}}` diff --git a/pages.zh_TW/common/cat.md b/pages.zh_TW/common/cat.md index 35257f44f..3c7dda332 100644 --- a/pages.zh_TW/common/cat.md +++ b/pages.zh_TW/common/cat.md @@ -1,7 +1,7 @@ # cat > 連接檔案並印出檔案的內容。 -> 更多資訊：. +> 更多資訊：. - 將檔案的內容印在標準輸出： diff --git a/pages.zh_TW/common/clamav.md b/pages.zh_TW/common/clamav.md index 1d2ba878c..8716aa09f 100644 --- a/pages.zh_TW/common/clamav.md +++ b/pages.zh_TW/common/clamav.md @@ -1,4 +1,4 @@ -# clamav +# ClamAV > 這是 `clamdscan` 命令的一個別名。 > 更多資訊：. diff --git a/pages.zh_TW/common/diff.md b/pages.zh_TW/common/diff.md index 5d8610b2a..036df6e47 100644 --- a/pages.zh_TW/common/diff.md +++ b/pages.zh_TW/common/diff.md @@ -1,7 +1,7 @@ # diff > 比較兩個檔案或目錄間的差異。 -> 更多資訊：. +> 更多資訊：. - 比較兩檔案，列出 `舊檔案` 相異於 `新檔案` 而需更改之處，以讓兩者相同： diff --git a/pages.zh_TW/common/docker.md b/pages.zh_TW/common/docker.md index ab917c0c2..b9ed1d3ee 100644 --- a/pages.zh_TW/common/docker.md +++ b/pages.zh_TW/common/docker.md @@ -4,7 +4,7 @@ > 此命令也有關於其子命令的文件，例如：`docker run`. > 更多資訊：. -- 列出所有 docker 容器（包括停止的容器）： +- 列出所有 Docker 容器（包括停止的容器）： `docker ps --all` @@ -16,7 +16,7 @@ `docker {{start|stop}} {{容器名稱}}` -- 從 docker registry 中拉取映像檔： +- 從 Docker registry 中拉取映像檔： `docker pull {{映像檔}}` diff --git a/pages.zh_TW/common/fossil-ci.md b/pages.zh_TW/common/fossil-ci.md index 826beb646..8150523b3 100644 --- a/pages.zh_TW/common/fossil-ci.md +++ b/pages.zh_TW/common/fossil-ci.md @@ -1,6 +1,6 @@ -# fossil-ci +# fossil ci -> 這是 `fossil-commit` 命令的一個別名。 +> 這是 `fossil commit`.命令的一個別名。 > 更多資訊：. - 原命令的文件在： diff --git a/pages.zh_TW/common/fossil-delete.md b/pages.zh_TW/common/fossil-delete.md index b277c2000..3a330d6a3 100644 --- a/pages.zh_TW/common/fossil-delete.md +++ b/pages.zh_TW/common/fossil-delete.md @@ -1,4 +1,4 @@ -# fossil-delete +# fossil delete > 這是 `fossil rm` 命令的一個別名。 > 更多資訊：. diff --git a/pages.zh_TW/common/fossil-forget.md b/pages.zh_TW/common/fossil-forget.md index c539cea45..23035a603 100644 --- a/pages.zh_TW/common/fossil-forget.md +++ b/pages.zh_TW/common/fossil-forget.md @@ -1,4 +1,4 @@ -# fossil-forget +# fossil forget > 這是 `fossil rm` 命令的一個別名。 > 更多資訊：. diff --git a/pages.zh_TW/common/fossil-new.md b/pages.zh_TW/common/fossil-new.md index 92a4dec43..414e7005c 100644 --- a/pages.zh_TW/common/fossil-new.md +++ b/pages.zh_TW/common/fossil-new.md @@ -1,6 +1,6 @@ -# fossil-new +# fossil new -> 這是 `fossil-init` 命令的一個別名。 +> 這是 `fossil init`.命令的一個別名。 > 更多資訊：. - 原命令的文件在： diff --git a/pages.zh_TW/common/gh-cs.md b/pages.zh_TW/common/gh-cs.md index c9dd4dff5..469e974d1 100644 --- a/pages.zh_TW/common/gh-cs.md +++ b/pages.zh_TW/common/gh-cs.md @@ -1,6 +1,6 @@ -# gh-cs +# gh cs -> 這是 `gh-codespace` 命令的一個別名。 +> 這是 `gh codespace`.命令的一個別名。 > 更多資訊：. - 原命令的文件在： diff --git a/pages.zh_TW/common/gnmic-sub.md b/pages.zh_TW/common/gnmic-sub.md index 009229d25..bc7257c0b 100644 --- a/pages.zh_TW/common/gnmic-sub.md +++ b/pages.zh_TW/common/gnmic-sub.md @@ -1,4 +1,4 @@ -# gnmic-sub +# gnmic sub > 這是 `gnmic subscribe` 命令的一個別名。 > 更多資訊：. diff --git a/pages.zh_TW/common/pio-init.md b/pages.zh_TW/common/pio-init.md index b4809a7cc..131130a63 100644 --- a/pages.zh_TW/common/pio-init.md +++ b/pages.zh_TW/common/pio-init.md @@ -1,4 +1,4 @@ -# pio-init +# pio init > 這是 `pio project` 命令的一個別名。 diff --git a/pages.zh_TW/common/tlmgr-arch.md b/pages.zh_TW/common/tlmgr-arch.md index fa2405ab6..0c5e3a185 100644 --- a/pages.zh_TW/common/tlmgr-arch.md +++ b/pages.zh_TW/common/tlmgr-arch.md @@ -1,4 +1,4 @@ -# tlmgr-arch +# tlmgr arch > 這是 `tlmgr platform` 命令的一個別名。 > 更多資訊：. diff --git a/pages.zh_TW/linux/ip-route-list.md b/pages.zh_TW/linux/ip-route-list.md index e5e8d16eb..3fe42024f 100644 --- a/pages.zh_TW/linux/ip-route-list.md +++ b/pages.zh_TW/linux/ip-route-list.md @@ -1,6 +1,6 @@ -# ip-route-list +# ip route list -> 這是 `ip-route-show` 命令的一個別名。 +> 這是 `ip route show`.命令的一個別名。 - 原命令的文件在： diff --git a/pages/android/dumpsys.md b/pages/android/dumpsys.md index 712748a48..531ddc698 100644 --- a/pages/android/dumpsys.md +++ b/pages/android/dumpsys.md @@ -1,6 +1,6 @@ # dumpsys -> Provide information about Android system services. +> Get information about Android system services. > This command can only be used through `adb shell`. > More information: . diff --git a/pages/android/logcat.md b/pages/android/logcat.md index f934bc45d..82fd3d6ac 100644 --- a/pages/android/logcat.md +++ b/pages/android/logcat.md @@ -17,8 +17,8 @@ - Display logs for a specific PID: -`logcat --pid={{pid}}` +`logcat --pid {{pid}}` - Display logs for the process of a specific package: -`logcat --pid=$(pidof -s {{package}})` +`logcat --pid $(pidof -s {{package}})` diff --git a/pages/common/2to3.md b/pages/common/2to3.md index b50154e3a..19f168656 100644 --- a/pages/common/2to3.md +++ b/pages/common/2to3.md @@ -13,11 +13,11 @@ - Convert specific Python 2 language features to Python 3: -`2to3 --write {{path/to/file.py}} --fix={{raw_input}} --fix={{print}}` +`2to3 --write {{path/to/file.py}} --fix {{raw_input}} --fix {{print}}` - Convert all Python 2 language features except the specified ones to Python 3: -`2to3 --write {{path/to/file.py}} --nofix={{has_key}} --nofix={{isinstance}}` +`2to3 --write {{path/to/file.py}} --nofix {{has_key}} --nofix {{isinstance}}` - List all available language features that can be converted from Python 2 to Python 3: @@ -25,8 +25,8 @@ - Convert all Python 2 files in a directory to Python 3: -`2to3 --output-dir={{path/to/python3_directory}} --write-unchanged-files --nobackups {{path/to/python2_directory}}` +`2to3 --output-dir {{path/to/python3_directory}} --write-unchanged-files --nobackups {{path/to/python2_directory}}` - Run 2to3 with multiple threads: -`2to3 --processes={{4}} --output-dir={{path/to/python3_directory}} --write --nobackups --no-diff {{path/to/python2_directory}}` +`2to3 --processes {{4}} --output-dir {{path/to/python3_directory}} --write --nobackups --no-diff {{path/to/python2_directory}}` diff --git a/pages/common/7zr.md b/pages/common/7zr.md index d7d73688f..e09db78e1 100644 --- a/pages/common/7zr.md +++ b/pages/common/7zr.md @@ -1,7 +1,7 @@ # 7zr > File archiver with a high compression ratio. -> Similar to `7z` except that it only supports `.7z` files. +> Similar to `7z` except that it only supports 7z files. > More information: . - [a]rchive a file or directory: diff --git a/pages/common/ack.md b/pages/common/ack.md index 1ca3690ec..a58bba6e6 100644 --- a/pages/common/ack.md +++ b/pages/common/ack.md @@ -18,11 +18,11 @@ - Limit search to files of a specific type: -`ack --type={{ruby}} "{{search_pattern}}"` +`ack --type {{ruby}} "{{search_pattern}}"` - Do not search in files of a specific type: -`ack --type=no{{ruby}} "{{search_pattern}}"` +`ack --type no{{ruby}} "{{search_pattern}}"` - Count the total number of matches found: diff --git a/pages/common/adb-logcat.md b/pages/common/adb-logcat.md index dfb658282..8e2b9e6f3 100644 --- a/pages/common/adb-logcat.md +++ b/pages/common/adb-logcat.md @@ -25,11 +25,11 @@ - Display logs for a specific PID: -`adb logcat --pid={{pid}}` +`adb logcat --pid {{pid}}` - Display logs for the process of a specific package: -`adb logcat --pid=$(adb shell pidof -s {{package}})` +`adb logcat --pid $(adb shell pidof -s {{package}})` - Color the log (usually use with filters): diff --git a/pages/common/age-keygen.md b/pages/common/age-keygen.md index e52e582a4..c6e2eac19 100644 --- a/pages/common/age-keygen.md +++ b/pages/common/age-keygen.md @@ -1,7 +1,7 @@ # age-keygen > Generate `age` key pairs. -> See `age` for how to encrypt/decrypt files. +> See also: `age` for encrypting/decrypting files. > More information: . - Generate a key pair, save it to an unencrypted file, and print the public key to `stdout`: diff --git a/pages/common/age.md b/pages/common/age.md index a2b5f9609..460d013e5 100644 --- a/pages/common/age.md +++ b/pages/common/age.md @@ -1,7 +1,7 @@ # age > A simple, modern and secure file encryption tool. -> See `age-keygen` for how to generate key pairs. +> See also: `age-keygen` for generating key pairs. > More information: . - Generate an encrypted file that can be decrypted with a passphrase: diff --git a/pages/common/ajson.md b/pages/common/ajson.md index 54da01cf0..9d70fc011 100644 --- a/pages/common/ajson.md +++ b/pages/common/ajson.md @@ -1,6 +1,6 @@ # ajson -> Executes JSONPath on JSON objects. +> Execute JSONPath on JSON objects. > More information: . - Read JSON from a file and execute a specified JSONPath expression: diff --git a/pages/common/alacritty.md b/pages/common/alacritty.md index dbc67ebe5..58a5cb981 100644 --- a/pages/common/alacritty.md +++ b/pages/common/alacritty.md @@ -15,10 +15,10 @@ `alacritty -e {{command}}` -- Use an alternative configuration file (defaults to `$XDG_CONFIG_HOME/alacritty/alacritty.yml`): +- Use an alternative configuration file (defaults to `$XDG_CONFIG_HOME/alacritty/alacritty.toml`): -`alacritty --config-file {{path/to/config.yml}}` +`alacritty --config-file {{path/to/config.toml}}` -- Run with live configuration reload enabled (can also be enabled by default in `alacritty.yml`): +- Run with live configuration reload enabled (can also be enabled by default in `alacritty.toml`): -`alacritty --live-config-reload --config-file {{path/to/config.yml}}` +`alacritty --live-config-reload --config-file {{path/to/config.toml}}` diff --git a/pages/common/alias.md b/pages/common/alias.md index af01ccf83..cf59fd154 100644 --- a/pages/common/alias.md +++ b/pages/common/alias.md @@ -1,6 +1,6 @@ # alias -> Creates aliases -- words that are replaced by a command string. +> Create aliases - words that are replaced by a command string. > Aliases expire with the current shell session unless defined in the shell's configuration file, e.g. `~/.bashrc`. > More information: . diff --git a/pages/common/amass-db.md b/pages/common/amass-db.md deleted file mode 100644 index 78185cbd5..000000000 --- a/pages/common/amass-db.md +++ /dev/null @@ -1,20 +0,0 @@ -# amass db - -> Interact with an Amass database. -> More information: . - -- List all performed enumerations in the database: - -`amass db -dir {{path/to/database_directory}} -list` - -- Show results for a specified enumeration index and [d]omain name: - -`amass db -dir {{path/to/database_directory}} -d {{domain_name}} -enum {{index_from_list}} -show` - -- List all found subdomains of a [d]omain within an enumeration: - -`amass db -dir {{path/to/database_directory}} -d {{domain_name}} -enum {{index_from_list}} -names` - -- Show a summary of the found subdomains within an enumeration: - -`amass db -dir {{path/to/database_directory}} -d {{domain_name}} -enum {{index_from_list}} -summary` diff --git a/pages/common/amass-enum.md b/pages/common/amass-enum.md index f7be6935b..af850d0e4 100644 --- a/pages/common/amass-enum.md +++ b/pages/common/amass-enum.md @@ -1,17 +1,17 @@ # amass enum > Find subdomains of a domain. -> More information: . +> More information: . -- Passively find subdomains of a [d]omain: +- Find (passively) subdomains of a [d]omain: -`amass enum -passive -d {{domain_name}}` +`amass enum -d {{domain_name}}` - Find subdomains of a [d]omain and actively verify them attempting to resolve the found subdomains: `amass enum -active -d {{domain_name}} -p {{80,443,8080}}` -- Do a brute force search for subdomains: +- Do a brute force search for sub[d]omains: `amass enum -brute -d {{domain_name}}` @@ -19,6 +19,10 @@ `amass enum -o {{output_file}} -d {{domain_name}}` -- Save the results to a database: +- Save terminal output to a file and other detailed output to a directory: -`amass enum -o {{output_file}} -dir {{path/to/database_directory}}` +`amass enum -o {{output_file}} -dir {{path/to/directory}} -d {{domain_name}}` + +- List all available data sources: + +`amass enum -list` diff --git a/pages/common/amass-intel.md b/pages/common/amass-intel.md index 63f2b29a1..f9ef04e6c 100644 --- a/pages/common/amass-intel.md +++ b/pages/common/amass-intel.md @@ -1,9 +1,9 @@ # amass intel > Collect open source intel on an organisation like root domains and ASNs. -> More information: . +> More information: . -- Find root domains in an IP address range: +- Find root domains in an IP [addr]ess range: `amass intel -addr {{192.168.0.1-254}}` @@ -15,7 +15,7 @@ `amass intel -whois -d {{domain_name}}` -- Find ASNs belonging to an organisation: +- Find ASNs belonging to an [org]anisation: `amass intel -org {{organisation_name}}` @@ -26,3 +26,7 @@ - Save results to a text file: `amass intel -o {{output_file}} -whois -d {{domain_name}}` + +- List all available data sources: + +`amass intel -list` diff --git a/pages/common/amass.md b/pages/common/amass.md index b3b87e9bd..aae7b17b8 100644 --- a/pages/common/amass.md +++ b/pages/common/amass.md @@ -1,20 +1,20 @@ # amass > In-depth Attack Surface Mapping and Asset Discovery tool. -> Some subcommands such as `amass db` have their own usage documentation. -> More information: . +> Some subcommands such as `amass intel` have their own usage documentation. +> More information: . - Execute an Amass subcommand: -`amass {{subcommand}}` +`amass {{intel|enum}} {{options}}` - Display help: `amass -help` -- Display help on an Amass subcommand (like `intel`, `enum`, etc.): +- Display help on an Amass subcommand: -`amass -help {{subcommand}}` +`amass {{intel|enum}} -help` - Display version: diff --git a/pages/common/ansible-playbook.md b/pages/common/ansible-playbook.md index c7b338452..8d3e0a38f 100644 --- a/pages/common/ansible-playbook.md +++ b/pages/common/ansible-playbook.md @@ -26,3 +26,7 @@ - Run tasks in a playbook starting at a specific task: `ansible-playbook {{playbook}} --start-at {{task_name}}` + +- Run tasks in a playbook without making any changes (dry-run): + +`ansible-playbook {{playbook}} --check --diff` diff --git a/pages/common/ansible-vault.md b/pages/common/ansible-vault.md index 66c242f58..27573b5c5 100644 --- a/pages/common/ansible-vault.md +++ b/pages/common/ansible-vault.md @@ -1,6 +1,6 @@ # ansible-vault -> Encrypts & decrypts values, data structures and files within Ansible projects. +> Encrypt and decrypt values, data structures and files within Ansible projects. > More information: . - Create a new encrypted vault file with a prompt for a password: @@ -9,11 +9,11 @@ - Create a new encrypted vault file using a vault key file to encrypt it: -`ansible-vault create --vault-password-file={{password_file}} {{vault_file}}` +`ansible-vault create --vault-password-file {{password_file}} {{vault_file}}` - Encrypt an existing file using an optional password file: -`ansible-vault encrypt --vault-password-file={{password_file}} {{vault_file}}` +`ansible-vault encrypt --vault-password-file {{password_file}} {{vault_file}}` - Encrypt a string using Ansible's encrypted string format, displaying interactive prompts: @@ -21,8 +21,8 @@ - View an encrypted file, using a password file to decrypt: -`ansible-vault view --vault-password-file={{password_file}} {{vault_file}}` +`ansible-vault view --vault-password-file {{password_file}} {{vault_file}}` - Re-key already encrypted vault file with a new password file: -`ansible-vault rekey --vault-password-file={{old_password_file}} --new-vault-password-file={{new_password_file}} {{vault_file}}` +`ansible-vault rekey --vault-password-file {{old_password_file}} --new-vault-password-file {{new_password_file}} {{vault_file}}` diff --git a/pages/common/ansiweather.md b/pages/common/ansiweather.md index 49ae96e0e..4f30a1597 100644 --- a/pages/common/ansiweather.md +++ b/pages/common/ansiweather.md @@ -1,6 +1,6 @@ # ansiweather -> A shell script for displaying the current weather conditions in your terminal. +> Display the current weather conditions in your terminal. > More information: . - Display a [f]orecast using metric [u]nits for the next seven days for a specific [l]ocation: diff --git a/pages/common/anytopnm.md b/pages/common/anytopnm.md index af7381906..e3f4c805d 100644 --- a/pages/common/anytopnm.md +++ b/pages/common/anytopnm.md @@ -1,6 +1,6 @@ # anytopnm -> Converts an arbitrary type of image file to common image formats. +> Convert an arbitrary type of image file to common image formats. > More information: . - Convert an input image to PBM, PGM, or PPM format irrespective of the input type: diff --git a/pages/common/apg.md b/pages/common/apg.md index 8778068ca..59902940e 100644 --- a/pages/common/apg.md +++ b/pages/common/apg.md @@ -1,6 +1,6 @@ # apg -> Creates arbitrarily complex random passwords. +> Create arbitrarily complex random passwords. > More information: . - Create random passwords (default password length is 8): diff --git a/pages/common/apkleaks.md b/pages/common/apkleaks.md new file mode 100644 index 000000000..17c57fef7 --- /dev/null +++ b/pages/common/apkleaks.md @@ -0,0 +1,17 @@ +# apkleaks + +> Expose URIs, endpoints, and secrets from APK files. +> Note: APKLeaks utilizes the `jadx` disassembler to decompile APK files. +> More information: . + +- Scan an APK [f]ile for URIs, endpoints, and secrets: + +`apkleaks --file {{path/to/file.apk}}` + +- Scan and save the [o]utput to a specific file: + +`apkleaks --file {{path/to/file.apk}} --output {{path/to/output.txt}}` + +- Pass `jadx` disassembler [a]rguments: + +`apkleaks --file {{path/to/file.apk}} --args "{{--threads-count 5 --deobf}}"` diff --git a/pages/common/apm.md b/pages/common/apm.md index 793af24ed..1b35576be 100644 --- a/pages/common/apm.md +++ b/pages/common/apm.md @@ -1,7 +1,7 @@ # apm > Atom editor Package Manager. -> See `atom`. +> See also: `atom`. > More information: . - Install a package from or a theme from : diff --git a/pages/common/archwiki-rs.md b/pages/common/archwiki-rs.md new file mode 100644 index 000000000..9d4a4305e --- /dev/null +++ b/pages/common/archwiki-rs.md @@ -0,0 +1,20 @@ +# archwiki-rs + +> Read, search and download pages from the ArchWiki. +> More information: . + +- Read a page from the ArchWiki: + +`archwiki-rs read-page {{page_title}}` + +- Read a page from the ArchWiki in the specified format: + +`archwiki-rs read-page {{page_title}} --format {{plain-text|markdown|html}}` + +- Search the ArchWiki for pages containing the provided text: + +`archwiki-rs search "{{search_text}}" --text-search` + +- Download a local copy of all ArchWiki pages into a specific directory: + +`archwiki-rs local-wiki {{/path/to/local_wiki}} --format {{plain-text|markdown|html}}` diff --git a/pages/common/aria2c.md b/pages/common/aria2c.md index 0a5cc6830..a13b70c2e 100644 --- a/pages/common/aria2c.md +++ b/pages/common/aria2c.md @@ -10,7 +10,7 @@ - Download a file from a URI with a specific output name: -`aria2c --out={{path/to/file}} "{{url}}"` +`aria2c --out {{path/to/file}} "{{url}}"` - Download multiple different files in parallel: @@ -18,20 +18,20 @@ - Download the same file from different mirrors and verify the checksum of the downloaded file: -`aria2c --checksum={{sha-256}}={{hash}} "{{url1}}" "{{url2}}" "{{urlN}}"` +`aria2c --checksum {{sha-256}}={{hash}} "{{url1}}" "{{url2}}" "{{urlN}}"` - Download the URIs listed in a file with a specific number of parallel downloads: -`aria2c --input-file={{path/to/file}} --max-concurrent-downloads={{number_of_downloads}}` +`aria2c --input-file {{path/to/file}} --max-concurrent-downloads {{number_of_downloads}}` - Download with multiple connections: -`aria2c --split={{number_of_connections}} "{{url}}"` +`aria2c --split {{number_of_connections}} "{{url}}"` - FTP download with username and password: -`aria2c --ftp-user={{username}} --ftp-passwd={{password}} "{{url}}"` +`aria2c --ftp-user {{username}} --ftp-passwd {{password}} "{{url}}"` - Limit download speed in bytes/s: -`aria2c --max-download-limit={{speed}} "{{url}}"` +`aria2c --max-download-limit {{speed}} "{{url}}"` diff --git a/pages/common/asciidoctor.md b/pages/common/asciidoctor.md index c5e939372..8c1b46d6d 100644 --- a/pages/common/asciidoctor.md +++ b/pages/common/asciidoctor.md @@ -9,7 +9,7 @@ - Convert a specific `.adoc` file to HTML and link a CSS stylesheet: -`asciidoctor -a stylesheet={{path/to/stylesheet.css}} {{path/to/file.adoc}}` +`asciidoctor -a stylesheet {{path/to/stylesheet.css}} {{path/to/file.adoc}}` - Convert a specific `.adoc` file to embeddable HTML, removing everything except the body: @@ -17,4 +17,4 @@ - Convert a specific `.adoc` file to a PDF using the `asciidoctor-pdf` library: -`asciidoctor --backend={{pdf}} --require={{asciidoctor-pdf}} {{path/to/file.adoc}}` +`asciidoctor --backend {{pdf}} --require {{asciidoctor-pdf}} {{path/to/file.adoc}}` diff --git a/pages/common/audacious.md b/pages/common/audacious.md index 2ce42e669..08fbd1ac7 100755 --- a/pages/common/audacious.md +++ b/pages/common/audacious.md @@ -1,6 +1,7 @@ # audacious > An open-source audio player. Indirectly based on XMMS. +> See also: `audtool`, `clementine`, `mpc`, `ncmpcpp`. > More information: . - Launch the GUI: diff --git a/pages/common/audtool.md b/pages/common/audtool.md new file mode 100755 index 000000000..29b39451b --- /dev/null +++ b/pages/common/audtool.md @@ -0,0 +1,37 @@ +# audtool + +> Control Audacious using commands. +> See also: `audacious`. +> More information: . + +- Play/pause audio playback: + +`audtool playback-playpause` + +- Print artist, album, and song name of currently playing song: + +`audtool current-song` + +- Set volume of audio playback: + +`audtool set-volume {{100}}` + +- Skip to the next song: + +`audtool playlist-advance` + +- Print the bitrate of the current song in kilobits: + +`audtool current-song-bitrate-kbps` + +- Open Audacious in full-screen if hidden: + +`audtool mainwin-show` + +- Display help: + +`audtool help` + +- Display settings: + +`audtool preferences-show` diff --git a/pages/common/autoconf.md b/pages/common/autoconf.md index 701d007d5..d8b18e956 100644 --- a/pages/common/autoconf.md +++ b/pages/common/autoconf.md @@ -13,4 +13,4 @@ - Generate a configuration script from the specified template (even if the input file has not changed) and write the output to a file: -`autoconf --force --output={{outfile}} {{template-file}}` +`autoconf --force --output {{outfile}} {{template-file}}` diff --git a/pages/common/autossh.md b/pages/common/autossh.md index 7a9c04f4c..c967934d1 100644 --- a/pages/common/autossh.md +++ b/pages/common/autossh.md @@ -1,7 +1,7 @@ # autossh > Run, monitor and restart SSH connections. -> Auto-reconnects to keep port forwarding tunnels up. Accepts all `ssh` flags. +> Auto-reconnects to keep port forwarding tunnels up. Accepts all SSH flags. > More information: . - Start an SSH session, restarting when the [M]onitoring port fails to return data: @@ -12,7 +12,7 @@ `autossh -M {{monitor_port}} -L {{local_port}}:localhost:{{remote_port}} {{user}}@{{host}}` -- Fork `autossh` into the background before executing `ssh` and do [N]ot open a remote shell: +- Fork `autossh` into the background before executing SSH and do [N]ot open a remote shell: `autossh -f -M {{monitor_port}} -N "{{ssh_command}}"` @@ -24,6 +24,6 @@ `autossh -f -M 0 -N -o "ServerAliveInterval 10" -o "ServerAliveCountMax 3" -o ExitOnForwardFailure=yes -L {{local_port}}:localhost:{{remote_port}} {{user}}@{{host}}` -- Run in the background, logging `autossh` debug output and `ssh` verbose output to files: +- Run in the background, logging `autossh` debug output and SSH verbose output to files: `AUTOSSH_DEBUG=1 AUTOSSH_LOGFILE={{path/to/autossh_log_file.log}} autossh -f -M {{monitor_port}} -v -E {{path/to/ssh_log_file.log}} {{ssh_command}}` diff --git a/pages/common/avrdude.md b/pages/common/avrdude.md index 7480b2c15..0e96950dd 100644 --- a/pages/common/avrdude.md +++ b/pages/common/avrdude.md @@ -3,7 +3,7 @@ > Driver program for Atmel AVR microcontrollers programming. > More information: . -- [r]ead the flash ROM of a AVR microcontroller with a specific [p]art id: +- [r]ead the flash ROM of a AVR microcontroller with a specific [p]art ID: `avrdude -p {{part_no}} -c {{programmer_id}} -U flash:r:{{file.hex}}:i` diff --git a/pages/common/aws-glue.md b/pages/common/aws-glue.md index 3d35dafc1..ea16204a7 100644 --- a/pages/common/aws-glue.md +++ b/pages/common/aws-glue.md @@ -1,7 +1,7 @@ # aws glue > CLI for AWS Glue. -> Defines the public endpoint for the AWS Glue service. +> Define the public endpoint for the AWS Glue service. > More information: . - List jobs: diff --git a/pages/common/az-sshkey.md b/pages/common/az-sshkey.md index 4a83735f7..e07eb6c14 100644 --- a/pages/common/az-sshkey.md +++ b/pages/common/az-sshkey.md @@ -1,6 +1,6 @@ # az sshkey -> Manage ssh public keys with virtual machines. +> Manage SSH public keys with virtual machines. > Part of `azure-cli` (also known as `az`). > More information: . diff --git a/pages/common/az-vm.md b/pages/common/az-vm.md index 686f66f02..b91d79bb5 100644 --- a/pages/common/az-vm.md +++ b/pages/common/az-vm.md @@ -8,7 +8,7 @@ `az vm list` -- Create a virtual machine using the default Ubuntu image and generate ssh keys: +- Create a virtual machine using the default Ubuntu image and generate SSH keys: `az vm create --resource-group {{rg}} --name {{vm_name}} --image {{UbuntuLTS}} --admin-user {{azureuser}} --generate-ssh-keys` diff --git a/pages/common/azurite.md b/pages/common/azurite.md index d2a7d2ca0..15bde6661 100644 --- a/pages/common/azurite.md +++ b/pages/common/azurite.md @@ -3,7 +3,7 @@ > Azure Storage API compatible server (emulator) in local environment. > More information: . -- Use an existing [l]ocation as workspace path: +- Use an existing location as workspace path: `azurite {{-l|--location}} {{path/to/directory}}` @@ -11,7 +11,7 @@ `azurite {{-s|--silent}}` -- Enable [d]ebug log by providing a file path as log destination: +- Enable debug log by providing a file path as log destination: `azurite {{-d|--debug}} {{path/to/debug.log}}` diff --git a/pages/common/base32.md b/pages/common/base32.md index 561f9a3cb..9186f0dcc 100644 --- a/pages/common/base32.md +++ b/pages/common/base32.md @@ -7,6 +7,10 @@ `base32 {{path/to/file}}` +- Wrap encoded output at a specific width (`0` disables wrapping): + +`base32 --wrap {{0|76|...}} {{path/to/file}}` + - Decode a file: `base32 --decode {{path/to/file}}` diff --git a/pages/common/base64.md b/pages/common/base64.md index db38de926..40de5afa5 100644 --- a/pages/common/base64.md +++ b/pages/common/base64.md @@ -7,6 +7,10 @@ `base64 {{path/to/file}}` +- Wrap encoded output at a specific width (`0` disables wrapping): + +`base64 --wrap {{0|76|...}} {{path/to/file}}` + - Decode the base64 contents of a file and write the result to `stdout`: `base64 --decode {{path/to/file}}` diff --git a/pages/common/bc.md b/pages/common/bc.md index e6abc6992..a2b8212c8 100644 --- a/pages/common/bc.md +++ b/pages/common/bc.md @@ -2,7 +2,7 @@ > An arbitrary precision calculator language. > See also: `dc`. -> More information: . +> More information: . - Start an interactive session: diff --git a/pages/common/behat.md b/pages/common/behat.md index a39cb0d08..74ff33fce 100644 --- a/pages/common/behat.md +++ b/pages/common/behat.md @@ -13,7 +13,7 @@ - Run all tests from the specified suite: -`behat --suite={{suite_name}}` +`behat --suite {{suite_name}}` - Run tests with a specific output formatter: diff --git a/pages/common/black.md b/pages/common/black.md index 9384454dc..84c8729a6 100644 --- a/pages/common/black.md +++ b/pages/common/black.md @@ -1,6 +1,6 @@ # black -> A Python auto code formatter. +> Format Python code automatically. > More information: . - Auto-format a file or entire directory: diff --git a/pages/common/blackfire.md b/pages/common/blackfire.md index 45d254a10..d80bf674f 100644 --- a/pages/common/blackfire.md +++ b/pages/common/blackfire.md @@ -21,7 +21,7 @@ - Run the profiler and collect 10 samples: -`blackfire --samples={{10}} run {{php path/to/file.php}}` +`blackfire --samples {{10}} run {{php path/to/file.php}}` - Run the profiler and output results as JSON: diff --git a/pages/common/borg.md b/pages/common/borg.md index b9829f78d..54eae49c4 100644 --- a/pages/common/borg.md +++ b/pages/common/borg.md @@ -1,7 +1,7 @@ # borg > Deduplicating backup tool. -> Creates local or remote backups that are mountable as filesystems. +> Create local or remote backups that are mountable as filesystems. > More information: . - Initialize a (local) repository: diff --git a/pages/common/bpkg.md b/pages/common/bpkg.md new file mode 100644 index 000000000..9004424e8 --- /dev/null +++ b/pages/common/bpkg.md @@ -0,0 +1,28 @@ +# bpkg + +> A package manager for Bash scripts. +> More information: . + +- Update the local index: + +`bpkg update` + +- Install a package globally: + +`bpkg install --global {{package}}` + +- Install a package in a subdirectory of the current directory: + +`bpkg install {{package}}` + +- Install a specific version of a package globally: + +`bpkg install {{package}}@{{version}} -g` + +- Show details about a specific package: + +`bpkg show {{package}}` + +- Run a command, optionally specifying its arguments: + +`bpkg run {{command}} {{argument1 argument2 ...}}` diff --git a/pages/common/bq.md b/pages/common/bq.md index 053ddc80f..5a620e093 100644 --- a/pages/common/bq.md +++ b/pages/common/bq.md @@ -21,7 +21,7 @@ - Batch load data from a specific file in formats such as CSV, JSON, Parquet, and Avro to a table: -`bq load --location={{location}} --source_format={{CSV|JSON|PARQUET|AVRO}} {{dataset}}.{{table}} {{path_to_source}}` +`bq load --location {{location}} --source_format {{CSV|JSON|PARQUET|AVRO}} {{dataset}}.{{table}} {{path_to_source}}` - Copy one table to another: diff --git a/pages/common/brew-bundle.md b/pages/common/brew-bundle.md index fa79b897b..bebbfa594 100644 --- a/pages/common/brew-bundle.md +++ b/pages/common/brew-bundle.md @@ -9,7 +9,7 @@ - Install packages from a specific Brewfile at a specific path: -`brew bundle --file={{path/to/file}}` +`brew bundle --file {{path/to/file}}` - Create a Brewfile from all installed packages: diff --git a/pages/common/bru.md b/pages/common/bru.md index f2df97edc..799fe5c1f 100644 --- a/pages/common/bru.md +++ b/pages/common/bru.md @@ -1,7 +1,7 @@ # bru > CLI for Bruno, an Opensource IDE for exploring and testing APIs. -> More information: . +> More information: . - Run all request files from the current directory: diff --git a/pages/common/bshell.md b/pages/common/bshell.md index 55d1f9182..cd9938283 100644 --- a/pages/common/bshell.md +++ b/pages/common/bshell.md @@ -18,4 +18,4 @@ - Browse for both SSH and VNC servers in a specified domain: -`bshell --domain={{domain}}` +`bshell --domain {{domain}}` diff --git a/pages/common/bssh.md b/pages/common/bssh.md index f20b27136..63e284a17 100644 --- a/pages/common/bssh.md +++ b/pages/common/bssh.md @@ -18,4 +18,4 @@ - Browse for SSH servers in a specified domain: -`bssh --domain={{domain}}` +`bssh --domain {{domain}}` diff --git a/pages/common/bundletool-dump.md b/pages/common/bundletool-dump.md index c0419e704..4c331834f 100644 --- a/pages/common/bundletool-dump.md +++ b/pages/common/bundletool-dump.md @@ -5,28 +5,28 @@ - Display the `AndroidManifest.xml` of the base module: -`bundletool dump manifest --bundle={{path/to/bundle.aab}}` +`bundletool dump manifest --bundle {{path/to/bundle.aab}}` - Display a specific value from the `AndroidManifest.xml` using XPath: -`bundletool dump manifest --bundle={{path/to/bundle.aab}} --xpath={{/manifest/@android:versionCode}}` +`bundletool dump manifest --bundle {{path/to/bundle.aab}} --xpath {{/manifest/@android:versionCode}}` - Display the `AndroidManifest.xml` of a specific module: -`bundletool dump manifest --bundle={{path/to/bundle.aab}} --module={{name}}` +`bundletool dump manifest --bundle {{path/to/bundle.aab}} --module {{name}}` - Display all the resources in the application bundle: -`bundletool dump resources --bundle={{path/to/bundle.aab}}` +`bundletool dump resources --bundle {{path/to/bundle.aab}}` - Display the configuration for a specific resource: -`bundletool dump resources --bundle={{path/to/bundle.aab}} --resource={{type/name}}` +`bundletool dump resources --bundle {{path/to/bundle.aab}} --resource {{type/name}}` - Display the configuration and values for a specific resource using the ID: -`bundletool dump resources --bundle={{path/to/bundle.aab}} --resource={{0x7f0e013a}} --values` +`bundletool dump resources --bundle {{path/to/bundle.aab}} --resource {{0x7f0e013a}} --values` - Display the contents of the bundle configuration file: -`bundletool dump config --bundle={{path/to/bundle.aab}}` +`bundletool dump config --bundle {{path/to/bundle.aab}}` diff --git a/pages/common/bundletool-validate.md b/pages/common/bundletool-validate.md index 82b585758..52e7e7d09 100644 --- a/pages/common/bundletool-validate.md +++ b/pages/common/bundletool-validate.md @@ -5,4 +5,4 @@ - Verify a bundle and display detailed information about it: -`bundletool validate --bundle={{path/to/bundle.aab}}` +`bundletool validate --bundle {{path/to/bundle.aab}}` diff --git a/pages/common/bundletool.md b/pages/common/bundletool.md index c7df744a0..9d3448355 100644 --- a/pages/common/bundletool.md +++ b/pages/common/bundletool.md @@ -10,28 +10,28 @@ - Generate APKs from an application bundle (prompts for keystore password): -`bundletool build-apks --bundle={{path/to/bundle.aab}} --ks={{path/to/key.keystore}} --ks-key-alias={{key_alias}} --output={{path/to/file.apks}}` +`bundletool build-apks --bundle {{path/to/bundle.aab}} --ks {{path/to/key.keystore}} --ks-key-alias {{key_alias}} --output {{path/to/file.apks}}` - Generate APKs from an application bundle giving the keystore password: -`bundletool build-apks --bundle={{path/to/bundle.aab}} --ks={{path/to/key.keystore}} --ks-key-alias={{key_alias}} –ks-pass={{pass:the_password}} --output={{path/to/file.apks}}` +`bundletool build-apks --bundle {{path/to/bundle.aab}} --ks {{path/to/key.keystore}} --ks-key-alias {{key_alias}} –ks-pass {{pass:the_password}} --output {{path/to/file.apks}}` - Generate APKs including only one single APK for universal usage: -`bundletool build-apks --bundle={{path/to/bundle.aab}} --mode={{universal}} --ks={{path/to/key.keystore}} --ks-key-alias={{key_alias}} --output={{path/to/file.apks}}` +`bundletool build-apks --bundle {{path/to/bundle.aab}} --mode {{universal}} --ks {{path/to/key.keystore}} --ks-key-alias {{key_alias}} --output {{path/to/file.apks}}` - Install the right combination of APKs to an emulator or device: -`bundletool install-apks --apks={{path/to/file.apks}}` +`bundletool install-apks --apks {{path/to/file.apks}}` - Estimate the download size of an application: -`bundletool get-size total --apks={{path/to/file.apks}}` +`bundletool get-size total --apks {{path/to/file.apks}}` - Generate a device specification JSON file for an emulator or device: -`bundletool get-device-spec --output={{path/to/file.json}}` +`bundletool get-device-spec --output {{path/to/file.json}}` - Verify a bundle and display detailed information about it: -`bundletool validate --bundle={{path/to/bundle.aab}}` +`bundletool validate --bundle {{path/to/bundle.aab}}` diff --git a/pages/common/bvnc.md b/pages/common/bvnc.md index a8a26ff69..63e3f60a3 100644 --- a/pages/common/bvnc.md +++ b/pages/common/bvnc.md @@ -18,4 +18,4 @@ - Browse for VNC servers in a specified domain: -`bvnc --domain={{domain}}` +`bvnc --domain {{domain}}` diff --git a/pages/common/bzegrep.md b/pages/common/bzegrep.md index 020e3f76e..c09fe7f0f 100644 --- a/pages/common/bzegrep.md +++ b/pages/common/bzegrep.md @@ -23,6 +23,6 @@ `bzegrep --only-matching "{{search_pattern}}" {{path/to/file}}` -- Recursively search files in a `bzip2` compressed `tar` archive for a pattern: +- Recursively search files in a bzip2 compressed tar archive for a pattern: `bzegrep --recursive "{{search_pattern}}" {{path/to/file}}` diff --git a/pages/common/bzfgrep.md b/pages/common/bzfgrep.md index 32363f427..9a79a764c 100644 --- a/pages/common/bzfgrep.md +++ b/pages/common/bzfgrep.md @@ -23,6 +23,6 @@ `bzfgrep --only-matching "{{search_string}}" {{path/to/file}}` -- Recursively search files in a `bzip2` compressed `tar` archive for the given list of strings: +- Recursively search files in a bzip2 compressed tar archive for the given list of strings: `bzfgrep --recursive "{{search_string}}" {{path/to/file}}` diff --git a/pages/common/bzgrep.md b/pages/common/bzgrep.md index a32a6c8e8..e5581f868 100644 --- a/pages/common/bzgrep.md +++ b/pages/common/bzgrep.md @@ -23,7 +23,7 @@ `bzgrep --only-matching "{{search_pattern}}" {{path/to/file}}` -- Recursively search files in a `bzip2` compressed `tar` archive for a pattern: +- Recursively search files in a bzip2 compressed tar archive for a pattern: `bzgrep --recursive "{{search_pattern}}" {{path/to/tar/file}}` diff --git a/pages/common/c99.md b/pages/common/c99.md index ff34631f4..86d8c4444 100644 --- a/pages/common/c99.md +++ b/pages/common/c99.md @@ -1,6 +1,6 @@ # c99 -> Compiles C programs according to the ISO C standard. +> Compile C programs according to the ISO C standard. > More information: . - Compile source file(s) and create an executable: diff --git a/pages/common/cabal.md b/pages/common/cabal.md index 927a5d39a..bec058ee4 100644 --- a/pages/common/cabal.md +++ b/pages/common/cabal.md @@ -2,7 +2,7 @@ > Command-line interface to the Haskell package infrastructure (Cabal). > Manage Haskell projects and Cabal packages from the Hackage package repository. -> More information: . +> More information: . - Search and list packages from Hackage: diff --git a/pages/common/cal.md b/pages/common/cal.md index fb520c6aa..6bcf8e45b 100644 --- a/pages/common/cal.md +++ b/pages/common/cal.md @@ -1,6 +1,7 @@ # cal > Display a calendar with the current day highlighted. +> See also: `gcal`. > More information: . - Display a calendar for the current month: diff --git a/pages/common/cargo-init.md b/pages/common/cargo-init.md index f5af6bb53..d829d2ec6 100644 --- a/pages/common/cargo-init.md +++ b/pages/common/cargo-init.md @@ -1,7 +1,7 @@ # cargo init > Create a new Cargo package. -> Equivalent of `cargo new`, but specifiying a directory is optional. +> Equivalent of `cargo new`, but specifying a directory is optional. > More information: . - Initialize a Rust project with a binary target in the current directory: diff --git a/pages/common/cargo-new.md b/pages/common/cargo-new.md index e46ad0a04..688e56d20 100644 --- a/pages/common/cargo-new.md +++ b/pages/common/cargo-new.md @@ -1,7 +1,7 @@ # cargo new > Create a new Cargo package. -> Equivalent of `cargo init`, but specifiying a directory is required. +> Equivalent of `cargo init`, but specifying a directory is required. > More information: . - Create a new Rust project with a binary target: diff --git a/pages/common/cargo-report.md b/pages/common/cargo-report.md index 80f8dea2f..ebe24cfb2 100644 --- a/pages/common/cargo-report.md +++ b/pages/common/cargo-report.md @@ -7,7 +7,7 @@ `cargo report {{future-incompatibilities|...}}` -- Display a report with the specified Cargo-generated id: +- Display a report with the specified Cargo-generated ID: `cargo report {{future-incompatibilities|...}} --id {{id}}` diff --git a/pages/common/cheatshh.md b/pages/common/cheatshh.md new file mode 100644 index 000000000..761162744 --- /dev/null +++ b/pages/common/cheatshh.md @@ -0,0 +1,33 @@ +# cheatshh + +> CLI cheatsheet with customized descriptions, tldr and groups, to look into for your reference. +> Press Enter to a command to copy it to your clipboard and exit. +> More information: . + +- [a]dd a new command to the cheatshheet: + +`cheatshh --add` + +- Edit ([ec]) an existing command's description or group in the cheatshheet: + +`cheatshh --edit-command` + +- Delete ([dc]) an existing command from the cheatshheet: + +`cheatshh --delete-command` + +- Create a new [g]roup: + +`cheatshh --group` + +- Edit ([eg]) an existing group's name or description in the cheatsheet: + +`cheatshh --edit-group` + +- Delete ([dg]) an existing group and it's sub commands from commands.json file: + +`cheatshh --delete-group` + +- Display [m]an pages after tldr in the preview: + +`cheatshh --man` diff --git a/pages/common/chezmoi.md b/pages/common/chezmoi.md index e3ba86132..937574742 100644 --- a/pages/common/chezmoi.md +++ b/pages/common/chezmoi.md @@ -1,16 +1,25 @@ # Chezmoi > A multi-machine dotfile manager, written in Go. +> See also: `stow`, `tuckr`, `vcsh`, `homeshick`. > More information: . - Setup up `chezmoi`, creating a Git repository in `~/.local/share/chezmoi`: `chezmoi init` +- Set up `chezmoi` from existing dotfiles of a Git repository: + +`chezmoi init {{repository_url}}` + - Start tracking one or more dotfiles: `chezmoi add {{path/to/dotfile1 path/to/dotfile2 ...}}` +- Update repository with local changes: + +`chezmoi re-add {{path/to/dotfile1 path/to/dotfile2 ...}}` + - Edit the source state of a tracked dotfile: `chezmoi edit {{path/to/dotfile_or_symlink}}` @@ -23,10 +32,6 @@ `chezmoi -v apply` -- Set up `chezmoi` from existing dotfiles of a Git repository: - -`chezmoi init {{repository_url}}` - - Pull changes from a remote repository and apply them: `chezmoi update` diff --git a/pages/common/chgrp.md b/pages/common/chgrp.md index 5ee185ceb..3d641be6f 100644 --- a/pages/common/chgrp.md +++ b/pages/common/chgrp.md @@ -17,4 +17,4 @@ - Change the owner group of a file/directory to match a reference file: -`chgrp --reference={{path/to/reference_file}} {{path/to/file_or_directory}}` +`chgrp --reference {{path/to/reference_file}} {{path/to/file_or_directory}}` diff --git a/pages/common/chisel.md b/pages/common/chisel.md index d941e823d..5cd51d6ad 100644 --- a/pages/common/chisel.md +++ b/pages/common/chisel.md @@ -1,6 +1,7 @@ # chisel -> Create TCP tunnels. Includes both client and server. +> Create TCP/UDP tunnels, transported over HTTP, secured via SSH. +> Includes both client and server in the same `chisel` executable. > More information: . - Run a Chisel server: @@ -26,3 +27,11 @@ - Connect to a Chisel server using username and password authentication: `chisel client --auth {{username}}:{{password}} {{server_ip}}:{{server_port}} {{local_port}}:{{remote_server}}:{{remote_port}}` + +- Initialize a Chisel server in reverse mode on a specific port, also enabling SOCKS5 proxy (on port 1080) functionality: + +`chisel server -p {{server_port}} --reverse --socks5` + +- Connect to a Chisel server at specific IP and port, creating a reverse tunnel mapped to a local SOCKS proxy: + +`chisel client {{server_ip}}:{{server_port}} R:socks` diff --git a/pages/common/chown.md b/pages/common/chown.md index e89512a1e..0a3dc20e9 100644 --- a/pages/common/chown.md +++ b/pages/common/chown.md @@ -25,4 +25,4 @@ - Change the owner of a file/directory to match a reference file: -`chown --reference={{path/to/reference_file}} {{path/to/file_or_directory}}` +`chown --reference {{path/to/reference_file}} {{path/to/file_or_directory}}` diff --git a/pages/common/circo.md b/pages/common/circo.md index 19ec88dbf..17b132d79 100644 --- a/pages/common/circo.md +++ b/pages/common/circo.md @@ -4,19 +4,19 @@ > Layouts: `dot`, `neato`, `twopi`, `circo`, `fdp`, `sfdp`, `osage` & `patchwork`. > More information: . -- Render a `png` image with a filename based on the input filename and output format (uppercase -O): +- Render a PNG image with a filename based on the input filename and output format (uppercase -O): `circo -T {{png}} -O {{path/to/input.gv}}` -- Render a `svg` image with the specified output filename (lowercase -o): +- Render a SVG image with the specified output filename (lowercase -o): `circo -T {{svg}} -o {{path/to/image.svg}} {{path/to/input.gv}}` -- Render the output in `ps`, `pdf`, `svg`, `fig`, `png`, `gif`, `jpg`, `json`, or `dot` format: +- Render the output in PS, PDF, SVG, Fig, PNG, GIF, JPEG, JSON, or DOT format: `circo -T {{format}} -O {{path/to/input.gv}}` -- Render a `gif` image using `stdin` and `stdout`: +- Render a GIF image using `stdin` and `stdout`: `echo "{{digraph {this -> that} }}" | circo -T {{gif}} > {{path/to/image.gif}}` diff --git a/pages/common/clamdscan.md b/pages/common/clamdscan.md index a12e4586a..49da6c608 100644 --- a/pages/common/clamdscan.md +++ b/pages/common/clamdscan.md @@ -1,6 +1,6 @@ # clamdscan -> A command-line virus scanner using the ClamAV Daemon. +> Scan for viruses using the ClamAV Daemon. > More information: . - Scan a file or directory for vulnerabilities: diff --git a/pages/common/clang++.md b/pages/common/clang++.md index 532a1a4cf..1f51051ca 100644 --- a/pages/common/clang++.md +++ b/pages/common/clang++.md @@ -1,6 +1,6 @@ # clang++ -> Compiles C++ source files. +> Compile C++ source files. > Part of LLVM. > More information: . diff --git a/pages/common/clang-format.md b/pages/common/clang-format.md index d542af5eb..e955c869b 100644 --- a/pages/common/clang-format.md +++ b/pages/common/clang-format.md @@ -13,7 +13,7 @@ - Format a file using a predefined coding style: -`clang-format --style={{LLVM|GNU|Google|Chromium|Microsoft|Mozilla|WebKit}} {{path/to/file}}` +`clang-format --style {{LLVM|GNU|Google|Chromium|Microsoft|Mozilla|WebKit}} {{path/to/file}}` - Format a file using the `.clang-format` file in one of the parent directories of the source file: @@ -21,4 +21,4 @@ - Generate a custom `.clang-format` file: -`clang-format --style={{LLVM|GNU|Google|Chromium|Microsoft|Mozilla|WebKit}} --dump-config > {{.clang-format}}` +`clang-format --style {{LLVM|GNU|Google|Chromium|Microsoft|Mozilla|WebKit}} --dump-config > {{.clang-format}}` diff --git a/pages/common/clash.md b/pages/common/clash.md deleted file mode 100644 index 922c19c23..000000000 --- a/pages/common/clash.md +++ /dev/null @@ -1,12 +0,0 @@ -# clash - -> A rule-based tunnel in Go. -> More information: . - -- Specify a configuration [d]irectory: - -`clash -d {{path/to/directory}}` - -- Specify a configuration [f]ile: - -`clash -f {{path/to/configuration_file}}` diff --git a/pages/common/clementine.md b/pages/common/clementine.md index 86b3a5928..efe5acd18 100644 --- a/pages/common/clementine.md +++ b/pages/common/clementine.md @@ -1,6 +1,7 @@ # clementine > A modern music player and library organizer. +> See also: `audacious`, `qmmp`, `cmus`, `mpv`. > More information: . - Start the GUI or bring it to front: diff --git a/pages/common/clifm.md b/pages/common/clifm.md index 1ebe0c85d..b8466ed21 100644 --- a/pages/common/clifm.md +++ b/pages/common/clifm.md @@ -1,6 +1,7 @@ # clifm > The command-line file manager. +> See also: `vifm`, `ranger`, `mc`, `nautilus`. > More information: . - Start CliFM: diff --git a/pages/common/cmark.md b/pages/common/cmark.md index 2fb2a1ca1..cc56aae9e 100644 --- a/pages/common/cmark.md +++ b/pages/common/cmark.md @@ -1,6 +1,6 @@ # cmark -> Converts CommonMark Markdown formatted text to other formats. +> Convert CommonMark Markdown formatted text to other formats. > More information: . - Render a CommonMark Markdown file to HTML: diff --git a/pages/common/coffee.md b/pages/common/coffee.md index 40e367f5e..eca2d3d72 100644 --- a/pages/common/coffee.md +++ b/pages/common/coffee.md @@ -1,6 +1,6 @@ # coffee -> Executes CoffeeScript scripts or compiles them into JavaScript. +> Execute CoffeeScript scripts or compiles them into JavaScript. > More information: . - Run a script: diff --git a/pages/common/colima.md b/pages/common/colima.md new file mode 100644 index 000000000..ffafaea9c --- /dev/null +++ b/pages/common/colima.md @@ -0,0 +1,36 @@ +# colima + +> Container runtimes for macOS and Linux with minimal setup. +> More information: . + +- Start the daemon in the background: + +`colima start` + +- Create a configuration file and use it: + +`colima start --edit` + +- Start and setup containerd (install `nerdctl` to use containerd via `nerdctl`): + +`colima start --runtime containerd` + +- Start with Kubernetes (`kubectl` is required): + +`colima start --kubernetes` + +- Customize CPU count, RAM memory and disk space (in GiB): + +`colima start --cpu {{number}} --memory {{memory}} --disk {{storage_space}}` + +- Use Docker via Colima (Docker is required): + +`colima start` + +- List containers with their information and status: + +`colima list` + +- Show runtime status: + +`colima status` diff --git a/pages/common/compare.md b/pages/common/compare.md index fad9b0580..8c11516d5 100644 --- a/pages/common/compare.md +++ b/pages/common/compare.md @@ -1,13 +1,7 @@ # compare -> Create a comparison image to visually annotate the difference between two images. -> Part of ImageMagick. -> More information: . +> This command is an alias of `magick compare`. -- Compare two images: +- View documentation for the original command: -`compare {{path/to/image1.png}} {{path/to/image2.png}} {{path/to/diff.png}}` - -- Compare two images using the specified metric: - -`compare -verbose -metric {{PSNR}} {{path/to/image1.png}} {{path/to/image2.png}} {{path/to/diff.png}}` +`tldr magick compare` diff --git a/pages/common/complete.md b/pages/common/complete.md index 1bbfee8e3..b97d0b9d9 100644 --- a/pages/common/complete.md +++ b/pages/common/complete.md @@ -1,6 +1,6 @@ # complete -> Provides argument autocompletion to shell commands. +> Get argument autocompletion to shell commands. > More information: . - Apply a function that performs autocompletion to a command: diff --git a/pages/common/conan-frogarian.md b/pages/common/conan-frogarian.md index 504156941..c0635cee3 100644 --- a/pages/common/conan-frogarian.md +++ b/pages/common/conan-frogarian.md @@ -1,6 +1,6 @@ # conan frogarian -> Displays the conan frogarian. +> Display the conan frogarian. > More information: . - Display the conan frogarian: diff --git a/pages/common/convert.md b/pages/common/convert.md index a180a4863..510dfdd6c 100644 --- a/pages/common/convert.md +++ b/pages/common/convert.md @@ -1,37 +1,9 @@ # convert -> Convert between image formats, scale, join, and create images, and much more. -> Part of ImageMagick. -> More information: . +> This command is an alias of `magick convert`. +> Note: this alias is deprecated since ImageMagick 7. It has been replaced by `magick`. +> Use `magick convert` if you need to use the old tool in versions 7+. -- Convert an image from JPG to PNG: +- View documentation for the original command: -`convert {{path/to/input_image.jpg}} {{path/to/output_image.png}}` - -- Scale an image to 50% of its original size: - -`convert {{path/to/input_image.png}} -resize 50% {{path/to/output_image.png}}` - -- Scale an image keeping the original aspect ratio to a maximum dimension of 640x480: - -`convert {{path/to/input_image.png}} -resize 640x480 {{path/to/output_image.png}}` - -- Horizontally append images: - -`convert {{path/to/image1.png path/to/image2.png ...}} +append {{path/to/output_image.png}}` - -- Vertically append images: - -`convert {{path/to/image1.png path/to/image2.png ...}} -append {{path/to/output_image.png}}` - -- Create a GIF from a series of images with 100ms delay between them: - -`convert {{path/to/image1.png path/to/image2.png ...}} -delay {{10}} {{path/to/animation.gif}}` - -- Create an image with nothing but a solid red background: - -`convert -size {{800x600}} "xc:{{#ff0000}}" {{path/to/image.png}}` - -- Create a favicon from several images of different sizes: - -`convert {{path/to/image1.png path/to/image2.png ...}} {{path/to/favicon.ico}}` +`tldr magick convert` diff --git a/pages/common/cpio.md b/pages/common/cpio.md index 13f2ecd9d..459669a6d 100644 --- a/pages/common/cpio.md +++ b/pages/common/cpio.md @@ -1,6 +1,6 @@ # cpio -> Copies files in and out of archives. +> Copy files in and out of archives. > Supports the following archive formats: cpio's custom binary, old ASCII, new ASCII, crc, HPUX binary, HPUX old ASCII, old tar, and POSIX.1 tar. > More information: . diff --git a/pages/common/cppcheck.md b/pages/common/cppcheck.md index 5f4e308e8..995614d79 100644 --- a/pages/common/cppcheck.md +++ b/pages/common/cppcheck.md @@ -14,7 +14,7 @@ - Check a given file, specifying which tests to perform (by default only errors are shown): -`cppcheck --enable={{error|warning|style|performance|portability|information|all}} {{path/to/file.cpp}}` +`cppcheck --enable {{error|warning|style|performance|portability|information|all}} {{path/to/file.cpp}}` - List available tests: @@ -22,7 +22,7 @@ - Check a given file, ignoring specific tests: -`cppcheck --suppress={{test_id1}} --suppress={{test_id2}} {{path/to/file.cpp}}` +`cppcheck --suppress {{test_id1}} --suppress {{test_id2}} {{path/to/file.cpp}}` - Check the current directory, providing paths for include files located outside it (e.g. external libraries): @@ -30,4 +30,4 @@ - Check a Microsoft Visual Studio project (`*.vcxproj`) or solution (`*.sln`): -`cppcheck --project={{path/to/project.sln}}` +`cppcheck --project {{path/to/project.sln}}` diff --git a/pages/common/cppclean.md b/pages/common/cppclean.md index 3e7361607..cc1309d9b 100644 --- a/pages/common/cppclean.md +++ b/pages/common/cppclean.md @@ -9,7 +9,7 @@ - Run on a project where the headers are in the `inc1/` and `inc2/` directories: -`cppclean {{path/to/project}} --include-path={{inc1}} --include-path={{inc2}}` +`cppclean {{path/to/project}} --include-path {{inc1}} --include-path {{inc2}}` - Run on a specific file `main.cpp`: @@ -17,4 +17,4 @@ - Run on the current directory, excluding the "build" directory: -`cppclean {{.}} --exclude={{build}}` +`cppclean {{.}} --exclude {{build}}` diff --git a/pages/common/cradle-install.md b/pages/common/cradle-install.md index 811ff4fcd..bb6a06804 100644 --- a/pages/common/cradle-install.md +++ b/pages/common/cradle-install.md @@ -1,6 +1,6 @@ # cradle install -> Installs the Cradle PHP framework components. +> Install the Cradle PHP framework components. > More information: . - Install Cradle's components (User will be prompted for further details): diff --git a/pages/common/createdb.md b/pages/common/createdb.md index 79371bab9..3926e4090 100644 --- a/pages/common/createdb.md +++ b/pages/common/createdb.md @@ -9,8 +9,8 @@ - Create a database owned by a specific user with a description: -`createdb --owner={{username}} {{database_name}} '{{description}}'` +`createdb --owner {{username}} {{database_name}} '{{description}}'` - Create a database from a template: -`createdb --template={{template_name}} {{database_name}}` +`createdb --template {{template_name}} {{database_name}}` diff --git a/pages/common/crystal.md b/pages/common/crystal.md index 2ae31abff..318403eab 100644 --- a/pages/common/crystal.md +++ b/pages/common/crystal.md @@ -11,7 +11,7 @@ `crystal build {{path/to/file.cr}}` -- Read Crystal source code from the command line or `stdin`, and execute it: +- Read Crystal source code from the command-line or `stdin`, and execute it: `crystal eval '{{code}}'` diff --git a/pages/common/csslint.md b/pages/common/csslint.md index 9086f5c3c..e58f94063 100644 --- a/pages/common/csslint.md +++ b/pages/common/csslint.md @@ -1,6 +1,6 @@ # csslint -> A linter for CSS code. +> Lint CSS code. > More information: . - Lint a single CSS file: diff --git a/pages/common/csv-diff.md b/pages/common/csv-diff.md index 733957d33..02629da71 100644 --- a/pages/common/csv-diff.md +++ b/pages/common/csv-diff.md @@ -5,12 +5,12 @@ - Display a human-readable summary of differences between files using a specific column as a unique identifier: -`csv-diff {{path/to/file1.csv}} {{path/to/file2.csv}} --key={{column_name}}` +`csv-diff {{path/to/file1.csv}} {{path/to/file2.csv}} --key {{column_name}}` - Display a human-readable summary of differences between files that includes unchanged values in rows with at least one change: -`csv-diff {{path/to/file1.csv}} {{path/to/file2.csv}} --key={{column_name}} --show-unchanged` +`csv-diff {{path/to/file1.csv}} {{path/to/file2.csv}} --key {{column_name}} --show-unchanged` - Display a summary of differences between files in JSON format using a specific column as a unique identifier: -`csv-diff {{path/to/file1.csv}} {{path/to/file2.csv}} --key={{column_name}} --json` +`csv-diff {{path/to/file1.csv}} {{path/to/file2.csv}} --key {{column_name}} --json` diff --git a/pages/common/csvclean.md b/pages/common/csvclean.md index fb2839466..e48382c38 100644 --- a/pages/common/csvclean.md +++ b/pages/common/csvclean.md @@ -1,6 +1,6 @@ # csvclean -> Finds and cleans common syntax errors in CSV files. +> Find and clean common syntax errors in CSV files. > Included in csvkit. > More information: . diff --git a/pages/common/csvpy.md b/pages/common/csvpy.md index d7eca3900..1eafd1107 100644 --- a/pages/common/csvpy.md +++ b/pages/common/csvpy.md @@ -1,6 +1,6 @@ # csvpy -> Loads a CSV file into a Python shell. +> Load a CSV file into a Python shell. > Included in csvkit. > More information: . diff --git a/pages/common/csvsort.md b/pages/common/csvsort.md index 10392985a..48418438c 100644 --- a/pages/common/csvsort.md +++ b/pages/common/csvsort.md @@ -1,6 +1,6 @@ # csvsort -> Sorts CSV files. +> Sort CSV files. > Included in csvkit. > More information: . diff --git a/pages/common/ctags.md b/pages/common/ctags.md index 425816f1b..2455c21d3 100644 --- a/pages/common/ctags.md +++ b/pages/common/ctags.md @@ -1,6 +1,6 @@ # ctags -> Generates an index (or tag) file of language objects found in source files for many popular programming languages. +> Generate an index (or tag) file of language objects found in source files for many popular programming languages. > More information: . - Generate tags for a single file, and output them to a file named "tags" in the current directory, overwriting the file if it exists: diff --git a/pages/common/cut.md b/pages/common/cut.md index 95b010c09..08f58d723 100644 --- a/pages/common/cut.md +++ b/pages/common/cut.md @@ -3,14 +3,18 @@ > Cut out fields from `stdin` or files. > More information: . -- Print a specific character/field range of each line: +- Print a specific [c]haracter/[f]ield range of each line: -`{{command}} | cut --{{characters|fields}}={{1|1,10|1-10|1-|-10}}` +`{{command}} | cut --{{characters|fields}} {{1|1,10|1-10|1-|-10}}` -- Print a field range of each line with a specific delimiter: +- Print a [f]ield range of each line with a specific [d]elimiter: -`{{command}} | cut --delimiter="{{,}}" --fields={{1}}` +`{{command}} | cut --delimiter "{{,}}" --fields {{1}}` -- Print a character range of each line of the specific file: +- Print a [c]haracter range of each line of the specific file: -`cut --characters={{1}} {{path/to/file}}` +`cut --characters {{1}} {{path/to/file}}` + +- Print specific [f]ields of `NUL` terminated lines (e.g. as in `find . -print0`) instead of newlines: + +`{{command}} | cut --zero-terminated --fields {{1}}` diff --git a/pages/common/cypher-shell.md b/pages/common/cypher-shell.md new file mode 100644 index 000000000..5d5bf5ba7 --- /dev/null +++ b/pages/common/cypher-shell.md @@ -0,0 +1,33 @@ +# cypher-shell + +> Open an interactive session and run Cypher queries against a Neo4j instance. +> See also: `neo4j-admin`, `mysql`. +> More information: . + +- Connect to a local instance on the default port (`neo4j://localhost:7687`): + +`cypher-shell` + +- Connect to a remote instance: + +`cypher-shell --address neo4j://{{host}}:{{port}}` + +- Connect and supply security credentials: + +`cypher-shell --username {{username}} --password {{password}}` + +- Connect to a specific database: + +`cypher-shell --database {{database_name}}` + +- Execute Cypher statements in a file and close: + +`cypher-shell --file {{path/to/file.cypher}}` + +- Enable logging to a file: + +`cypher-shell --log {{path/to/file.log}}` + +- Display help: + +`cypher-shell --help` diff --git a/pages/common/d2.md b/pages/common/d2.md new file mode 100644 index 000000000..8fa519234 --- /dev/null +++ b/pages/common/d2.md @@ -0,0 +1,29 @@ +# d2 + +> A modern diagram scripting language that turns text to diagrams. +> Note: the output file supports SVG and PNG file formats. +> More information: . + +- Compile and render a D2 source file into an output file: + +`d2 {{path/to/input_file.d2}} {{path/to/output_file.ext}}` + +- [w]atch live changes made to a D2 source file in the default web browser: + +`d2 --watch {{path/to/input_file.d2}} {{path/to/output_file.ext}}` + +- Format a D2 source file: + +`d2 fmt {{path/to/input_file.d2}}` + +- List available themes: + +`d2 themes` + +- Use a different [t]heme for the output file (list available themes first to get the desired `theme_id`): + +`d2 --theme {{theme_id}} {{path/to/input_file.d2}} {{path/to/output_file.ext}}` + +- Make rendered diagrams look like hand [s]ketches: + +`d2 --sketch true {{path/to/input_file.d2}} {{path/to/output_file.ext}}` diff --git a/pages/common/dart.md b/pages/common/dart.md index 7d596055e..05f121442 100644 --- a/pages/common/dart.md +++ b/pages/common/dart.md @@ -26,3 +26,7 @@ - Compile a Dart file to a native binary: `dart compile exe {{path/to/file.dart}}` + +- Apply automated fixes to the current project: + +`dart fix --apply` diff --git a/pages/common/datashader_cli.md b/pages/common/datashader_cli.md index aaa204638..cbf4568f1 100644 --- a/pages/common/datashader_cli.md +++ b/pages/common/datashader_cli.md @@ -3,7 +3,7 @@ > Quick visualization of large datasets using CLI based on datashader. > More information: . -- Create a shaded scatter plot of points and save it to a png file and set the background color: +- Create a shaded scatter plot of points and save it to a PNG file and set the background color: `datashader_cli points {{path/to/input.parquet}} --x {{pickup_x}} --y {{pickup_y}} {{path/to/output.png}} --background {{black|white|#rrggbb}}` diff --git a/pages/common/date.md b/pages/common/date.md index f5f22b29b..aec1b8cdc 100644 --- a/pages/common/date.md +++ b/pages/common/date.md @@ -25,7 +25,7 @@ - Display the current date using the RFC-3339 format (`YYYY-MM-DD hh:mm:ss TZ`): -`date --rfc-3339=s` +`date --rfc-3339 s` - Set the current date using the format `MMDDhhmmYYYY.ss` (`YYYY` and `.ss` are optional): diff --git a/pages/common/dcfldd.md b/pages/common/dcfldd.md index 48520fc7e..37d1fa422 100644 --- a/pages/common/dcfldd.md +++ b/pages/common/dcfldd.md @@ -5,8 +5,8 @@ - Copy a disk to a raw image file and hash the image using SHA256: -`dcfldd if=/dev/{{disk_device}} of={{file.img}} hash=sha256 hashlog={{file.hash}}` +`dcfldd if={{/dev/disk_device}} of={{file.img}} hash=sha256 hashlog={{file.hash}}` - Copy a disk to a raw image file, hashing each 1 GB chunk: -`dcfldd if=/dev/{{disk_device}} of={{file.img}} hash={{sha512|sha384|sha256|sha1|md5}} hashlog={{file.hash}} hashwindow={{1G}}` +`dcfldd if={{/dev/disk_device}} of={{file.img}} hash={{sha512|sha384|sha256|sha1|md5}} hashlog={{file.hash}} hashwindow={{1G}}` diff --git a/pages/common/dd.md b/pages/common/dd.md index 4f92a4262..0c6b4f622 100644 --- a/pages/common/dd.md +++ b/pages/common/dd.md @@ -1,15 +1,15 @@ # dd > Convert and copy a file. -> More information: . +> More information: . -- Make a bootable USB drive from an isohybrid file (such as `archlinux-xxx.iso`): +- Make a bootable USB drive from an isohybrid file (such as `archlinux-xxx.iso`) and show the progress: -`dd if={{path/to/file.iso}} of=/dev/{{usb_drive}}` +`dd if={{path/to/file.iso}} of={{/dev/usb_drive}} status=progress` - Clone a drive to another drive with 4 MiB block size and flush writes before the command terminates: -`dd bs={{4194304}} conv={{fsync}} if=/dev/{{source_drive}} of=/dev/{{dest_drive}}` +`dd bs=4194304 conv=fsync if={{/dev/source_drive}} of={{/dev/dest_drive}}` - Generate a file with a specific number of random bytes by using kernel random driver: @@ -19,6 +19,6 @@ `dd bs={{1024}} count={{1000000}} if=/dev/zero of={{path/to/file_1GB}}` -- Create a system backup and save it into an IMG file (can be restored later by swapping `if` and `of`): +- Create a system backup, save it into an IMG file (can be restored later by swapping `if` and `of`), and show the progress: -`dd if={{/dev/drive_device}} of={{path/to/file.img}}` +`dd if={{/dev/drive_device}} of={{path/to/file.img}} status=progress` diff --git a/pages/common/deemix.md b/pages/common/deemix.md index 85015771b..38a911125 100644 --- a/pages/common/deemix.md +++ b/pages/common/deemix.md @@ -2,7 +2,7 @@ > A barebone deezer downloader library built from the ashes of Deezloader Remix. > It can be used as a standalone CLI app or implemented in a UI using the API. -> More information: . +> More information: . - Download a track or playlist: diff --git a/pages/common/dep.md b/pages/common/dep.md index c83fc38da..d4df17396 100644 --- a/pages/common/dep.md +++ b/pages/common/dep.md @@ -16,7 +16,7 @@ `dep rollback` -- Connect to a remote host via ssh: +- Connect to a remote host via SSH: `dep ssh {{hostname}}` diff --git a/pages/common/devenv.md b/pages/common/devenv.md new file mode 100644 index 000000000..b77deec02 --- /dev/null +++ b/pages/common/devenv.md @@ -0,0 +1,28 @@ +# devenv + +> Fast, Declarative, Reproducible and Composable Developer Environments using Nix. +> More information: . + +- Initialise the environment: + +`devenv init` + +- Enter the Development Environment with relaxed hermeticity (state of being airtight): + +`devenv shell --impure` + +- Get detailed information about the current environment: + +`devenv info --verbose` + +- Start processes with `devenv`: + +`devenv up --config /{{file}}/{{path}}/` + +- Clean the environment variables and re-enter the shell in offline mode: + +`devenv --clean --offline` + +- Delete the previous shell generations: + +`devenv gc` diff --git a/pages/common/dfc.md b/pages/common/dfc.md index 4b7e63356..08ffcfbf7 100644 --- a/pages/common/dfc.md +++ b/pages/common/dfc.md @@ -1,6 +1,6 @@ # dfc -> Gives an overview of the filesystem disk space usage with colors and graphs. +> Get an overview of the filesystem disk space usage with colors and graphs. > More information: . - Display filesystems and their disk usage in human-readable form with colors and graphs: diff --git a/pages/common/diff.md b/pages/common/diff.md index 57d84d6f9..8315c8866 100644 --- a/pages/common/diff.md +++ b/pages/common/diff.md @@ -1,7 +1,7 @@ # diff > Compare files and directories. -> More information: . +> More information: . - Compare files (lists changes to turn `old_file` into `new_file`): @@ -9,24 +9,28 @@ - Compare files, ignoring white spaces: -`diff --ignore-all-space {{old_file}} {{new_file}}` +`diff {{-w|--ignore-all-space}} {{old_file}} {{new_file}}` - Compare files, showing the differences side by side: -`diff --side-by-side {{old_file}} {{new_file}}` +`diff {{-y|--side-by-side}} {{old_file}} {{new_file}}` - Compare files, showing the differences in unified format (as used by `git diff`): -`diff --unified {{old_file}} {{new_file}}` +`diff {{-u|--unified}} {{old_file}} {{new_file}}` - Compare directories recursively (shows names for differing files/directories as well as changes made to files): -`diff --recursive {{old_directory}} {{new_directory}}` +`diff {{-r|--recursive}} {{old_directory}} {{new_directory}}` - Compare directories, only showing the names of files that differ: -`diff --recursive --brief {{old_directory}} {{new_directory}}` +`diff {{-r|--recursive}} {{-q|--brief}} {{old_directory}} {{new_directory}}` - Create a patch file for Git from the differences of two text files, treating nonexistent files as empty: -`diff --text --unified --new-file {{old_file}} {{new_file}} > {{diff.patch}}` +`diff {{-a|--text}} {{-u|--unified}} {{-N|--new-file}} {{old_file}} {{new_file}} > {{diff.patch}}` + +- Compare files, showing output in color and try hard to find smaller set of changes: + +`diff {{-d|--minimal}} --color=always {{old_file}} {{new_file}}` diff --git a/pages/common/difft.md b/pages/common/difft.md new file mode 100644 index 000000000..968467f34 --- /dev/null +++ b/pages/common/difft.md @@ -0,0 +1,33 @@ +# difft + +> Compare files or directories based on the syntax of the programming language. +> See also: `delta`, `diff`. +> More information: . + +- Compare two files or directories: + +`difft {{path/to/file_or_directory1}} {{path/to/file_or_directory2}}` + +- Only report the presence of differences between the files: + +`difft --check-only {{path/to/file1}} {{path/to/file2}}` + +- Specify the display mode (default is `side-by-side`): + +`difft --display {{side-by-side|side-by-side-show-both|inline|json}} {{path/to/file1}} {{path/to/file2}}` + +- Ignore comments when comparing: + +`difft --ignore-comments {{path/to/file1}} {{path/to/file2}}` + +- Enable/Disable syntax highlighting of source code (default is `on`): + +`difft --syntax-highlight {{on|off}} {{path/to/file1}} {{path/to/file2}}` + +- Do not output anything at all if there are no differences between files: + +`difft --skip-unchanged {{path/to/file_or_directory1}} {{path/to/file_or_directory2}}` + +- Print all programming languages supported by the tool, along with their extensions: + +`difft --list-languages` diff --git a/pages/common/dig.md b/pages/common/dig.md index 301f8dee7..572089c5c 100644 --- a/pages/common/dig.md +++ b/pages/common/dig.md @@ -15,9 +15,9 @@ `dig +short {{example.com}} {{A|MX|TXT|CNAME|NS}}` -- Specify an alternate DNS server to query: +- Specify an alternate DNS server to query and optionally use DNS over TLS (DoT): -`dig @{{8.8.8.8}} {{example.com}}` +`dig {{+tls}} @{{1.1.1.1|8.8.8.8|9.9.9.9|...}} {{example.com}}` - Perform a reverse DNS lookup on an IP address (PTR record): diff --git a/pages/common/dirs.md b/pages/common/dirs.md index dc90cbd11..335869640 100644 --- a/pages/common/dirs.md +++ b/pages/common/dirs.md @@ -1,6 +1,6 @@ # dirs -> Displays or manipulates the directory stack. +> Display or manipulate the directory stack. > The directory stack is a list of recently visited directories that can be manipulated with the `pushd` and `popd` commands. > More information: . diff --git a/pages/common/dnsx.md b/pages/common/dnsx.md new file mode 100644 index 000000000..ef2b6b74a --- /dev/null +++ b/pages/common/dnsx.md @@ -0,0 +1,38 @@ +# dnsx + +> A fast and multi-purpose DNS toolkit to run multiple DNS queries. +> Note: input to `dnsx` needs to be passed through `stdin` (pipe `|`) in some cases. +> See also: `dig`, `dog`, `dnstracer`. +> More information: . + +- Query the A record of a (sub)domain and show [re]sponse received: + +`echo {{example.com}} | dnsx -a -re` + +- Query all the DNS records (A, AAAA, CNAME, NS, TXT, SRV, PTR, MX, SOA, AXFR, CAA): + +`dnsx -recon -re <<< {{example.com}}` + +- Query a specific type of DNS record: + +`echo {{example.com}} | dnsx -re -{{a|aaaa|cname|ns|txt|srv|ptr|mx|soa|any|axfr|caa}}` + +- Output [r]esponse [o]nly (do not show the queried domain or subdomain): + +`echo {{example.com}} | dnsx -ro` + +- Display raw response of a query, specifying [r]esolvers to use and retry attempts for failures: + +`echo {{example.com}} | dnsx -{{debug|raw}} -resolver {{1.1.1.1,8.8.8.8,...}} -retry {{number}}` + +- Brute force DNS records using a placeholder: + +`dnsx -domain {{FUZZ.example.com}} -wordlist {{path/to/wordlist.txt}} -re` + +- Brute force DNS records from a list of [d]omains and wordlists, appending [o]utput to a file with [n]o [c]olor codes: + +`dnsx -domain {{path/to/domain.txt}} -wordlist {{path/to/wordlist.txt}} -re -output {{path/to/output.txt}} -no-color` + +- Extract `CNAME` records for the given list of subdomains, with [r]ate [l]imiting DNS queries per second: + +`subfinder -silent -d {{example.com}} | dnsx -cname -re -rl {{number}}` diff --git a/pages/common/docker-build.md b/pages/common/docker-build.md index d8a7aad9e..fd4f480cd 100644 --- a/pages/common/docker-build.md +++ b/pages/common/docker-build.md @@ -3,19 +3,19 @@ > Build an image from a Dockerfile. > More information: . -- Build a docker image using the Dockerfile in the current directory: +- Build a Docker image using the Dockerfile in the current directory: `docker build .` -- Build a docker image from a Dockerfile at a specified URL: +- Build a Docker image from a Dockerfile at a specified URL: `docker build {{github.com/creack/docker-firefox}}` -- Build a docker image and tag it: +- Build a Docker image and tag it: `docker build --tag {{name:tag}} .` -- Build a docker image with no build context: +- Build a Docker image with no build context: `docker build --tag {{name:tag}} - < {{Dockerfile}}` @@ -23,7 +23,7 @@ `docker build --no-cache --tag {{name:tag}} .` -- Build a docker image using a specific Dockerfile: +- Build a Docker image using a specific Dockerfile: `docker build --file {{Dockerfile}} .` diff --git a/pages/common/docker-commit.md b/pages/common/docker-commit.md index df58346f2..9b02a9544 100644 --- a/pages/common/docker-commit.md +++ b/pages/common/docker-commit.md @@ -9,23 +9,23 @@ - Apply a `CMD` Dockerfile instruction to the created image: -`docker commit --change="CMD {{command}}" {{container}} {{image}}:{{tag}}` +`docker commit --change "CMD {{command}}" {{container}} {{image}}:{{tag}}` - Apply an `ENV` Dockerfile instruction to the created image: -`docker commit --change="ENV {{name}}={{value}}" {{container}} {{image}}:{{tag}}` +`docker commit --change "ENV {{name}}={{value}}" {{container}} {{image}}:{{tag}}` - Create an image with a specific author in the metadata: -`docker commit --author="{{author}}" {{container}} {{image}}:{{tag}}` +`docker commit --author "{{author}}" {{container}} {{image}}:{{tag}}` - Create an image with a specific comment in the metadata: -`docker commit --message="{{comment}}" {{container}} {{image}}:{{tag}}` +`docker commit --message "{{comment}}" {{container}} {{image}}:{{tag}}` - Create an image without pausing the container during commit: -`docker commit --pause={{false}} {{container}} {{image}}:{{tag}}` +`docker commit --pause {{false}} {{container}} {{image}}:{{tag}}` - Display help: diff --git a/pages/common/docker-compose.md b/pages/common/docker-compose.md index b82f73def..749f28235 100644 --- a/pages/common/docker-compose.md +++ b/pages/common/docker-compose.md @@ -1,6 +1,6 @@ # docker compose -> Run and manage multi container docker applications. +> Run and manage multi container Docker applications. > More information: . - List all running containers: diff --git a/pages/common/docker-container.md b/pages/common/docker-container.md index f88f95235..4c5bedc26 100644 --- a/pages/common/docker-container.md +++ b/pages/common/docker-container.md @@ -27,7 +27,7 @@ `docker container inspect {{container_name}}` -- Export a container's filesystem as a `tar` archive: +- Export a container's filesystem as a tar archive: `docker container export {{container_name}}` diff --git a/pages/common/docker-login.md b/pages/common/docker-login.md index 3e368fbd8..ff9b06a19 100644 --- a/pages/common/docker-login.md +++ b/pages/common/docker-login.md @@ -1,6 +1,6 @@ # docker login -> Log into a docker registry. +> Log into a Docker registry. > More information: . - Interactively log into a registry: diff --git a/pages/common/docker-machine.md b/pages/common/docker-machine.md index c7bd20f83..4d75974f9 100644 --- a/pages/common/docker-machine.md +++ b/pages/common/docker-machine.md @@ -1,13 +1,13 @@ # docker-machine > Create and manage machines running Docker. -> More information: . +> More information: . -- List currently running docker machines: +- List currently running Docker machines: `docker-machine ls` -- Create a new docker machine with specific name: +- Create a new Docker machine with specific name: `docker-machine create {{name}}` diff --git a/pages/common/docker-network.md b/pages/common/docker-network.md index 2ea97963c..0f9772cb8 100644 --- a/pages/common/docker-network.md +++ b/pages/common/docker-network.md @@ -1,9 +1,9 @@ # docker network -> Create and manage docker networks. +> Create and manage Docker networks. > More information: . -- List all available and configured networks on docker daemon: +- List all available and configured networks on Docker daemon: `docker network ls` diff --git a/pages/common/docker-ps.md b/pages/common/docker-ps.md index 9e629e1f9..438a82b99 100644 --- a/pages/common/docker-ps.md +++ b/pages/common/docker-ps.md @@ -3,11 +3,11 @@ > List Docker containers. > More information: . -- List currently running docker containers: +- List currently running Docker containers: `docker ps` -- List all docker containers (running and stopped): +- List all Docker containers (running and stopped): `docker ps --all` @@ -17,7 +17,7 @@ - Filter containers that contain a substring in their name: -`docker ps --filter="name={{name}}"` +`docker ps --filter "name={{name}}"` - Filter containers that share a given image as an ancestor: @@ -29,8 +29,8 @@ - Filter containers by status (created, running, removing, paused, exited and dead): -`docker ps --filter="status={{status}}"` +`docker ps --filter "status={{status}}"` - Filter containers that mount a specific volume or have a volume mounted in a specific path: -`docker ps --filter="volume={{path/to/directory}}" --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Mounts}}"` +`docker ps --filter "volume={{path/to/directory}}" --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Mounts}}"` diff --git a/pages/common/docker-save.md b/pages/common/docker-save.md index d7865713f..645146755 100644 --- a/pages/common/docker-save.md +++ b/pages/common/docker-save.md @@ -3,11 +3,11 @@ > Export Docker images to archive. > More information: . -- Save an image by redirecting `stdout` to a `tar` archive: +- Save an image by redirecting `stdout` to a tar archive: `docker save {{image}}:{{tag}} > {{path/to/file.tar}}` -- Save an image to a `tar` archive: +- Save an image to a tar archive: `docker save --output {{path/to/file.tar}} {{image}}:{{tag}}` diff --git a/pages/common/docker-service.md b/pages/common/docker-service.md index 05ced4e00..ea86ea9a7 100644 --- a/pages/common/docker-service.md +++ b/pages/common/docker-service.md @@ -1,9 +1,9 @@ # docker service -> Manage the services on a docker daemon. +> Manage the services on a Docker daemon. > More information: . -- List the services on a docker daemon: +- List the services on a Docker daemon: `docker service ls` diff --git a/pages/common/docker-start.md b/pages/common/docker-start.md index 8d8145b2d..4518c70a4 100644 --- a/pages/common/docker-start.md +++ b/pages/common/docker-start.md @@ -7,7 +7,7 @@ `docker start` -- Start a docker container: +- Start a Docker container: `docker start {{container}}` diff --git a/pages/common/docker-system.md b/pages/common/docker-system.md index 97a435291..512da533f 100644 --- a/pages/common/docker-system.md +++ b/pages/common/docker-system.md @@ -7,7 +7,7 @@ `docker system` -- Show docker disk usage: +- Show Docker disk usage: `docker system df` @@ -21,7 +21,7 @@ - Remove unused data created more than a specified amount of time in the past: -`docker system prune --filter="until={{hours}}h{{minutes}}m"` +`docker system prune --filter "until={{hours}}h{{minutes}}m"` - Display real-time events from the Docker daemon: diff --git a/pages/common/docker.md b/pages/common/docker.md index 66cd595ce..8ed706d77 100644 --- a/pages/common/docker.md +++ b/pages/common/docker.md @@ -4,7 +4,7 @@ > Some subcommands such as `docker run` have their own usage documentation. > More information: . -- List all docker containers (running and stopped): +- List all Docker containers (running and stopped): `docker ps --all` @@ -16,7 +16,7 @@ `docker {{start|stop}} {{container_name}}` -- Pull an image from a docker registry: +- Pull an image from a Docker registry: `docker pull {{image}}` @@ -24,7 +24,7 @@ `docker images` -- Open a shell inside a running container: +- Open an [i]nteractive [t]ty with Bourne shell (`sh`) inside a running container: `docker exec -it {{container_name}} {{sh}}` diff --git a/pages/common/doctl-kubernetes-options.md b/pages/common/doctl-kubernetes-options.md index 3dadefac9..d4900a405 100644 --- a/pages/common/doctl-kubernetes-options.md +++ b/pages/common/doctl-kubernetes-options.md @@ -1,6 +1,6 @@ # doctl kubernetes options -> Provides values available for use with doctl's Kubernetes commands. +> Get values available for use with `doctl`'s Kubernetes commands. > More information: . - List regions that support Kubernetes clusters: diff --git a/pages/common/doctum.md b/pages/common/doctum.md index 541b40271..7afd9862e 100644 --- a/pages/common/doctum.md +++ b/pages/common/doctum.md @@ -1,6 +1,6 @@ # doctum -> A PHP API documentation generator. +> Generate documentation for a PHP API. > More information: . - Parse a project: diff --git a/pages/common/dolt-blame.md b/pages/common/dolt-blame.md index be8b6e8bb..2185c4277 100644 --- a/pages/common/dolt-blame.md +++ b/pages/common/dolt-blame.md @@ -1,6 +1,6 @@ # dolt blame -> Displays commit information for each row of a Dolt table. +> Display commit information for each row of a Dolt table. > More information: . - Display the latest commit for each row of a table: diff --git a/pages/common/dolt-version.md b/pages/common/dolt-version.md index 553689247..a7df647a0 100644 --- a/pages/common/dolt-version.md +++ b/pages/common/dolt-version.md @@ -1,6 +1,6 @@ # dolt version -> Displays the current dolt CLI version. +> Display the current dolt CLI version. > More information: . - Display version: diff --git a/pages/common/dot.md b/pages/common/dot.md index 179ae9a99..c914ae1d2 100644 --- a/pages/common/dot.md +++ b/pages/common/dot.md @@ -4,19 +4,19 @@ > Layouts: `dot`, `neato`, `twopi`, `circo`, `fdp`, `sfdp`, `osage` & `patchwork`. > More information: . -- Render a `png` image with a filename based on the input filename and output format (uppercase -O): +- Render a PNG image with a filename based on the input filename and output format (uppercase -O): `dot -T {{png}} -O {{path/to/input.gv}}` -- Render a `svg` image with the specified output filename (lowercase -o): +- Render a SVG image with the specified output filename (lowercase -o): `dot -T {{svg}} -o {{path/to/image.svg}} {{path/to/input.gv}}` -- Render the output in `ps`, `pdf`, `svg`, `fig`, `png`, `gif`, `jpg`, `json`, or `dot` format: +- Render the output in PS, PDF, SVG, Fig, PNG, GIF, JPEG, JSON, or DOT format: `dot -T {{format}} -O {{path/to/input.gv}}` -- Render a `gif` image using `stdin` and `stdout`: +- Render a GIF image using `stdin` and `stdout`: `echo "{{digraph {this -> that} }}" | dot -T {{gif}} > {{path/to/image.gif}}` diff --git a/pages/common/dotnet-add-reference.md b/pages/common/dotnet-add-reference.md index d4c231218..2f64f023d 100644 --- a/pages/common/dotnet-add-reference.md +++ b/pages/common/dotnet-add-reference.md @@ -7,6 +7,14 @@ `dotnet add reference {{path/to/reference.csproj}}` +- Add multiple references to the project in the current directory: + +`dotnet add reference {{path/to/reference1.csproj path/to/reference2.csproj ...}}` + - Add a reference to the specific project: `dotnet add {{path/to/project.csproj}} reference {{path/to/reference.csproj}}` + +- Add multiple references to the specific project: + +`dotnet add {{path/to/project.csproj}} reference {{path/to/reference1.csproj path/to/reference2.csproj ...}}` diff --git a/pages/common/dotnet-test.md b/pages/common/dotnet-test.md new file mode 100644 index 000000000..21aa4e375 --- /dev/null +++ b/pages/common/dotnet-test.md @@ -0,0 +1,17 @@ +# dotnet test + +> Execute tests for a .NET application. +> Note: View for supported filter expressions. +> More information: . + +- Execute tests for a .NET project/solution in the current directory: + +`dotnet test` + +- Execute tests for a .NET project/solution in a specific location: + +`dotnet test {{path/to/project_or_solution}}` + +- Execute tests matching the given filter expression: + +`dotnet test --filter {{Name~TestMethod1}}` diff --git a/pages/common/du.md b/pages/common/du.md index 6e0a5279c..1061c806f 100644 --- a/pages/common/du.md +++ b/pages/common/du.md @@ -26,3 +26,7 @@ - List the human-readable size of all `.jpg` files in subdirectories of the current directory, and show a cumulative total at the end: `du -ch {{*/*.jpg}}` + +- List all files and directories (including hidden ones) above a certain [t]hreshold size (useful for investigating what is actually taking up the space): + +`du --all --human-readable --threshold {{1G|1024M|1048576K}} .[^.]* *` diff --git a/pages/common/duplicity.md b/pages/common/duplicity.md index e69bdbf05..7bc6cf3a4 100644 --- a/pages/common/duplicity.md +++ b/pages/common/duplicity.md @@ -1,7 +1,8 @@ # duplicity -> Creates incremental, compressed, encrypted and versioned backups. +> Create incremental, compressed, encrypted and versioned backups. > Can also upload the backups to a variety of backend services. +> It is worth mentioning that depending on the version, some options may not be available (e.g. `--gio` in 2.0.0). > More information: . - Backup a directory via FTPS to a remote machine, encrypting it with a password: @@ -20,7 +21,7 @@ `duplicity collection-status "file://{{absolute/path/to/backup/directory}}"` -- List the files in a backup stored on a remote machine, via ssh: +- List the files in a backup stored on a remote machine, via SSH: `duplicity list-current-files --time {{YYYY-MM-DD}} scp://{{user@hostname}}/{{path/to/backup/dir}}` diff --git a/pages/common/dwebp.md b/pages/common/dwebp.md index da29a9455..0dd933028 100644 --- a/pages/common/dwebp.md +++ b/pages/common/dwebp.md @@ -4,26 +4,26 @@ > Animated WebP files are not supported. > More information: . -- Convert a `webp` file into a `png` file: +- Convert a WebP file into a PNG file: `dwebp {{path/to/input.webp}} -o {{path/to/output.png}}` -- Convert a `webp` file into a specific filetype: +- Convert a WebP file into a specific filetype: `dwebp {{path/to/input.webp}} -bmp|-tiff|-pam|-ppm|-pgm|-yuv -o {{path/to/output}}` -- Convert a `webp` file, using multi-threading if possible: +- Convert a WebP file, using multi-threading if possible: `dwebp {{path/to/input.webp}} -o {{path/to/output.png}} -mt` -- Convert a `webp` file, but also crop and scale at the same time: +- Convert a WebP file, but also crop and scale at the same time: `dwebp {{input.webp}} -o {{output.png}} -crop {{x_pos}} {{y_pos}} {{width}} {{height}} -scale {{width}} {{height}}` -- Convert a `webp` file and flip the output: +- Convert a WebP file and flip the output: `dwebp {{path/to/input.webp}} -o {{path/to/output.png}} -flip` -- Convert a `webp` file and don't use in-loop filtering to speed up the decoding process: +- Convert a WebP file and don't use in-loop filtering to speed up the decoding process: `dwebp {{path/to/input.webp}} -o {{path/to/output.png}} -nofilter` diff --git a/pages/common/ect.md b/pages/common/ect.md index 07dc393cc..57c1c1103 100644 --- a/pages/common/ect.md +++ b/pages/common/ect.md @@ -1,7 +1,7 @@ # ect > Efficient Compression Tool. -> File optimizer written in C++. It supports `.png`, `.jpg`, `.gzip` and `.zip` files. +> File optimizer written in C++. It supports PNG, JPEG, gzip and Zip files. > More information: . - Compress a file: diff --git a/pages/common/encfs.md b/pages/common/encfs.md index 857f4ad2e..fd8a9f40f 100644 --- a/pages/common/encfs.md +++ b/pages/common/encfs.md @@ -1,6 +1,6 @@ # encfs -> Mounts or creates encrypted virtual filesystems. +> Mount or create encrypted virtual filesystems. > See also `fusermount`, which can unmount filesystems mounted by this command. > More information: . diff --git a/pages/common/expand.md b/pages/common/expand.md index 7fe100a39..2397846e5 100644 --- a/pages/common/expand.md +++ b/pages/common/expand.md @@ -17,8 +17,8 @@ - Have tabs a certain number of characters apart, not 8: -`expand -t={{number}} {{path/to/file}}` +`expand -t {{number}} {{path/to/file}}` - Use a comma separated list of explicit tab positions: -`expand -t={{1,4,6}}` +`expand -t {{1,4,6}}` diff --git a/pages/common/factor.md b/pages/common/factor.md index f63855cc9..f68eac41d 100644 --- a/pages/common/factor.md +++ b/pages/common/factor.md @@ -1,6 +1,6 @@ # factor -> Prints the prime factorization of a number. +> Print the prime factorization of a number. > More information: . - Display the prime-factorization of a number: diff --git a/pages/common/fastfetch.md b/pages/common/fastfetch.md index f991fab84..2e9f419c6 100644 --- a/pages/common/fastfetch.md +++ b/pages/common/fastfetch.md @@ -7,6 +7,10 @@ `fastfetch` +- Display system information without a logo and escape sequences: + +`fastfetch --pipe` + - Fetch a specific structure: `fastfetch --structure {{structure}}` diff --git a/pages/common/fastmod.md b/pages/common/fastmod.md index 219a9ce92..dbf664ce8 100644 --- a/pages/common/fastmod.md +++ b/pages/common/fastmod.md @@ -16,7 +16,7 @@ `fastmod {{regex}} {{replacement}} --dir {{path/to/directory}} --iglob {{'**/*.{js,json}'}}` -- Replace for an exact string in .js or .json files: +- Replace for an exact string in `.js` or JSON files: `fastmod --fixed-strings {{exact_string}} {{replacement}} --extensions {{json,js}}` diff --git a/pages/common/fclones.md b/pages/common/fclones.md new file mode 100644 index 000000000..93e3cb9b3 --- /dev/null +++ b/pages/common/fclones.md @@ -0,0 +1,32 @@ +# fclones + +> Efficient duplicate file finder and remover. +> More information: . + +- Search for duplicate files in the current directory: + +`fclones group .` + +- Search multiple directories for duplicate files and cache the results: + +`fclones group --cache {{path/to/directory1 path/to/directory2}}` + +- Search only the specified directory for duplicate files, skipping subdirectories and save the results into a file: + +`fclones group {{path/to/directory}} --depth 1 > {{path/to/file.txt}}` + +- Move the duplicate files in a TXT file to a different directory: + +`fclones move {{path/to/target_directory}} < {{path/to/file.txt}}` + +- Perform a dry run for soft links in a TXT file without actually linking: + +`fclones link --soft < {{path/to/file.txt}} --dry-run 2 > /dev/null` + +- Delete the newest duplicates from the current directory without storing them in a file: + +`fclones group . | fclones remove --priority newest` + +- Preprocess JPEG files in the current directory by using an external command to strip their EXIF data before matching for duplicates: + +`fclones group . --name '*.jpg' -i --transform 'exiv2 -d a $IN' --in-place` diff --git a/pages/common/fdp.md b/pages/common/fdp.md index 970e326d0..9330636f7 100644 --- a/pages/common/fdp.md +++ b/pages/common/fdp.md @@ -4,11 +4,11 @@ > Layouts: `dot`, `neato`, `twopi`, `circo`, `fdp`, `sfdp`, `osage` & `patchwork`. > More information: . -- Render a `png` image with a filename based on the input filename and output format (uppercase -O): +- Render a PNG image with a filename based on the input filename and output format (uppercase -O): `fdp -T png -O {{path/to/input.gv}}` -- Render a `svg` image with the specified output filename (lowercase -o): +- Render a SVG image with the specified output filename (lowercase -o): `fdp -T svg -o {{path/to/image.svg}} {{path/to/input.gv}}` diff --git a/pages/common/ffmpeg.md b/pages/common/ffmpeg.md index f8d6ede14..9335be752 100644 --- a/pages/common/ffmpeg.md +++ b/pages/common/ffmpeg.md @@ -7,6 +7,10 @@ `ffmpeg -i {{path/to/video.mp4}} -vn {{path/to/sound.mp3}}` +- Transcode a FLAC file to Red Book CD format (44100kHz, 16bit): + +`ffmpeg -i {{path/to/input_audio.flac}} -ar 44100 -sample_fmt s16 {{path/to/output_audio.wav}}` + - Save a video as GIF, scaling the height to 1000px and setting framerate to 15: `ffmpeg -i {{path/to/video.mp4}} -vf 'scale=-1:{{1000}}' -r {{15}} {{path/to/output.gif}}` @@ -15,13 +19,9 @@ `ffmpeg -i {{path/to/frame_%d.jpg}} -f image2 {{video.mpg|video.gif}}` -- Quickly extract a single frame from a video at time mm:ss and save it as a 128x128 resolution image: - -`ffmpeg -ss {{mm:ss}} -i {{path/to/video.mp4}} -frames 1 -s {{128x128}} -f image2 {{path/to/image.png}}` - - Trim a video from a given start time mm:ss to an end time mm2:ss2 (omit the -to flag to trim till the end): -`ffmpeg -ss {{mm:ss}} -to {{mm2:ss2}} -i {{path/to/video.mp4}} -codec copy {{path/to/output.mp4}}` +`ffmpeg -ss {{mm:ss}} -to {{mm2:ss2}} -i {{path/to/input_video.mp4}} -codec copy {{path/to/output_video.mp4}}` - Convert AVI video to MP4. AAC Audio @ 128kbit, h264 Video @ CRF 23: diff --git a/pages/common/ffuf.md b/pages/common/ffuf.md index cc6f536f9..cd820fe74 100644 --- a/pages/common/ffuf.md +++ b/pages/common/ffuf.md @@ -8,7 +8,7 @@ `ffuf -c -w {{path/to/wordlist.txt}} -u {{http://target/FUZZ}}` -- Enumerate subdomains by changing the position of the keyword: +- Enumerate webservers of subdomains by changing the position of the keyword: `ffuf -w {{path/to/subdomains.txt}} -u {{http://FUZZ.target.com}}` @@ -23,3 +23,11 @@ - Fuzz with specified HTTP method and [d]ata, while [f]iltering out comma separated status [c]odes: `ffuf -w {{path/to/postdata.txt}} -X {{POST}} -d "{{username=admin\&password=FUZZ}}" -u {{http://target/login.php}} -fc {{401,403}}` + +- Fuzz multiple positions with multiple wordlists using different modes: + +`ffuf -w {{path/to/keys:KEY}} -w {{path/to/values:VALUE}} -mode {{pitchfork|clusterbomb}} -u {{http://target.com/id?KEY=VALUE}}` + +- Proxy requests through a HTTP MITM pro[x]y (such as Burp Suite or `mitmproxy`): + +`ffuf -w {{path/to/wordlist}} -x {{http://127.0.0.1:8080}} -u {{http://target.com/FUZZ}}` diff --git a/pages/common/figlet.md b/pages/common/figlet.md index bb9d3ad38..306ee79bb 100644 --- a/pages/common/figlet.md +++ b/pages/common/figlet.md @@ -8,11 +8,11 @@ `figlet {{input_text}}` -- Use a custom font file: +- Use a custom [f]ont file: `figlet {{input_text}} -f {{path/to/font_file.flf}}` -- Use a font from the default font directory (the extension can be omitted): +- Use a [f]ont from the default font directory (the extension can be omitted): `figlet {{input_text}} -f {{font_filename}}` @@ -23,3 +23,11 @@ - Show available FIGlet fonts: `showfigfonts {{optional_string_to_display}}` + +- Use the full width of the [t]erminal and [c]enter the input text: + +`figlet -t -c {{input_text}}` + +- Display all characters at full [W]idth to avoid overlapping: + +`figlet -W {{input_text}}` diff --git a/pages/common/from.md b/pages/common/from.md index 95c25d6fc..4212eaa87 100644 --- a/pages/common/from.md +++ b/pages/common/from.md @@ -1,6 +1,6 @@ # from -> Prints mail header lines from the current user's mailbox. +> Print mail header lines from the current user's mailbox. > More information: . - List mail: diff --git a/pages/common/frp.md b/pages/common/frp.md new file mode 100644 index 000000000..8d721293a --- /dev/null +++ b/pages/common/frp.md @@ -0,0 +1,12 @@ +# frp + +> Fast Reverse Proxy: quickly set up network tunnels to expose certain services to the Internet or other external networks. +> More information: . + +- View documentation for `frpc`, the `frp` client component: + +`tldr frpc` + +- View documentation for `frps`, the `frp` server component: + +`tldr frps` diff --git a/pages/common/frpc.md b/pages/common/frpc.md new file mode 100644 index 000000000..afbe78af1 --- /dev/null +++ b/pages/common/frpc.md @@ -0,0 +1,29 @@ +# frpc + +> Connect to a `frps` server to start proxying connections on the current host. +> Part of `frp`. +> More information: . + +- Start the service, using the default configuration file (assumed to be `frps.ini` in the current directory): + +`frpc` + +- Start the service, using the newer TOML configuration file (`frps.toml` instead of `frps.ini`) in the current directory: + +`frpc {{-c|--config}} ./frps.toml` + +- Start the service, using a specific configuration file: + +`frpc {{-c|--config}} {{path/to/file}}` + +- Check if the configuration file is valid: + +`frpc verify {{-c|--config}} {{path/to/file}}` + +- Print autocompletion setup script for Bash, fish, PowerShell, or Zsh: + +`frpc completion {{bash|fish|powershell|zsh}}` + +- Display version: + +`frpc {{-v|--version}}` diff --git a/pages/common/frps.md b/pages/common/frps.md new file mode 100644 index 000000000..6995fc502 --- /dev/null +++ b/pages/common/frps.md @@ -0,0 +1,29 @@ +# frps + +> Quickly set up a reverse proxy service. +> Part of `frp`. +> More information: . + +- Start the service, using the default configuration file (assumed to be `frps.ini` in the current directory): + +`frps` + +- Start the service, using the newer TOML configuration file (`frps.toml` instead of `frps.ini`) in the current directory: + +`frps {{-c|--config}} ./frps.toml` + +- Start the service, using a specified config file: + +`frps {{-c|--config}} {{path/to/file}}` + +- Check if the configuration file is valid: + +`frps verify {{-c|--config}} {{path/to/file}}` + +- Print autocompletion setup script for Bash, fish, PowerShell, or Zsh: + +`frps completion {{bash|fish|powershell|zsh}}` + +- Display version: + +`frps {{-v|--version}}` diff --git a/pages/common/funzip.md b/pages/common/funzip.md index 27e62b0e6..e73e3be4d 100644 --- a/pages/common/funzip.md +++ b/pages/common/funzip.md @@ -3,14 +3,14 @@ > Print the content of the first (non-directory) member in an archive without extraction. > More information: . -- Print the content of the first member in a `.zip` archive: +- Print the content of the first member in a Zip archive: `funzip {{path/to/archive.zip}}` -- Print the content in a `.gz` archive: +- Print the content in a gzip archive: `funzip {{path/to/archive.gz}}` -- Decrypt a `.zip` or `.gz` archive and print the content: +- Decrypt a Zip or gzip archive and print the content: `funzip -password {{password}} {{path/to/archive}}` diff --git a/pages/common/gau.md b/pages/common/gau.md new file mode 100644 index 000000000..f284f39e5 --- /dev/null +++ b/pages/common/gau.md @@ -0,0 +1,32 @@ +# gau + +> Get All URLs: fetch known URLs from AlienVault's Open Threat Exchange, the Wayback Machine, and Common Crawl for any domains. +> More information: . + +- Fetch all URLs of a domain from AlienVault's Open Threat Exchange, the Wayback Machine, Common Crawl, and URLScan: + +`gau {{example.com}}` + +- Fetch URLs of multiple domains: + +`gau {{domain1 domain2 ...}}` + +- Fetch all URLs of several domains from an input file, running multiple threads: + +`gau --threads {{4}} < {{path/to/domains.txt}}` + +- Write [o]utput results to a file: + +`gau {{example.com}} --o {{path/to/found_urls.txt}}` + +- Search for URLs from only one specific provider: + +`gau --providers {{wayback|commoncrawl|otx|urlscan}} {{example.com}}` + +- Search for URLs from multiple providers: + +`gau --providers {{wayback,otx,...}} {{example.com}}` + +- Search for URLs within specific date range: + +`gau --from {{YYYYMM}} --to {{YYYYMM}} {{example.com}}` diff --git a/pages/common/gcal.md b/pages/common/gcal.md index 26ab674c9..18fa357ad 100644 --- a/pages/common/gcal.md +++ b/pages/common/gcal.md @@ -1,6 +1,6 @@ # gcal -> Displays calendar. +> Display calendar. > More information: . - Display calendar for the current month: @@ -9,7 +9,7 @@ - Display calendar for the month of February of the year 2010: -`gcal {{2}} {{2010}}` +`gcal 2 2010` - Provide calendar sheet with week numbers: @@ -17,7 +17,7 @@ - Change starting day of week to 1st day of the week (Monday): -`gcal --starting-day={{1}}` +`gcal --starting-day=1` - Display the previous, current and next month surrounding today: diff --git a/pages/common/gcloud-info.md b/pages/common/gcloud-info.md index 90779a7e3..b50c642e2 100644 --- a/pages/common/gcloud-info.md +++ b/pages/common/gcloud-info.md @@ -1,7 +1,7 @@ # gcloud info > Display information about the current `gcloud` environment. -> More information: . +> More information: . - Display `gcloud` environment information: diff --git a/pages/common/gcloud-topic.md b/pages/common/gcloud-topic.md index 8a5a93ebc..016313dbc 100644 --- a/pages/common/gcloud-topic.md +++ b/pages/common/gcloud-topic.md @@ -1,6 +1,6 @@ # gcloud topic -> Provides supplementary help for topics not directly associated with individual commands. See also `gcloud`. +> Display supplementary help for topics not directly associated with individual commands. See also `gcloud`. > For general help, see `tldr gcloud help`. > More information: . diff --git a/pages/common/gcpdiag.md b/pages/common/gcpdiag.md index e81c23b0a..78ff03c67 100644 --- a/pages/common/gcpdiag.md +++ b/pages/common/gcpdiag.md @@ -1,7 +1,7 @@ # gcpdiag > Google Cloud Platform troubleshooting and diagnostics tool. -> Run in a docker container or in GCP Cloudshell. +> Run in a Docker container or in GCP Cloudshell. > More information: . - Run `gcpdiag` on your project, returning all rules: diff --git a/pages/common/gh-api.md b/pages/common/gh-api.md index 2beedb01b..f7829431c 100644 --- a/pages/common/gh-api.md +++ b/pages/common/gh-api.md @@ -1,6 +1,6 @@ # gh api -> Makes authenticated HTTP requests to the GitHub API and prints the response. +> Make authenticated HTTP requests to the GitHub API and print the response. > More information: . - Display the releases for the current repository in JSON format: diff --git a/pages/common/gist.md b/pages/common/gist.md index 8cb16e836..4a517bcf3 100644 --- a/pages/common/gist.md +++ b/pages/common/gist.md @@ -1,9 +1,9 @@ # gist -> Upload code to https://gist.github.com. +> Upload code to . > More information: . -- Log in in gist on this computer: +- Log in to gist on this computer: `gist --login` diff --git a/pages/common/git-add.md b/pages/common/git-add.md index 910d0c6a2..15d6df3e4 100644 --- a/pages/common/git-add.md +++ b/pages/common/git-add.md @@ -11,6 +11,10 @@ `git add -A` +- Add all files in the current folder: + +`git add .` + - Only add already tracked files: `git add -u` diff --git a/pages/common/git-archive-file.md b/pages/common/git-archive-file.md index 0b81a039b..a0e60b258 100644 --- a/pages/common/git-archive-file.md +++ b/pages/common/git-archive-file.md @@ -1,9 +1,9 @@ # git archive-file -> Export all the files of the current Git branch into a `zip` archive. +> Export all the files of the current Git branch into a Zip archive. > Part of `git-extras`. > More information: . -- Pack the currently checked out commit into a `zip` archive: +- Pack the currently checked out commit into a Zip archive: `git archive-file` diff --git a/pages/common/git-archive.md b/pages/common/git-archive.md index 1ac422c58..b9065a780 100644 --- a/pages/common/git-archive.md +++ b/pages/common/git-archive.md @@ -1,28 +1,28 @@ # git archive -> Create an archive of files from a named tree. +> Create an archive of files from a tree. > More information: . - Create a tar archive from the contents of the current HEAD and print it to `stdout`: `git archive --verbose HEAD` -- Create a zip archive from the current HEAD and print it to `stdout`: +- Use the Zip format and report progress verbosely: -`git archive --verbose --format zip HEAD` +`git archive {{-v|--verbose}} --format zip HEAD` -- Same as above, but write the zip archive to file: +- Output the Zip archive to a specific file: -`git archive --verbose --output {{path/to/file.zip}} HEAD` +`git archive -v {{-o|--output}} {{path/to/file.zip}} HEAD` -- Create a tar archive from the contents of the latest commit on a specific branch: +- Create a tar archive from the contents of the latest commit of a specific branch: -`git archive --output {{path/to/file.tar}} {{branch_name}}` +`git archive -o {{path/to/file.tar}} {{branch_name}}` -- Create a tar archive from the contents of a specific directory: +- Use the contents of a specific directory: -`git archive --output {{path/to/file.tar}} HEAD:{{path/to/directory}}` +`git archive -o {{path/to/file.tar}} HEAD:{{path/to/directory}}` - Prepend a path to each file to archive it inside a specific directory: -`git archive --output {{path/to/file.tar}} --prefix {{path/to/prepend}}/ HEAD` +`git archive -o {{path/to/file.tar}} --prefix {{path/to/prepend}}/ HEAD` diff --git a/pages/common/git-bug.md b/pages/common/git-bug.md index 2cd7e7e3f..3ba1ca980 100644 --- a/pages/common/git-bug.md +++ b/pages/common/git-bug.md @@ -12,11 +12,11 @@ `git bug add` -- You can push your new entry to a remote: +- Push a new bug entry to a remote: `git bug push` -- You can pull for updates: +- Pull for updates: `git bug pull` diff --git a/pages/common/git-bulk.md b/pages/common/git-bulk.md index d1af4d142..2e3e458b6 100644 --- a/pages/common/git-bulk.md +++ b/pages/common/git-bulk.md @@ -12,13 +12,13 @@ `git bulk --addworkspace {{workspace_name}} {{/absolute/path/to/repository}}` -- Clone a repository inside a specific directory then register the repository as a workspace: +- Clone a repository inside a specific directory, then register the repository as a workspace: `git bulk --addworkspace {{workspace_name}} {{/absolute/path/to/parent_directory}} --from {{remote_repository_location}}` -- Clone repositories from a newline-separated list of remote locations then register them as workspaces: +- Clone repositories from a newline-separated list of remote locations, then register them as workspaces: -`git bulk --addworkspace {{workspace-name}} {{/path/to/root/directory}} --from {{/path/to/file}}` +`git bulk --addworkspace {{workspace_name}} {{/path/to/root/directory}} --from {{/path/to/file}}` - List all registered workspaces: diff --git a/pages/common/git-contrib.md b/pages/common/git-contrib.md index 895eebee5..439c9d6f2 100644 --- a/pages/common/git-contrib.md +++ b/pages/common/git-contrib.md @@ -1,6 +1,6 @@ # git contrib -> Display commits from a author. +> Display commits from an author. > Part of `git-extras`. > More information: . diff --git a/pages/common/git-force-clone.md b/pages/common/git-force-clone.md index 148453ddd..61d22f55a 100644 --- a/pages/common/git-force-clone.md +++ b/pages/common/git-force-clone.md @@ -1,6 +1,6 @@ # git force-clone -> Provides the basic functionality of `git clone`, but if the destination Git repository already exists it will force-reset it to resemble a clone of the remote. +> Get the basic functionality of `git clone`, but if the destination Git repository already exists it will force-reset it to resemble a clone of the remote. > Part of `git-extras`. > More information: . diff --git a/pages/common/git-fsck.md b/pages/common/git-fsck.md index 170399258..f6a9725d2 100644 --- a/pages/common/git-fsck.md +++ b/pages/common/git-fsck.md @@ -1,7 +1,8 @@ # git fsck > Verify the validity and connectivity of nodes in a Git repository index. -> Does not make any modifications. See `git gc` for cleaning up dangling blobs. +> Does not make any modifications. +> See also: `git gc` for cleaning up dangling blobs. > More information: . - Check the current repository: diff --git a/pages/common/git-init.md b/pages/common/git-init.md index f36ef690d..438907413 100644 --- a/pages/common/git-init.md +++ b/pages/common/git-init.md @@ -15,6 +15,6 @@ `git init --object-format={{sha256}}` -- Initialize a barebones repository, suitable for use as a remote over ssh: +- Initialize a barebones repository, suitable for use as a remote over SSH: `git init --bare` diff --git a/pages/common/git-lfs.md b/pages/common/git-lfs.md index 9038298b0..d214313d5 100644 --- a/pages/common/git-lfs.md +++ b/pages/common/git-lfs.md @@ -1,7 +1,7 @@ # git lfs > Work with large files in Git repositories. -> More information: . +> More information: . - Initialize Git LFS: diff --git a/pages/common/git-mktree.md b/pages/common/git-mktree.md new file mode 100644 index 000000000..bef382dd6 --- /dev/null +++ b/pages/common/git-mktree.md @@ -0,0 +1,24 @@ +# git mktree + +> Build a tree object using `ls-tree` formatted text. +> More information: . + +- Build a tree object and verify that each tree entry’s hash identifies an existing object: + +`git mktree` + +- Allow missing objects: + +`git mktree --missing` + +- Read the NUL ([z]ero character) terminated output of the tree object (`ls-tree -z`): + +`git mktree -z` + +- Allow the creation of multiple tree objects: + +`git mktree --batch` + +- Sort and build a tree from `stdin` (non-recursive `git ls-tree` output format is required): + +`git mktree < {{path/to/tree.txt}}` diff --git a/pages/common/git-tag.md b/pages/common/git-tag.md index 74397937f..eff87c349 100644 --- a/pages/common/git-tag.md +++ b/pages/common/git-tag.md @@ -24,10 +24,14 @@ `git tag -d {{tag_name}}` -- Get updated tags from upstream: +- Get updated tags from remote: `git fetch --tags` +- Push a tag to remote: + +`git push origin tag {{tag_name}}` + - List all tags whose ancestors include a given commit: `git tag --contains {{commit}}` diff --git a/pages/common/git-var.md b/pages/common/git-var.md index 1b2341771..a915b0c9e 100644 --- a/pages/common/git-var.md +++ b/pages/common/git-var.md @@ -1,6 +1,6 @@ # git var -> Prints a Git logical variable's value. +> Print a Git logical variable's value. > See `git config`, which is preferred over `git var`. > More information: . diff --git a/pages/common/github-label-sync.md b/pages/common/github-label-sync.md index df6963f53..cc6567908 100644 --- a/pages/common/github-label-sync.md +++ b/pages/common/github-label-sync.md @@ -1,6 +1,6 @@ # github-label-sync -> A command-line interface for synchronizing GitHub labels. +> Synchronize GitHub labels. > More information: . - Synchronize labels using a local `labels.json` file: diff --git a/pages/common/gitk.md b/pages/common/gitk.md index c0e6264f8..c64568f60 100644 --- a/pages/common/gitk.md +++ b/pages/common/gitk.md @@ -1,6 +1,7 @@ # gitk -> A graphical Git repository browser. +> Browse Git repositories graphically. +> See also: `git-gui`, `git-cola`, `tig`. > More information: . - Show the repository browser for the current Git repository: @@ -21,4 +22,4 @@ - Show at most 100 changes in all branches: -` gitk --max-count={{100}} --all` +`gitk --max-count=100 --all` diff --git a/pages/common/gitleaks.md b/pages/common/gitleaks.md new file mode 100644 index 000000000..e8f619eb0 --- /dev/null +++ b/pages/common/gitleaks.md @@ -0,0 +1,32 @@ +# gitleaks + +> Detect secrets and API keys leaked in Git repositories. +> More information: . + +- Scan a remote repository: + +`gitleaks detect --repo-url {{https://github.com/username/repository.git}}` + +- Scan a local directory: + +`gitleaks detect --source {{path/to/repository}}` + +- Output scan results to a JSON file: + +`gitleaks detect --source {{path/to/repository}} --report {{path/to/report.json}}` + +- Use a custom rules file: + +`gitleaks detect --source {{path/to/repository}} --config-path {{path/to/config.toml}}` + +- Start scanning from a specific commit: + +`gitleaks detect --source {{path/to/repository}} --log-opts {{--since=commit_id}}` + +- Scan uncommitted changes before a commit: + +`gitleaks protect --staged` + +- Display verbose output indicating which parts were identified as leaks during the scan: + +`gitleaks protect --staged --verbose` diff --git a/pages/common/gitui.md b/pages/common/gitui.md index e87f23cfc..1b09dca0a 100644 --- a/pages/common/gitui.md +++ b/pages/common/gitui.md @@ -1,6 +1,7 @@ # gitui -> Terminal UI for Git. +> A lightweight keyboard-only TUI for Git. +> See also: `tig`, `git-gui`. > More information: . - Specify the color theme (defaults to `theme.ron`): diff --git a/pages/common/gleam.md b/pages/common/gleam.md new file mode 100644 index 000000000..872fa81f0 --- /dev/null +++ b/pages/common/gleam.md @@ -0,0 +1,36 @@ +# gleam + +> The compiler, build tool, package manager and code formatter for Gleam, "a friendly language for building type-safe systems that scale!". +> More information: . + +- Create a new gleam project: + +`gleam new {{project_name}}` + +- Build and run a gleam project: + +`gleam run` + +- Build the project: + +`gleam build` + +- Run a project for a particular platform and runtime: + +`gleam run --target {{platform}} --runtime {{runtime}}` + +- Add a hex dependency to your project: + +`gleam add {{dependency_name}}` + +- Run project tests: + +`gleam test` + +- Format source code: + +`gleam format` + +- Type check the project: + +`gleam check` diff --git a/pages/common/go-fmt.md b/pages/common/go-fmt.md index d65a7a92b..b78ec7328 100644 --- a/pages/common/go-fmt.md +++ b/pages/common/go-fmt.md @@ -1,7 +1,6 @@ # go fmt -> Format Go source files. -> Prints the filenames that are changed. +> Format Go source files, printing the changed filenames. > More information: . - Format Go source files in the current directory: diff --git a/pages/common/golangci-lint.md b/pages/common/golangci-lint.md index e4c08eb29..979e61659 100644 --- a/pages/common/golangci-lint.md +++ b/pages/common/golangci-lint.md @@ -1,7 +1,7 @@ # golangci-lint > Parallelized, smart and fast Go linters runner that integrates with all major IDEs and supports YAML configuration. -> More information: . +> More information: . - Run linters in the current folder: diff --git a/pages/common/grep.md b/pages/common/grep.md index cc3909861..171e1e333 100644 --- a/pages/common/grep.md +++ b/pages/common/grep.md @@ -9,28 +9,28 @@ - Search for an exact string (disables regular expressions): -`grep --fixed-strings "{{exact_string}}" {{path/to/file}}` +`grep {{-F|--fixed-strings}} "{{exact_string}}" {{path/to/file}}` - Search for a pattern in all files recursively in a directory, showing line numbers of matches, ignoring binary files: -`grep --recursive --line-number --binary-files={{without-match}} "{{search_pattern}}" {{path/to/directory}}` +`grep {{-r|--recursive}} {{-n|--line-number}} --binary-files {{without-match}} "{{search_pattern}}" {{path/to/directory}}` - Use extended regular expressions (supports `?`, `+`, `{}`, `()` and `|`), in case-insensitive mode: -`grep --extended-regexp --ignore-case "{{search_pattern}}" {{path/to/file}}` +`grep {{-E|--extended-regexp}} {{-i|--ignore-case}} "{{search_pattern}}" {{path/to/file}}` - Print 3 lines of context around, before, or after each match: -`grep --{{context|before-context|after-context}}={{3}} "{{search_pattern}}" {{path/to/file}}` +`grep --{{context|before-context|after-context}} 3 "{{search_pattern}}" {{path/to/file}}` - Print file name and line number for each match with color output: -`grep --with-filename --line-number --color=always "{{search_pattern}}" {{path/to/file}}` +`grep {{-H|--with-filename}} {{-n|--line-number}} --color=always "{{search_pattern}}" {{path/to/file}}` - Search for lines matching a pattern, printing only the matched text: -`grep --only-matching "{{search_pattern}}" {{path/to/file}}` +`grep {{-o|--only-matching}} "{{search_pattern}}" {{path/to/file}}` - Search `stdin` for lines that do not match a pattern: -`cat {{path/to/file}} | grep --invert-match "{{search_pattern}}"` +`cat {{path/to/file}} | grep {{-v|--invert-match}} "{{search_pattern}}"` diff --git a/pages/common/gzip.md b/pages/common/gzip.md index b652044ad..aabe2b929 100644 --- a/pages/common/gzip.md +++ b/pages/common/gzip.md @@ -5,24 +5,28 @@ - Compress a file, replacing it with a `gzip` archive: -`gzip {{file.ext}}` +`gzip {{path/to/file}}` - Decompress a file, replacing it with the original uncompressed version: -`gzip -d {{file.ext}}.gz` +`gzip {{-d|--decompress path/to/file.gz}}` - Compress a file, keeping the original file: -`gzip --keep {{file.ext}}` +`gzip {{-k|--keep path/to/file}}` -- Compress a file specifying the output filename: +- Compress a file, specifying the output filename: -`gzip -c {{file.ext}} > {{compressed_file.ext.gz}}` +`gzip {{-c|--stdout path/to/file}} > {{path/to/compressed_file.gz}}` - Decompress a `gzip` archive specifying the output filename: -`gzip -c -d {{file.ext}}.gz > {{uncompressed_file.ext}}` +`gzip {{-c|--stdout}} {{-d|--decompress}} {{path/to/file.gz}} > {{path/to/uncompressed_file}}` -- Specify the compression level. 1=Fastest (Worst), 9=Slowest (Best), Default level is 6: +- Specify the compression level. 1 is the fastest (low compression), 9 is the slowest (high compression), 6 is the default: -`gzip -9 -c {{file.ext}} > {{compressed_file.ext.gz}}` +`gzip -{{1..9}} {{-c|--stdout}} {{path/to/file}} > {{path/to/compressed_file.gz}}` + +- Display the name and reduction percentage for each file compressed or decompressed: + +`gzip {{-v|--verbose}} {{-d|--decompress}} {{path/to/file.gz}}` diff --git a/pages/common/hashcat.md b/pages/common/hashcat.md index 4bf2eeeb7..b98fb2355 100644 --- a/pages/common/hashcat.md +++ b/pages/common/hashcat.md @@ -30,3 +30,7 @@ - Show result of an already cracked hash: `hashcat --show {{hash_value}}` + +- Show all example hashes: + +`hashcat --example-hashes` diff --git a/pages/common/helm.md b/pages/common/helm.md index 540478911..b17a698b4 100644 --- a/pages/common/helm.md +++ b/pages/common/helm.md @@ -28,7 +28,7 @@ `helm install {{name}} {{repository_name}}/{{chart_name}}` -- Download helm chart as a `tar` archive: +- Download helm chart as a tar archive: `helm get {{chart_release_name}}` diff --git a/pages/common/histexpand.md b/pages/common/histexpand.md index d6642685c..03f4fc6e4 100644 --- a/pages/common/histexpand.md +++ b/pages/common/histexpand.md @@ -1,6 +1,6 @@ # history expansion -> Reuse and expand the shell history in `sh`, `bash`, `zsh`, `rbash` and `ksh`. +> Reuse and expand the shell history in `sh`, Bash, Zsh, `rbash` and `ksh`. > More information: . - Run the previous command as root (`!!` is replaced by the previous command): diff --git a/pages/common/history.md b/pages/common/history.md index 953afe568..1b832fff5 100644 --- a/pages/common/history.md +++ b/pages/common/history.md @@ -7,18 +7,22 @@ `history` -- Display the last 20 commands (in `zsh` it displays all commands starting from the 20th): +- Display the last 20 commands (in Zsh it displays all commands starting from the 20th): `history {{20}}` -- Clear the commands history list (only for current `bash` shell): +- Display history with timestamps in different formats (only available in Zsh): + +`history -{{d|f|i|E}}` + +- [c]lear the commands history list (only for current Bash shell): `history -c` -- Overwrite history file with history of current `bash` shell (often combined with `history -c` to purge history): +- Over[w]rite history file with history of current Bash shell (often combined with `history -c` to purge history): `history -w` -- Delete the history entry at the specified offset: +- [d]elete the history entry at the specified offset: `history -d {{offset}}` diff --git a/pages/common/hledger-accounts.md b/pages/common/hledger-accounts.md new file mode 100644 index 000000000..82cf3498b --- /dev/null +++ b/pages/common/hledger-accounts.md @@ -0,0 +1,36 @@ +# hledger accounts + +> List account names. +> More information: . + +- Show all accounts used or declared in the default journal file: + +`hledger accounts` + +- Show accounts used by transactions: + +`hledger accounts --used` + +- Show accounts declared with account directives: + +`hledger accounts --declared` + +- Add new account directives, for accounts used but not declared, to the journal: + +`hledger accounts --undeclared --directives >> {{2024-accounts.journal}}` + +- Show accounts with `asset` in their name, and their declared/inferred types: + +`hledger accounts asset --types` + +- Show accounts of the `Asset` type: + +`hledger accounts type:A` + +- Show the first two levels of the accounts hierarchy: + +`hledger accounts --tree --depth 2` + +- Short form of the above: + +`hledger acc -t -2` diff --git a/pages/common/hledger-add.md b/pages/common/hledger-add.md new file mode 100644 index 000000000..8e61e09c6 --- /dev/null +++ b/pages/common/hledger-add.md @@ -0,0 +1,24 @@ +# hledger add + +> Record new transactions with interactive prompting in the console. +> More information: . + +- Record new transactions, saving to the default journal file: + +`hledger add` + +- Add transactions to `2024.journal`, but also load `2023.journal` for completions: + +`hledger add --file {{path/to/2024.journal}} --file {{path/to/2023.journal}}` + +- Provide answers for the first four prompts: + +`hledger add {{today}} '{{best buy}}' {{expenses:supplies}} '{{$20}}'` + +- Show `add`'s options and documentation with `$PAGER`: + +`hledger add --help` + +- Show `add`'s documentation with `info` or `man` if available: + +`hledger help add` diff --git a/pages/common/hledger-aregister.md b/pages/common/hledger-aregister.md new file mode 100644 index 000000000..5d793532c --- /dev/null +++ b/pages/common/hledger-aregister.md @@ -0,0 +1,20 @@ +# hledger aregister + +> Show the transactions and running balances in one account, with each transaction on one line. +> More information: . + +- Show transactions and running balance in the `assets:bank:checking` account: + +`hledger aregister assets:bank:checking` + +- Show transactions and running balance in the first account named `*savings*`: + +`hledger aregister savings` + +- Show the checking account's cleared transactions, with a specified width: + +`hledger aregister checking --cleared --width {{120}}` + +- Show the checking register, including transactions from forecast rules: + +`hledger aregister checking --forecast` diff --git a/pages/common/hledger-balance.md b/pages/common/hledger-balance.md new file mode 100644 index 000000000..6dcd62889 --- /dev/null +++ b/pages/common/hledger-balance.md @@ -0,0 +1,37 @@ +# hledger balance + +> A flexible, general purpose "summing" report that shows accounts with some kind of numeric data. +> This can be balance changes per period, end balances, budget performance, unrealised capital gains, etc. +> More information: . + +- Show the balance change in all accounts from all postings over all time: + +`hledger balance` + +- Show the balance change in accounts named `*expenses*`, as a tree, summarising the top two levels only: + +`hledger balance {{expenses}} --tree --depth {{2}}` + +- Show expenses each month, and their totals and averages, sorted by total; and their monthly budget goals: + +`hledger balance {{expenses}} --monthly --row-total --average --sort-amount --budget` + +- Similar to the above, shorter form, matching accounts by `Expense` type, as a two level tree without squashing boring accounts: + +`hledger bal type:{{X}} -MTAS --budget -t -{{2}} --no-elide` + +- Show end balances (including from postings before the start date), quarterly in 2024, in accounts named `*assets*` or `*liabilities*`: + +`hledger balance --historical --period '{{quarterly in 2024}}' {{assets}} {{liabilities}}` + +- Similar to the above, shorter form; also show zero balances, sort by total and summarise to three levels: + +`hledger bal -HQ date:{{2024}} type:{{AL}} -ES -{{3}}` + +- Show investment assets' market value in base currency at the end of each quarter: + +`hledger bal -HVQ {{assets:investments}}` + +- Show unrealised capital gains/losses from market price changes in each quarter, for non-cryptocurrency investment assets: + +`hledger bal --gain -Q {{assets:investments}} not:{{cryptocurrency}}` diff --git a/pages/common/hledger-balancesheet.md b/pages/common/hledger-balancesheet.md new file mode 100644 index 000000000..2d20a634b --- /dev/null +++ b/pages/common/hledger-balancesheet.md @@ -0,0 +1,33 @@ +# hledger balancesheet + +> Show the end balances in asset and liability accounts. +> Amounts are shown with normal positive sign, as in conventional financial statements. +> More information: . + +- Show the current balances in `Asset` and `Liability` accounts, excluding zeros: + +`hledger balancesheet` + +- Show just the liquid assets (`Cash` account type): + +`hledger balancesheet type:C` + +- Include accounts with zero balances, and show the account hierarchy: + +`hledger balancesheet --empty --tree` + +- Show the balances at the end of each month: + +`hledger balancesheet --monthly` + +- Show the balances' market value in home currency at the end of each month: + +`hledger balancesheet --monthly -V` + +- Show quarterly balances, with just the top two levels of account hierarchy: + +`hledger balancesheet --quarterly --tree --depth 2` + +- Short form of the above, and generate HTML output in `bs.html`: + +`hledger bs -Qt -2 -o bs.html` diff --git a/pages/common/hledger-import.md b/pages/common/hledger-import.md new file mode 100644 index 000000000..d1d7a82ce --- /dev/null +++ b/pages/common/hledger-import.md @@ -0,0 +1,28 @@ +# hledger import + +> Import new transactions from one or more data files to the main journal. +> More information: . + +- Import new transactions from `bank.csv`, using `bank.csv.rules` to convert: + +`hledger import {{path/to/bank.csv}}` + +- Show what would be imported from these two files, without doing anything: + +`hledger import {{path/to/bank1.csv}} {{path/to/bank2.csv}} --dry-run` + +- Import new transactions from all CSV files, using the same rules for all: + +`hledger import --rules-file {{common.rules}} *.csv` + +- Show conversion errors or results while editing `bank.csv.rules`: + +`watchexec -- hledger -f {{path/to/bank.csv}} print` + +- Mark `bank.csv`'s current data as seen, as if already imported: + +`hledger import --catchup {{path/to/bank.csv}}` + +- Mark `bank.csv` as all new, as if not yet imported: + +`rm -f .latest.bank.csv` diff --git a/pages/common/hledger-incomestatement.md b/pages/common/hledger-incomestatement.md new file mode 100644 index 000000000..e1d159b35 --- /dev/null +++ b/pages/common/hledger-incomestatement.md @@ -0,0 +1,21 @@ +# hledger incomestatement + +> Show revenue inflows and expense outflows during the report period. +> Amounts are shown with normal positive sign, as in conventional financial statements. +> More information: . + +- Show revenues and expenses (changes in `Revenue` and `Expense` accounts): + +`hledger incomestatement` + +- Show revenues and expenses each month: + +`hledger incomestatement --monthly` + +- Show monthly revenues/expenses/totals, largest first, summarised to 2 levels: + +`hledger incomestatement --monthly --row-total --average --sort --depth 2` + +- Short form of the above, and generate HTML output in `is.html`: + +`hledger is -MTAS -2 -o is.html` diff --git a/pages/common/hledger-print.md b/pages/common/hledger-print.md new file mode 100644 index 000000000..af3f0e5b8 --- /dev/null +++ b/pages/common/hledger-print.md @@ -0,0 +1,32 @@ +# hledger print + +> Show full journal entries, representing transactions. +> More information: . + +- Show all transactions in the default journal file: + +`hledger print` + +- Show transactions, with any implied amounts or costs made explicit: + +`hledger print --explicit --infer-costs` + +- Show transactions from two specified files, with amounts converted to cost: + +`hledger print --file {{path/to/2023.journal}} --file {{path/to/2024.journal}} --cost` + +- Show `$` transactions in `*food*` but not `*groceries*` accounts this month: + +`hledger print cur:\\$ food not:groceries date:thismonth` + +- Show transactions of amount 50 or more, with `whole foods` in their description: + +`hledger print amt:'>50' desc:'whole foods'` + +- Show cleared transactions, with `EUR` amounts rounded and with decimal commas: + +`hledger print --cleared --commodity '1000, EUR' --round hard` + +- Write transactions from `foo.journal` as a CSV file: + +`hledger print --file {{path/to/foo.journal}} --output-file {{path/to/output_file.csv}}` diff --git a/pages/common/hledger-ui.md b/pages/common/hledger-ui.md new file mode 100644 index 000000000..23bdce3de --- /dev/null +++ b/pages/common/hledger-ui.md @@ -0,0 +1,32 @@ +# hledger-ui + +> A terminal interface (TUI) for `hledger`, a robust, friendly plain text accounting app. +> More information: . + +- Start in the main menu screen, reading from the default journal file: + +`hledger-ui` + +- Start with a different color theme: + +`hledger-ui --theme {{terminal|greenterm|dark}}` + +- Start in the balance sheet accounts screen, showing hierarchy down to level 3: + +`hledger-ui --bs --tree --depth 3` + +- Start in this account's screen, showing cleared transactions, and reload on change: + +`hledger-ui --register {{assets:bank:checking}} --cleared --watch` + +- Read two journal files, and show amounts as current value when known: + +`hledger-ui --file {{path/to/2024.journal}} --file {{path/to/2024-prices.journal}} --value now` + +- Show the manual in Info format, if possible: + +`hledger-ui --info` + +- Display help: + +`hledger-ui --help` diff --git a/pages/common/hledger-web.md b/pages/common/hledger-web.md new file mode 100644 index 000000000..eb20e0425 --- /dev/null +++ b/pages/common/hledger-web.md @@ -0,0 +1,32 @@ +# hledger-web + +> A web interface and API for `hledger`, a robust, friendly plain text accounting app. +> More information: . + +- Start the web app, and a browser if possible, for local viewing and adding only: + +`hledger-web` + +- As above but with a specified file, and allow editing of existing data: + +`hledger-web --file {{path/to/file.journal}} --allow edit` + +- Start just the web app, and accept incoming connections to the specified host and port: + +`hledger-web --serve --host {{my.host.name}} --port 8000` + +- Start just the web app's JSON API, and allow only read access: + +`hledger-web --serve-api --host {{my.host.name}} --allow view` + +- Show amounts converted to current market value in your base currency when known: + +`hledger-web --value now --infer-market-prices` + +- Show the manual in Info format if possible: + +`hledger-web --info` + +- Display help: + +`hledger-web --help` diff --git a/pages/common/hledger.md b/pages/common/hledger.md index 3e678374e..585c84f19 100644 --- a/pages/common/hledger.md +++ b/pages/common/hledger.md @@ -1,20 +1,37 @@ # hledger -> A plain text accounting software for the command-line. -> More information: . +> A robust, friendly plain text accounting app. +> See also: `hledger-ui` for TUI, `hledger-web` for web interface. +> More information: . -- Add transactions to your journal interactively: +- Record new transactions interactively, saving to the default journal file: `hledger add` -- Show the account hierarchy, using a specific journal file: +- Import new transactions from `bank.csv`, using `bank.csv.rules` to convert: -`hledger --file {{path/to/file.journal}} accounts --tree` +`hledger import {{path/to/bank.csv}}` -- Show a monthly income statement: +- Print all transactions, reading from multiple specified journal files: -`hledger incomestatement --monthly --depth 2` +`hledger print --file {{path/to/prices-2024.journal}} --file {{path/to/prices-2023.journal}}` -- Print the amount of cash spent on food: +- Show all accounts, as a hierarchy, and their types: -`hledger print assets:cash | hledger -f- -I balance expenses:food --depth 2` +`hledger accounts --tree --types` + +- Show asset and liability account balances, including zeros, hierarchically: + +`hledger balancesheet --empty --tree --no-elide` + +- Show monthly incomes/expenses/totals, largest first, summarised to 2 levels: + +`hledger incomestatement --monthly --row-total --average --sort --depth 2` + +- Show the `assets:bank:checking` account's transactions and running balance: + +`hledger aregister assets:bank:checking` + +- Show the amount spent on food from the `assets:cash` account: + +`hledger print assets:cash | hledger -f- -I aregister expenses:food` diff --git a/pages/common/hostid.md b/pages/common/hostid.md index a5ad0f424..b2986faaf 100644 --- a/pages/common/hostid.md +++ b/pages/common/hostid.md @@ -1,6 +1,6 @@ # hostid -> Prints the numeric identifier for the current host (not necessarily the IP address). +> Print the numeric identifier for the current host (not necessarily the IP address). > More information: . - Display the numeric identifier for the current host in hexadecimal: diff --git a/pages/common/httpflow.md b/pages/common/httpflow.md index e55a82131..dc7e25f4c 100644 --- a/pages/common/httpflow.md +++ b/pages/common/httpflow.md @@ -15,7 +15,7 @@ `httpflow -u '{{regular_expression}}'` -- Read packets from pcap format binary file: +- Read packets from PCAP format binary file: `httpflow -r {{out.cap}}` diff --git a/pages/common/httpry.md b/pages/common/httpry.md index 23a6c66bf..84475b119 100644 --- a/pages/common/httpry.md +++ b/pages/common/httpry.md @@ -8,7 +8,7 @@ `httpry -o {{path/to/file.log}}` -- Listen on a specific interface and save output to a binary pcap format file: +- Listen on a specific interface and save output to a binary PCAP format file: `httpry {{eth0}} -b {{path/to/file.pcap}}` diff --git a/pages/common/hub-browse.md b/pages/common/hub-browse.md index 4f830440d..a4efb1f36 100644 --- a/pages/common/hub-browse.md +++ b/pages/common/hub-browse.md @@ -1,7 +1,7 @@ # hub browse > Open a GitHub repository in the browser or print the URL. -> More information: . +> More information: . - Open the homepage of the current repository in the default web browser: diff --git a/pages/common/hub-clone.md b/pages/common/hub-clone.md index 021055c7c..81c48e963 100644 --- a/pages/common/hub-clone.md +++ b/pages/common/hub-clone.md @@ -3,6 +3,6 @@ > Clone an existing repository. > More information: . -- Clone an existing repository to current directory (If run into authentication problem, try full ssh path): +- Clone an existing repository to current directory (If run into authentication problem, try full SSH path): `hub clone {{remote_repository_location}}` diff --git a/pages/common/ical.md b/pages/common/ical.md index a65890aa1..9a774b42b 100644 --- a/pages/common/ical.md +++ b/pages/common/ical.md @@ -1,6 +1,6 @@ # ical -> A Hirji/Islamic calendar and converter for the terminal. +> View Hirji/Islamic and Gregorian calendars and convert their dates. > More information: . - Display the current month's calendar: diff --git a/pages/common/icontopbm.md b/pages/common/icontopbm.md index b898aea37..0deb1966d 100644 --- a/pages/common/icontopbm.md +++ b/pages/common/icontopbm.md @@ -1,8 +1,8 @@ # icontopbm -> This command is superseded by `sunicontopbm`. +> This command is superseded by `sunicontopnm`. > More information: . - View documentation for the current command: -`tldr sunicontopbm` +`tldr sunicontopnm` diff --git a/pages/common/iconv.md b/pages/common/iconv.md index c542e13a0..f8c484ff6 100644 --- a/pages/common/iconv.md +++ b/pages/common/iconv.md @@ -1,6 +1,6 @@ # iconv -> Converts text from one encoding to another. +> Convert text from one encoding to another. > More information: . - Convert file to a specific encoding, and print to `stdout`: diff --git a/pages/common/identify.md b/pages/common/identify.md index f6a54ebc4..96e24b4eb 100644 --- a/pages/common/identify.md +++ b/pages/common/identify.md @@ -1,17 +1,7 @@ # identify -> Describe the format and characteristics of image files. -> Part of ImageMagick. -> More information: . +> This command is an alias of `magick identify`. -- Describe the format and basic characteristics of an image: +- View documentation for the original command: -`identify {{path/to/image}}` - -- Describe the format and verbose characteristics of an image: - -`identify -verbose {{path/to/image}}` - -- Collect dimensions of all JPEG files in the current directory and save them into a CSV file: - -`identify -format "{{%f,%w,%h\n}}" {{*.jpg}} > {{path/to/filelist.csv}}` +`tldr magick identify` diff --git a/pages/common/idnits.md b/pages/common/idnits.md index 8a516f5b4..b6e538975 100644 --- a/pages/common/idnits.md +++ b/pages/common/idnits.md @@ -2,7 +2,7 @@ > Check internet-drafts for submission nits. > Looks for violations of Section 2.1 and 2.2 of the requirements listed on . -> More information: . +> More information: . - Check a file for nits: diff --git a/pages/common/imgtoppm.md b/pages/common/imgtoppm.md index fc01e894b..18d8bcc0d 100644 --- a/pages/common/imgtoppm.md +++ b/pages/common/imgtoppm.md @@ -1,6 +1,6 @@ # imgtoppm -> Converts various image file formats to the PPM (Portable Pixmap) format. +> Convert various image file formats to the PPM (Portable Pixmap) format. > More information: . - Convert an input image to PPM format: diff --git a/pages/common/immich-cli.md b/pages/common/immich-cli.md new file mode 100644 index 000000000..c506f12c4 --- /dev/null +++ b/pages/common/immich-cli.md @@ -0,0 +1,29 @@ +# immich-cli + +> Immich has a command-line interface (CLI) that allows you to perform certain actions from the command-line. +> See also: `immich-go`. +> More information: . + +- Authenticate to Immich server: + +`immich login {{server_url/api}} {{server_key}}` + +- Upload some image files: + +`immich upload {{file1.jpg file2.jpg}}` + +- Upload a directory including subdirectories: + +`immich upload --recursive {{path/to/directory}}` + +- Create an album based on a directory: + +`immich upload --album-name "{{My summer holiday}}" --recursive {{path/to/directory}}` + +- Skip assets matching a glob pattern: + +`immich upload --ignore {{**/Raw/** **/*.tif}} --recursive {{path/to/directory}}` + +- Include hidden files: + +`immich upload --include-hidden --recursive {{path/to/directory}}` diff --git a/pages/common/immich-go.md b/pages/common/immich-go.md new file mode 100644 index 000000000..eaa63daa5 --- /dev/null +++ b/pages/common/immich-go.md @@ -0,0 +1,25 @@ +# immich-go + +> Immich-Go is an open-source tool designed to streamline uploading large photo collections to your self-hosted Immich server. +> See also: `immich-cli`. +> More information: . + +- Upload a Google Photos takeout file to Immich server: + +`immich-go -server={{server_url}} -key={{server_key}} upload {{path/to/takeout_file.zip}}` + +- Import photos captured on June 2019, while auto-generating albums: + +`immich-go -server={{server_url}} -key={{server_key}} upload -create-albums -google-photos -date={{2019-06}} {{path/to/takeout_file.zip}}` + +- Upload a takeout file using server and key from a config file: + +`immich-go -use-configuration={{~/.immich-go/immich-go.json}} upload {{path/to/takeout_file.zip}}` + +- Examine Immich server content, remove less quality images, and preserve albums: + +`immich-go -server={{server_url}} -key={{server_key}} duplicate -yes` + +- Delete all albums created with the pattern "YYYY-MM-DD": + +`immich-go -server={{server_url}} -key={{server_key}} tool album delete {{\d{4}-\d{2}-\d{2}}}` diff --git a/pages/common/import.md b/pages/common/import.md index b6430003a..6522149ba 100644 --- a/pages/common/import.md +++ b/pages/common/import.md @@ -1,17 +1,7 @@ # import -> Capture some or all of an X server screen, and save the image to a file. -> Part of ImageMagick. -> More information: . +> This command is an alias of `magick import`. -- Capture the entire X server screen into a PostScript file: +- View documentation for the original command: -`import -window root {{path/to/output.ps}}` - -- Capture contents of a remote X server screen into a PNG image: - -`import -window root -display {{remote_host}}:{{screen}}.{{display}} {{path/to/output.png}}` - -- Capture a specific window given its ID as displayed by `xwininfo` into a JPEG image: - -`import -window {{window_id}} {{path/to/output.jpg}}` +`tldr magick import` diff --git a/pages/common/in2csv.md b/pages/common/in2csv.md index 651de9294..71cc3609b 100644 --- a/pages/common/in2csv.md +++ b/pages/common/in2csv.md @@ -1,6 +1,6 @@ # in2csv -> Converts various tabular data formats into CSV. +> Convert various tabular data formats to CSV. > Included in csvkit. > More information: . diff --git a/pages/common/ipaggcreate.md b/pages/common/ipaggcreate.md index caac990e4..1c7eb99ff 100644 --- a/pages/common/ipaggcreate.md +++ b/pages/common/ipaggcreate.md @@ -3,7 +3,7 @@ > Produce aggregate statistics of TCP/IP dumps. > More information: . -- Count the number of packets sent from each source address appearing in a pcap file: +- Count the number of packets sent from each source address appearing in a PCAP file: `ipaggcreate --src {{path/to/file.pcap}}` @@ -11,6 +11,6 @@ `ipaggcreate --interface {{eth0}} --length` -- Count the number of bytes sent between each address pair appearing in a pcap file: +- Count the number of bytes sent between each address pair appearing in a PCAP file: `ipaggcreate --address-pairs --bytes {{path/to/file.pcap}}` diff --git a/pages/common/ipcs.md b/pages/common/ipcs.md index 126548646..d19197cea 100644 --- a/pages/common/ipcs.md +++ b/pages/common/ipcs.md @@ -1,12 +1,32 @@ # ipcs -> Display information about resources used in IPC (Inter-process Communication). -> More information: . +> Show information about the usage of XSI IPC facilities: shared memory segments, message queues, and semaphore arrays. +> More information: . -- Specific information about the Message Queue which has the ID 32768: - -`ipcs -qi 32768` - -- General information about all the IPC: +- Show information about all the IPC: `ipcs -a` + +- Show information about active shared [m]emory segments, message [q]ueues or [s]empahore sets: + +`ipcs {{-m|-q|-s}}` + +- Show information on maximum allowable size in [b]ytes: + +`ipcs -b` + +- Show [c]reator’s user name and group name for all IPC facilities: + +`ipcs -c` + +- Show the [p]ID of the last operators for all IPC facilities: + +`ipcs -p` + +- Show access [t]imes for all IPC facilities: + +`ipcs -t` + +- Show [o]utstanding usage for active message queues, and shared memory segments: + +`ipcs -o` diff --git a/pages/common/ipsumdump.md b/pages/common/ipsumdump.md index 8d976519c..0bdba9e31 100644 --- a/pages/common/ipsumdump.md +++ b/pages/common/ipsumdump.md @@ -3,7 +3,7 @@ > Summarise TCP/IP dumps into a human and machine readable ASCII format. > More information: . -- Print the source and destination IP addresses of all packets in a pcap file: +- Print the source and destination IP addresses of all packets in a PCAP file: `ipsumdump --src --dst {{path/to/file.pcap}}` @@ -11,6 +11,6 @@ `ipsumdump --interface {{eth0}} -tsSdDp` -- Print the anonymised source address, anonymised destination address, and IP packet length of all packets in a pcap file: +- Print the anonymised source address, anonymised destination address, and IP packet length of all packets in a PCAP file: `ipsumdump --src --dst --length --anonymize {{path/to/file.pcap}}` diff --git a/pages/common/jbang.md b/pages/common/jbang.md index 10fa98613..88834bea1 100644 --- a/pages/common/jbang.md +++ b/pages/common/jbang.md @@ -24,7 +24,7 @@ `{{echo 'Files.list(Paths.get("/etc")).forEach(System.out::println);'}} | jbang -` -- Run command line application: +- Run command-line application: `jbang {{path/to/file.java}} {{command}} {{arg1 arg2 ...}}` diff --git a/pages/common/jc.md b/pages/common/jc.md index f8bc34ba1..4e516de4e 100644 --- a/pages/common/jc.md +++ b/pages/common/jc.md @@ -1,6 +1,6 @@ # jc -> A utility to convert the output of multiple commands to JSON. +> Convert the output of multiple commands to JSON. > More information: . - Convert command output to JSON via pipe: diff --git a/pages/common/jdupes.md b/pages/common/jdupes.md index 8b724382b..0253f6986 100644 --- a/pages/common/jdupes.md +++ b/pages/common/jdupes.md @@ -1,7 +1,7 @@ # jdupes > A powerful duplicate file finder and an enhanced fork of fdupes. -> More information: . +> More information: . - Search a single directory: diff --git a/pages/common/jhat.md b/pages/common/jhat.md index 7f4092bc6..31047653c 100644 --- a/pages/common/jhat.md +++ b/pages/common/jhat.md @@ -7,7 +7,7 @@ `jhat {{dump_file.bin}}` -- Analyze a heap dump, specifying an alternate port for the http server: +- Analyze a heap dump, specifying an alternate port for the HTTP server: `jhat -p {{port}} {{dump_file.bin}}` diff --git a/pages/common/jpegtopnm.md b/pages/common/jpegtopnm.md index 48fcee5c3..64a74e3b7 100644 --- a/pages/common/jpegtopnm.md +++ b/pages/common/jpegtopnm.md @@ -1,6 +1,6 @@ # jpegtopnm -> Converts a JPEG/JFIF file to the PPM or PGM format. +> Convert a JPEG/JFIF file to the PPM or PGM format. > More information: . - Convert JPEG/JFIF image to a PPM or PGM image: diff --git a/pages/common/jq.md b/pages/common/jq.md index aa19aaaa8..1ed0ce24f 100644 --- a/pages/common/jq.md +++ b/pages/common/jq.md @@ -1,6 +1,6 @@ # jq -> A command-line JSON processor that uses a domain-specific language (DSL). +> A JSON processor that uses a domain-specific language (DSL). > More information: . - Execute a specific expression (print a colored and formatted JSON output): diff --git a/pages/common/julia.md b/pages/common/julia.md index 8113c71c6..fe01e9de8 100644 --- a/pages/common/julia.md +++ b/pages/common/julia.md @@ -27,6 +27,6 @@ `julia -E '{{(1 - cos(pi/4))/2}}'` -- Start Julia in parallel mode, using N worker processes: +- Start Julia in multithreaded mode, using N threads: -`julia -p {{N}}` +`julia -t {{N}}` diff --git a/pages/common/katana.md b/pages/common/katana.md new file mode 100644 index 000000000..0528b60fd --- /dev/null +++ b/pages/common/katana.md @@ -0,0 +1,29 @@ +# katana + +> A fast crawler focused on execution in automation pipelines offering both headless and non-headless crawling. +> See also: `gau`, `scrapy`, `waymore`. +> More information: . + +- Crawl a list of URLs: + +`katana -list {{https://example.com,https://google.com,...}}` + +- Crawl a [u]RL using headless mode using Chromium: + +`katana -u {{https://example.com}} -headless` + +- Use `subfinder` to find subdomains, and then use [p]a[s]sive sources (Wayback Machine, Common Crawl, and AlienVault) for URL discovery: + +`subfinder -list {{path/to/domains.txt}} | katana -passive` + +- Pass requests through a proxy (http/socks5) and use custom [H]eaders from a file: + +`katana -proxy {{http://127.0.0.1:8080}} -headers {{path/to/headers.txt}} -u {{https://example.com}}` + +- Specify the crawling [s]trategy, [d]epth of subdirectories to crawl, and rate limiting (requests per second): + +`katana -strategy {{depth-first|breadth-first}} -depth {{value}} -rate-limit {{value}} -u {{https://example.com}}` + +- Find subdomains using `subfinder`, crawl each for a maximum number of seconds, and write results to an [o]utput file: + +`subfinder -list {{path/to/domains.txt}} | katana -crawl-duration {{value}} -output {{path/to/output.txt}}` diff --git a/pages/common/kdeconnect-cli.md b/pages/common/kdeconnect-cli.md index 60dcf8e32..8c87acd89 100644 --- a/pages/common/kdeconnect-cli.md +++ b/pages/common/kdeconnect-cli.md @@ -1,6 +1,6 @@ # kdeconnect-cli -> KDE's Connect CLI. +> Use KDE Connect for sharing files or text to a device, ringing it, unlocking it, and much more. > More information: . - List all devices: diff --git a/pages/common/kitex.md b/pages/common/kitex.md index f74d05f38..c6854642f 100644 --- a/pages/common/kitex.md +++ b/pages/common/kitex.md @@ -10,7 +10,7 @@ - Generate client codes when a project is not in `$GOPATH`: -` kitex -module {{github.com/xx-org/xx-name}} {{path/to/IDL_file.thrift}}` +`kitex -module {{github.com/xx-org/xx-name}} {{path/to/IDL_file.thrift}}` - Generate client codes with protobuf IDL: diff --git a/pages/common/knotc.md b/pages/common/knotc.md new file mode 100644 index 000000000..7c8b025b1 --- /dev/null +++ b/pages/common/knotc.md @@ -0,0 +1,24 @@ +# knotc + +> Control knot DNS server. +> More information: . + +- Start editing a zone: + +`knotc zone-begin {{zone}}` + +- Set an A record with TTL of 3600: + +`knotc zone-set {{zone}} {{subdomain}} 3600 A {{ip_address}}` + +- Finish editing the zone: + +`knotc zone-commit {{zone}}` + +- Get the current zone data: + +`knotc zone-read {{zone}}` + +- Get the current server configuration: + +`knotc conf-read server` diff --git a/pages/common/kops.md b/pages/common/kops.md index 5ea3f755b..86209fc90 100644 --- a/pages/common/kops.md +++ b/pages/common/kops.md @@ -7,7 +7,7 @@ `kops create cluster -f {{cluster_name.yaml}}` -- Create a new ssh public key: +- Create a new SSH public key: `kops create secret sshpublickey {{key_name}} -i {{~/.ssh/id_rsa.pub}}` diff --git a/pages/common/kubectl-apply.md b/pages/common/kubectl-apply.md index 3fbaa8a8c..1d623957c 100644 --- a/pages/common/kubectl-apply.md +++ b/pages/common/kubectl-apply.md @@ -1,6 +1,7 @@ # kubectl apply -> Manages applications through files defining Kubernetes resources. It creates and updates resources in a cluster. +> Manage applications through files defining Kubernetes resources. +> Create and update resources in a cluster. > More information: . - Apply a configuration to a resource by file name or `stdin`: diff --git a/pages/common/kubectl-label.md b/pages/common/kubectl-label.md index 398876c72..7d87a71b4 100644 --- a/pages/common/kubectl-label.md +++ b/pages/common/kubectl-label.md @@ -9,15 +9,15 @@ - Update a pod label by overwriting the existing value: -`kubectl label --overwrite {{pod_name}} {{key}}={{value}}` +`kubectl label --overwrite pod {{pod_name}} {{key}}={{value}}` - Label all pods in the namespace: `kubectl label pods --all {{key}}={{value}}` -- Label pod identified by pod definition file: +- Label a pod identified by the pod definition file: -`kubectl label -f {{pod_defination_file}} {{key}}={{value}}` +`kubectl label -f {{pod_definition_file}} {{key}}={{value}}` - Remove the label from a pod: diff --git a/pages/common/kubectl-logs.md b/pages/common/kubectl-logs.md index 035b629f5..25e3b6458 100644 --- a/pages/common/kubectl-logs.md +++ b/pages/common/kubectl-logs.md @@ -19,10 +19,6 @@ `kubectl logs --follow {{pod_name}}` -- Stream logs for a specified container in a pod: - -`kubectl logs --follow --container {{container_name}} {{pod_name}}` - - Show pod logs newer than a relative time like `10s`, `5m`, or `1h`: `kubectl logs --since={{relative_time}} {{pod_name}}` @@ -30,3 +26,7 @@ - Show the 10 most recent logs in a pod: `kubectl logs --tail={{10}} {{pod_name}}` + +- Show all pod logs for a given deployment: + +`kubectl logs deployment/{{deployment_name}}` diff --git a/pages/common/kubectx.md b/pages/common/kubectx.md index 1298aa636..1c11b25e4 100644 --- a/pages/common/kubectx.md +++ b/pages/common/kubectx.md @@ -15,6 +15,14 @@ `kubectx -` +- Rename a named context: + +`kubectx {{alias}}={{name}}` + +- Show the current named context: + +`kubectx -c` + - Delete a named context: `kubectx -d {{name}}` diff --git a/pages/linux/lastcomm.md b/pages/common/lastcomm.md similarity index 100% rename from pages/linux/lastcomm.md rename to pages/common/lastcomm.md diff --git a/pages/common/latexmk.md b/pages/common/latexmk.md index 573ca4106..e6f76864e 100644 --- a/pages/common/latexmk.md +++ b/pages/common/latexmk.md @@ -10,19 +10,23 @@ - Compile a DVI document from a specific source file: -`latexmk {{source.tex}}` +`latexmk {{path/to/source.tex}}` - Compile a PDF document: -`latexmk -pdf {{source.tex}}` +`latexmk -pdf {{path/to/source.tex}}` + +- Open the document in a viewer and continuously update it whenever source files change: + +`latexmk -pvc {{path/to/source.tex}}` - Force the generation of a document even if there are errors: -`latexmk -f {{source.tex}}` +`latexmk -f {{path/to/source.tex}}` - Clean up temporary TEX files created for a specific TEX file: -`latexmk -c {{source.tex}}` +`latexmk -c {{path/to/source.tex}}` - Clean up all temporary TEX files in the current directory: diff --git a/pages/common/lilypond.md b/pages/common/lilypond.md index 7f1bb2e09..62a1128db 100644 --- a/pages/common/lilypond.md +++ b/pages/common/lilypond.md @@ -1,6 +1,7 @@ # lilypond > Typeset music and/or produce MIDI from file. +> See also: `musescore`. > More information: . - Compile a lilypond file into a PDF: diff --git a/pages/common/llm.md b/pages/common/llm.md index bbd0413ca..8c2cd72d4 100644 --- a/pages/common/llm.md +++ b/pages/common/llm.md @@ -23,6 +23,10 @@ `llm --model {{orca-mini-3b-gguf2-q4_0}} "{{What is the capital of France?}}"` -- Have an interactive chat with a specific [m]odel: +- Create a [s]ystem prompt and [s]ave it with a template name: -`llm chat --model {{chatgpt}}` +`llm --system '{{You are a sentient cheesecake}}' --save {{sentient_cheesecake}}` + +- Have an interactive chat with a specific [m]odel using a specific [t]emplate: + +`llm chat --model {{chatgpt}} --template {{sentient_cheesecake}}` diff --git a/pages/common/llvm-dis.md b/pages/common/llvm-dis.md index 744e46484..6a995914a 100644 --- a/pages/common/llvm-dis.md +++ b/pages/common/llvm-dis.md @@ -1,6 +1,6 @@ # llvm-dis -> Converts LLVM bitcode files into human-readable LLVM Intermediate Representation (IR). +> Convert LLVM bitcode files into human-readable LLVM Intermediate Representation (IR). > More information: . - Convert a bitcode file as LLVM IR and write the result to `stdout`: diff --git a/pages/common/lmms.md b/pages/common/lmms.md index e67319055..f016a0189 100644 --- a/pages/common/lmms.md +++ b/pages/common/lmms.md @@ -2,6 +2,7 @@ > Free, open source, cross-platform digital audio workstation. > Render a `.mmp` or `.mmpz` project file, dump a `.mmpz` as XML, or start the GUI. +> See also: `mixxx`. > More information: . - Start the GUI: diff --git a/pages/common/ln.md b/pages/common/ln.md index 8f4a820fb..4bb580e76 100644 --- a/pages/common/ln.md +++ b/pages/common/ln.md @@ -1,6 +1,6 @@ # ln -> Creates links to files and directories. +> Create links to files and directories. > More information: . - Create a symbolic link to a file or directory: diff --git a/pages/common/lsar.md b/pages/common/lsar.md new file mode 100644 index 000000000..aeef76ce6 --- /dev/null +++ b/pages/common/lsar.md @@ -0,0 +1,29 @@ +# lsar + +> List an archive file's contents. +> See also: `unar`, `ar`. +> More information: . + +- List an archive file's contents: + +`lsar {{path/to/archive}}` + +- List a password protected archive file's contents: + +`lsar {{path/to/archive}} --password {{password}}` + +- Print al[L] available information about each file in the archive (it's very long): + +`lsar {{-L|--verylong}} {{path/to/archive}}` + +- Test the integrity of the files in the archive (if possible): + +`lsar --test {{path/to/archive}}` + +- List the archive file's contents in JSON format: + +`lsar --json {{path/to/archive}}` + +- Display help: + +`lsar --help` diff --git a/pages/common/lstopo.md b/pages/common/lstopo.md new file mode 100644 index 000000000..47bed6d30 --- /dev/null +++ b/pages/common/lstopo.md @@ -0,0 +1,24 @@ +# lstopo + +> Show the hardware topology of the system. +> More information: . + +- Show the summarized system topology in a graphical window (or print to console if no graphical display is available): + +`lstopo` + +- Show the full system topology without summarizations: + +`lstopo --no-factorize` + +- Show the summarized system topology with only [p]hysical indices (i.e. as seen by the OS): + +`lstopo --physical` + +- Write the full system topology to a file in the specified format: + +`lstopo --no-factorize --output-format {{console|ascii|tex|fig|svg|pdf|ps|png|xml}} {{path/to/file}}` + +- Output in monochrome or greyscale: + +`lstopo --palette {{none|grey}}` diff --git a/pages/common/magick-compare.md b/pages/common/magick-compare.md new file mode 100644 index 000000000..2b8f22238 --- /dev/null +++ b/pages/common/magick-compare.md @@ -0,0 +1,13 @@ +# magick compare + +> Create a comparison image to visually annotate the difference between two images. +> See also: `magick`. +> More information: . + +- Compare two images: + +`magick compare {{path/to/image1.png}} {{path/to/image2.png}} {{path/to/diff.png}}` + +- Compare two images using the specified metric: + +`magick compare -verbose -metric {{PSNR}} {{path/to/image1.png}} {{path/to/image2.png}} {{path/to/diff.png}}` diff --git a/pages/common/magick-convert.md b/pages/common/magick-convert.md new file mode 100644 index 000000000..cf85d66e3 --- /dev/null +++ b/pages/common/magick-convert.md @@ -0,0 +1,37 @@ +# magick convert + +> Convert between image formats, scale, join, and create images, and much more. +> Note: this tool (previously `convert`) has been replaced by `magick` in ImageMagick 7+. +> More information: . + +- Convert an image from JPEG to PNG: + +`magick convert {{path/to/input_image.jpg}} {{path/to/output_image.png}}` + +- Scale an image to 50% of its original size: + +`magick convert {{path/to/input_image.png}} -resize 50% {{path/to/output_image.png}}` + +- Scale an image keeping the original aspect ratio to a maximum dimension of 640x480: + +`magick convert {{path/to/input_image.png}} -resize 640x480 {{path/to/output_image.png}}` + +- Scale an image to have a specified file size: + +`magick convert {{path/to/input_image.png}} -define jpeg:extent=512kb {{path/to/output_image.jpg}}` + +- Vertically/horizontally append images: + +`magick convert {{path/to/image1.png path/to/image2.png ...}} {{-append|+append}} {{path/to/output_image.png}}` + +- Create a GIF from a series of images with 100ms delay between them: + +`magick convert {{path/to/image1.png path/to/image2.png ...}} -delay {{10}} {{path/to/animation.gif}}` + +- Create an image with nothing but a solid red background: + +`magick convert -size {{800x600}} "xc:{{#ff0000}}" {{path/to/image.png}}` + +- Create a favicon from several images of different sizes: + +`magick convert {{path/to/image1.png path/to/image2.png ...}} {{path/to/favicon.ico}}` diff --git a/pages/common/magick-identify.md b/pages/common/magick-identify.md new file mode 100644 index 000000000..f9cd7aadc --- /dev/null +++ b/pages/common/magick-identify.md @@ -0,0 +1,17 @@ +# magick identify + +> Describe the format and characteristics of image files. +> See also: `magick`. +> More information: . + +- Describe the format and basic characteristics of an image: + +`magick identify {{path/to/image}}` + +- Describe the format and verbose characteristics of an image: + +`magick identify -verbose {{path/to/image}}` + +- Collect dimensions of all JPEG files in the current directory and save them into a CSV file: + +`magick identify -format "{{%f,%w,%h\n}}" {{*.jpg}} > {{path/to/filelist.csv}}` diff --git a/pages/common/magick-import.md b/pages/common/magick-import.md new file mode 100644 index 000000000..6ad245c1d --- /dev/null +++ b/pages/common/magick-import.md @@ -0,0 +1,17 @@ +# magick import + +> Capture some or all of an X server screen and save the image to a file. +> See also: `magick`. +> More information: . + +- Capture the entire X server screen into a PostScript file: + +`magick import -window root {{path/to/output.ps}}` + +- Capture contents of a remote X server screen into a PNG image: + +`magick import -window root -display {{remote_host}}:{{screen}}.{{display}} {{path/to/output.png}}` + +- Capture a specific window given its ID as displayed by `xwininfo` into a JPEG image: + +`magick import -window {{window_id}} {{path/to/output.jpg}}` diff --git a/pages/common/magick-mogrify.md b/pages/common/magick-mogrify.md new file mode 100644 index 000000000..547261d24 --- /dev/null +++ b/pages/common/magick-mogrify.md @@ -0,0 +1,26 @@ +# magick mogrify + +> Perform operations on multiple images, such as resizing, cropping, flipping, and adding effects. +> Changes are applied directly to the original file. +> See also: `magick`. +> More information: . + +- Resize all JPEG images in the directory to 50% of their initial size: + +`magick mogrify -resize {{50%}} {{*.jpg}}` + +- Resize all images starting with `DSC` to 800x600: + +`magick mogrify -resize {{800x600}} {{DSC*}}` + +- Convert all PNGs in the directory to JPEG: + +`magick mogrify -format {{jpg}} {{*.png}}` + +- Halve the saturation of all image files in the current directory: + +`magick mogrify -modulate {{100,50}} {{*}}` + +- Double the brightness of all image files in the current directory: + +`magick mogrify -modulate {{200}} {{*}}` diff --git a/pages/common/magick-montage.md b/pages/common/magick-montage.md new file mode 100644 index 000000000..9941a63da --- /dev/null +++ b/pages/common/magick-montage.md @@ -0,0 +1,25 @@ +# magick montage + +> Tile images into a customizable grid. +> See also: `magick`. +> More information: . + +- Tile images into a grid, automatically resizing images larger than the grid cell size: + +`magick montage {{path/to/image1.jpg path/to/image2.jpg ...}} {{path/to/montage.jpg}}` + +- Tile images into a grid, automatically calculating the grid cell size from the largest image: + +`magick montage {{path/to/image1.jpg path/to/image2.jpg ...}} -geometry {{+0+0}} {{path/to/montage.jpg}}` + +- Specify the grid cell size and resize images to fit it before tiling: + +`magick montage {{path/to/image1.jpg path/to/image2.jpg ...}} -geometry {{640x480+0+0}} {{path/to/montage.jpg}}` + +- Limit the number of rows and columns in the grid, causing input images to overflow into multiple output montages: + +`magick montage {{path/to/image1.jpg path/to/image2.jpg ...}} -geometry {{+0+0}} -tile {{2x3}} {{montage_%d.jpg}}` + +- Resize and crop images to fill their grid cells before tiling: + +`magick montage {{path/to/image1.jpg path/to/image2.jpg ...}} -geometry {{+0+0}} -resize {{640x480^}} -gravity {{center}} -crop {{640x480+0+0}} {{path/to/montage.jpg}}` diff --git a/pages/common/magick.md b/pages/common/magick.md index 48d7df4a7..2cc33e865 100644 --- a/pages/common/magick.md +++ b/pages/common/magick.md @@ -1,8 +1,9 @@ # magick > Create, edit, compose, or convert between image formats. -> ImageMagick version 7+. See `convert` for versions 6 and below. -> More information: . +> This tool replaces `convert` in ImageMagick 7+. See `magick convert` to use the old tool in versions 7+. +> Some subcommands, such as `mogrify` have their own usage documentation. +> More information: . - Convert between image formats: @@ -12,7 +13,7 @@ `magick {{path/to/input_image.jpg}} -resize {{100x100}} {{path/to/output_image.jpg}}` -- Create a GIF out of all JPG images in the current directory: +- Create a GIF out of all JPEG images in the current directory: `magick {{*.jpg}} {{path/to/images.gif}}` @@ -20,6 +21,6 @@ `magick -size {{640x480}} pattern:checkerboard {{path/to/checkerboard.png}}` -- Create a PDF file out of all JPG images in the current directory: +- Create a PDF file out of all JPEG images in the current directory: `magick {{*.jpg}} -adjoin {{path/to/file.pdf}}` diff --git a/pages/common/man.md b/pages/common/man.md index 55c1bf346..b85f0bf0b 100644 --- a/pages/common/man.md +++ b/pages/common/man.md @@ -1,7 +1,7 @@ # man > Format and display manual pages. -> More information: . +> More information: . - Display the man page for a command: diff --git a/pages/common/masscan.md b/pages/common/masscan.md index 8027a1a88..d8aa33353 100644 --- a/pages/common/masscan.md +++ b/pages/common/masscan.md @@ -4,7 +4,7 @@ > Best run with elevated privileges. Nmap compatibility run `masscan --nmap` to find out more. > More information: . -- Scan an IP or network subnet for port 80: +- Scan an IP or network subnet for [p]ort 80: `masscan {{ip_address|network_prefix}} --ports {{80}}` @@ -16,10 +16,18 @@ `masscan {{10.0.0.0/16}} --top-ports {{100}} --excludefile {{path/to/file}}` -- Scan the Internet for port 443: +- Scan the Internet for web servers running on port 80 and 443: -`masscan {{0.0.0.0/0}} --ports {{443}} --rate {{10000000}}` +`masscan {{0.0.0.0/0}} --ports {{80,443}} --rate {{10000000}}` + +- Scan the Internet for DNS servers running on UDP port 53: + +`masscan {{0.0.0.0/0}} --ports {{U:53}} --rate {{10000000}}` - Scan the Internet for a specific port range and export to a file: -`masscan {{0.0.0.0/0}} --ports {{0-65535}} -output-format {{binary|grepable|json|list|xml}} --output-filename {{path/to/file}}` +`masscan {{0.0.0.0/0}} --ports {{0-65535}} --output-format {{binary|grepable|json|list|xml}} --output-filename {{path/to/file}}` + +- Read binary scan results from a file and output to `stdout`: + +`masscan --readscan {{path/to/file}}` diff --git a/pages/common/mc.md b/pages/common/mc.md index cbef05299..71bd2cf19 100644 --- a/pages/common/mc.md +++ b/pages/common/mc.md @@ -1,7 +1,8 @@ # mc -> Midnight Commander, a terminal based file manager. +> Midnight Commander, a TUI file manager. > Navigate the directory structure using the arrow keys, the mouse or by typing the commands into the terminal. +> See also: `ranger`, `clifm`, `vifm`, `nautilus`. > More information: . - Start Midnight Commander: diff --git a/pages/common/md-to-clip.md b/pages/common/md-to-clip.md index 887062d94..641c71d5b 100644 --- a/pages/common/md-to-clip.md +++ b/pages/common/md-to-clip.md @@ -1,6 +1,6 @@ # md-to-clip -> Converter from tldr-pages to Command Line Interface Pages. +> Convert tldr-pages to Command Line Interface Pages. > See also: `clip-view`. > More information: . diff --git a/pages/linux/medusa.md b/pages/common/medusa.md similarity index 92% rename from pages/linux/medusa.md rename to pages/common/medusa.md index 8ac906ccb..83150bde0 100644 --- a/pages/linux/medusa.md +++ b/pages/common/medusa.md @@ -1,7 +1,7 @@ # Medusa > A modular and parallel login brute-forcer for a variety of protocols. -> More information: . +> More information: . - Execute brute force against an FTP server using a file containing usernames and a file containing passwords: diff --git a/pages/common/mixxx.md b/pages/common/mixxx.md index f84079705..086e4f050 100644 --- a/pages/common/mixxx.md +++ b/pages/common/mixxx.md @@ -1,6 +1,7 @@ # mixxx > Free and open source cross-platform DJ software. +> See also: `lmms`. > More information: . - Start the Mixxx GUI in fullscreen: diff --git a/pages/common/mkfifo.md b/pages/common/mkfifo.md index 0769e62b7..87a580051 100644 --- a/pages/common/mkfifo.md +++ b/pages/common/mkfifo.md @@ -1,6 +1,6 @@ # mkfifo -> Makes FIFOs (named pipes). +> Make FIFOs (named pipes). > More information: . - Create a named pipe at a given path: diff --git a/pages/common/mods.md b/pages/common/mods.md index f1f9f48b9..4789c8082 100644 --- a/pages/common/mods.md +++ b/pages/common/mods.md @@ -1,6 +1,6 @@ # mods -> AI for the command line, built for pipelines. +> AI for the command-line, built for pipelines. > More information: . - Ask a generic question: diff --git a/pages/common/mogrify.md b/pages/common/mogrify.md index b43a240ae..b06b41622 100644 --- a/pages/common/mogrify.md +++ b/pages/common/mogrify.md @@ -1,25 +1,7 @@ # mogrify -> Perform operations on multiple images, such as resizing, cropping, flipping, and adding effects. -> Changes are applied directly to the original file. Part of ImageMagick. -> More information: . +> This command is an alias of `magick mogrify`. -- Resize all JPEG images in the directory to 50% of their initial size: +- View documentation for the original command: -`mogrify -resize {{50%}} {{*.jpg}}` - -- Resize all images starting with `DSC` to 800x600: - -`mogrify -resize {{800x600}} {{DSC*}}` - -- Convert all PNGs in the directory to JPEG: - -`mogrify -format {{jpg}} {{*.png}}` - -- Halve the saturation of all image files in the current directory: - -`mogrify -modulate {{100,50}} {{*}}` - -- Double the brightness of all image files in the current directory: - -`mogrify -modulate {{200}} {{*}}` +`tldr magick mogrify` diff --git a/pages/common/montage.md b/pages/common/montage.md index f46887774..12bd082e8 100644 --- a/pages/common/montage.md +++ b/pages/common/montage.md @@ -1,25 +1,7 @@ # montage -> Tiles images into a customizable grid. -> Part of ImageMagick. -> More information: . +> This command is an alias of `magick montage`. -- Tile images into a grid, automatically resizing images larger than the grid cell size: +- View documentation for the original command: -`montage {{path/to/image1.jpg path/to/image2.jpg ...}} {{path/to/montage.jpg}}` - -- Tile images into a grid, automatically calculating the grid cell size from the largest image: - -`montage {{path/to/image1.jpg path/to/image2.jpg ...}} -geometry {{+0+0}} {{path/to/montage.jpg}}` - -- Specify the grid cell size and resize images to fit it before tiling: - -`montage {{path/to/image1.jpg path/to/image2.jpg ...}} -geometry {{640x480+0+0}} {{path/to/montage.jpg}}` - -- Limit the number of rows and columns in the grid, causing input images to overflow into multiple output montages: - -`montage {{path/to/image1.jpg path/to/image2.jpg ...}} -geometry {{+0+0}} -tile {{2x3}} {{montage_%d.jpg}}` - -- Resize and crop images to fill their grid cells before tiling: - -`montage {{path/to/image1.jpg path/to/image2.jpg ...}} -geometry {{+0+0}} -resize {{640x480^}} -gravity {{center}} -crop {{640x480+0+0}} {{path/to/montage.jpg}}` +`tldr magick montage` diff --git a/pages/common/more.md b/pages/common/more.md index dfddf3a57..14ad53b9b 100644 --- a/pages/common/more.md +++ b/pages/common/more.md @@ -8,10 +8,6 @@ `more {{path/to/file}}` -- Search case-[i]nsensitively when pressing "/": - -`more -i {{path/to/file}}` - - Display a specific line: `more +{{line_number}} {{path/to/file}}` diff --git a/pages/common/mount.md b/pages/common/mount.md index fce9c6f4c..54133d650 100644 --- a/pages/common/mount.md +++ b/pages/common/mount.md @@ -1,6 +1,6 @@ # mount -> Provides access to an entire filesystem in one directory. +> Get access to an entire filesystem in one directory. > More information: . - Show all mounted filesystems: diff --git a/pages/common/mpc.md b/pages/common/mpc.md index 475e2e30b..3fda3ac50 100644 --- a/pages/common/mpc.md +++ b/pages/common/mpc.md @@ -1,7 +1,7 @@ # mpc -> Music Player Client. -> Control the Music Player Daemon (MPD). +> Music Player Client: control the Music Player Daemon (MPD). +> See also: `mpd`, `ncmpcpp`, `cmus`. > More information: . - Toggle play/pause: diff --git a/pages/common/mpd.md b/pages/common/mpd.md index a5056beb1..6a21169ae 100644 --- a/pages/common/mpd.md +++ b/pages/common/mpd.md @@ -1,6 +1,7 @@ # mpd > Music Player Daemon. +> See also: `mpc`, `ncmpcpp`. > More information: . - Start MPD: diff --git a/pages/common/mpv.md b/pages/common/mpv.md index e4551eb9d..344608b73 100644 --- a/pages/common/mpv.md +++ b/pages/common/mpv.md @@ -1,6 +1,7 @@ # mpv > A audio/video player based on MPlayer. +> See also: `mplayer`, `vlc`. > More information: . - Play a video or audio from a URL or file: @@ -25,7 +26,7 @@ - Play a file at a specified speed (1 by default): -`mpv --speed {{0.01..100}} {{path/to/file}}` +`mpv --speed={{0.01..100}} {{path/to/file}}` - Play a file using a profile defined in the `mpv.conf` file: @@ -33,4 +34,4 @@ - Display the output of webcam or other video input device: -`mpv /dev/{{video0}}` +`mpv {{/dev/video0}}` diff --git a/pages/common/msfvenom.md b/pages/common/msfvenom.md index 455358176..91b34ce37 100644 --- a/pages/common/msfvenom.md +++ b/pages/common/msfvenom.md @@ -23,6 +23,6 @@ `msfvenom -p windows/x64/meterpreter/reverse_tcp LHOST={{local_ip}} LPORT={{local_port}} -f exe -o {{path/to/binary.exe}}` -- Create a raw bash with a reverse TCP handler: +- Create a raw Bash with a reverse TCP handler: `msfvenom -p cmd/unix/reverse_bash LHOST={{local_ip}} LPORT={{local_port}} -f raw` diff --git a/pages/common/musescore.md b/pages/common/musescore.md index 79341cd75..c55c7e96e 100644 --- a/pages/common/musescore.md +++ b/pages/common/musescore.md @@ -1,6 +1,7 @@ # musescore > MuseScore 3 sheet music editor. +> See also: `lilypond`. > More information: . - Use a specific audio driver: diff --git a/pages/common/mypy.md b/pages/common/mypy.md new file mode 100644 index 000000000..9568bec40 --- /dev/null +++ b/pages/common/mypy.md @@ -0,0 +1,36 @@ +# mypy + +> Type check Python code. +> More information: . + +- Type check a specific file: + +`mypy {{path/to/file.py}}` + +- Type check a specific [m]odule: + +`mypy -m {{module_name}}` + +- Type check a specific [p]ackage: + +`mypy -p {{package_name}}` + +- Type check a string of code: + +`mypy -c "{{code}}"` + +- Ignore missing imports: + +`mypy --ignore-missing-imports {{path/to/file_or_directory}}` + +- Show detailed error messages: + +`mypy --show-traceback {{path/to/file_or_directory}}` + +- Specify a custom configuration file: + +`mypy --config-file {{path/to/config_file}}` + +- Display [h]elp: + +`mypy -h` diff --git a/pages/common/nc.md b/pages/common/nc.md index b7425db27..60127b6cb 100644 --- a/pages/common/nc.md +++ b/pages/common/nc.md @@ -1,7 +1,7 @@ # nc -> A versatile utility for redirecting IO into a network stream. -> More information: . +> Redirect I/O into a network stream through this versatile tool. +> More information: . - Start a listener on the specified TCP port and send a file into it: diff --git a/pages/common/ncmpcpp.md b/pages/common/ncmpcpp.md index c01fff4e9..c4e7e2ae6 100644 --- a/pages/common/ncmpcpp.md +++ b/pages/common/ncmpcpp.md @@ -1,6 +1,7 @@ # ncmpcpp > A music player client for the Music Player Daemon. +> See also: `mpd`, `mpc`, `qmmp`, `termusic`. > More information: . - Connect to a music player daemon on a given host and port: diff --git a/pages/common/neato.md b/pages/common/neato.md index 03e3c3523..0cfe0c0e4 100644 --- a/pages/common/neato.md +++ b/pages/common/neato.md @@ -4,19 +4,19 @@ > Layouts: `dot`, `neato`, `twopi`, `circo`, `fdp`, `sfdp`, `osage` & `patchwork`. > More information: . -- Render a `png` image with a filename based on the input filename and output format (uppercase -O): +- Render a PNG image with a filename based on the input filename and output format (uppercase -O): `neato -T {{png}} -O {{path/to/input.gv}}` -- Render a `svg` image with the specified output filename (lowercase -o): +- Render a SVG image with the specified output filename (lowercase -o): `neato -T {{svg}} -o {{path/to/image.svg}} {{path/to/input.gv}}` -- Render the output in `ps`, `pdf`, `svg`, `fig`, `png`, `gif`, `jpg`, `json`, or `dot` format: +- Render the output in PS, PDF, SVG, Fig, PNG, GIF, JPEG, JSON, or DOT format: `neato -T {{format}} -O {{path/to/input.gv}}` -- Render a `gif` image using `stdin` and `stdout`: +- Render a GIF image using `stdin` and `stdout`: `echo "{{graph {this -- that} }}" | neato -T {{gif}} > {{path/to/image.gif}}` diff --git a/pages/common/ned.md b/pages/common/ned.md index b2366db05..6cd046b9f 100644 --- a/pages/common/ned.md +++ b/pages/common/ned.md @@ -1,6 +1,6 @@ # ned -> Is like `grep` but with powerful replace capabilities. +> Like `grep` but with powerful replace capabilities. > Unlike `sed`, as it isn't restricted to line oriented editing. > More information: . diff --git a/pages/common/neo4j-admin.md b/pages/common/neo4j-admin.md new file mode 100644 index 000000000..310b7ccb6 --- /dev/null +++ b/pages/common/neo4j-admin.md @@ -0,0 +1,33 @@ +# neo4j-admin + +> Manage and administer a Neo4j DBMS (Database Management System). +> See also: `cypher-shell`, `mysqld`. +> More information: . + +- Start the DBMS: + +`neo4j-admin server start` + +- Stop the DBMS: + +`neo4j-admin server stop` + +- Set the initial password of the default `neo4j` user (prerequisite for the first start of the DBMS): + +`neo4j-admin dbms set-initial-password {{database_name}}` + +- Create an archive (dump) of an offline database to a file named `database_name.dump`: + +`neo4j-admin database dump --to-path={{path/to/directory}} {{database_name}}` + +- Load a database from an archive named `database_name.dump`: + +`neo4j-admin database load --from-path={{path/to/directory}} {{database_name}} --overwrite-destination=true` + +- Load a database from a specified archive file through `stdin`: + +`neo4j-admin database load --from-stdin {{database_name}} --overwrite-destination=true < {{path/to/filename.dump}}` + +- Display help: + +`neo4j-admin --help` diff --git a/pages/common/netstat.md b/pages/common/netstat.md index 0a5500842..ac26c7dfc 100644 --- a/pages/common/netstat.md +++ b/pages/common/netstat.md @@ -1,7 +1,7 @@ # netstat -> Displays network-related information such as open connections, open socket ports, etc. -> More information: . +> Display network-related information such as open connections, open socket ports, etc. +> More information: . - List all ports: diff --git a/pages/common/nf-core.md b/pages/common/nf-core.md index 4517396da..12abca81f 100644 --- a/pages/common/nf-core.md +++ b/pages/common/nf-core.md @@ -1,7 +1,7 @@ # nf-core > The nf-core framework tools, to create, check and develop best-practice guidelines for Nextflow. -> More information: . +> More information: . - List existing pipelines on nf-core: diff --git a/pages/common/nix-build.md b/pages/common/nix-build.md index 760061f44..27493ebe8 100644 --- a/pages/common/nix-build.md +++ b/pages/common/nix-build.md @@ -1,7 +1,7 @@ # nix-build > Build a Nix expression. -> See also: `tldr nix3 build`. +> See also: `nix3 build`. > More information: . - Build a Nix expression: diff --git a/pages/common/nix-shell.md b/pages/common/nix-shell.md index 12d4be4d0..f445c7e73 100644 --- a/pages/common/nix-shell.md +++ b/pages/common/nix-shell.md @@ -1,7 +1,7 @@ # nix-shell > Start an interactive shell based on a Nix expression. -> See also: `tldr nix3 shell`. +> See also: `nix3 shell`. > More information: . - Start with nix expression in `shell.nix` or `default.nix` in the current directory: diff --git a/pages/common/nix-store.md b/pages/common/nix-store.md index 9bc8bbb5d..111319e99 100644 --- a/pages/common/nix-store.md +++ b/pages/common/nix-store.md @@ -1,7 +1,7 @@ # nix-store > Manipulate or query the Nix store. -> See also: `tldr nix3 store`. +> See also: `nix3 store`. > More information: . - Collect garbage, such as removing unused paths: diff --git a/pages/common/nix3-build.md b/pages/common/nix3-build.md index a3b3e10a6..957fee2d0 100644 --- a/pages/common/nix3-build.md +++ b/pages/common/nix3-build.md @@ -1,7 +1,7 @@ # nix build > Build a Nix expression (downloading from the cache when possible). -> See also: `tldr nix-build`. See `tldr nix3 flake` for information about flakes. +> See also: `nix-build` for information about traditional Nix builds from expressions, `nix3 flake` for information about flakes. > More information: . - Build a package from nixpkgs, symlinking the result to `./result`: diff --git a/pages/common/nix3-registry.md b/pages/common/nix3-registry.md index d516b0282..3ce75b28b 100644 --- a/pages/common/nix3-registry.md +++ b/pages/common/nix3-registry.md @@ -1,18 +1,18 @@ # nix registry > Manage a Nix flake registry. -> See `tldr nix3 flake` for information about flakes. +> See also: `nix3 flake` for information about flakes. > More information: . - Pin the `nixpkgs` revision to the current version of the upstream repository: `nix registry pin {{nixpkgs}}` -- Pin an entry to the latest version of the branch, or a particular reivision of a github repository: +- Pin an entry to the latest version of the branch, or a particular reivision of a GitHub repository: `nix registry pin {{entry}} {{github:owner/repo/branch_or_revision}}` -- Add a new entry that always points to the latest version of a github repository, updating automatically: +- Add a new entry that always points to the latest version of a GitHub repository, updating automatically: `nix registry add {{entry}} {{github:owner/repo}}` diff --git a/pages/common/nix3-run.md b/pages/common/nix3-run.md index cdc7cf8cc..c63f9bece 100644 --- a/pages/common/nix3-run.md +++ b/pages/common/nix3-run.md @@ -1,7 +1,7 @@ # nix run > Run an application from a Nix flake. -> See `tldr nix3 flake` for information about flakes. +> See also: `nix3 flake` for information about flakes. > More information: . - Run the default application in the flake in the current directory: diff --git a/pages/common/nix3-search.md b/pages/common/nix3-search.md index ecbe44152..d9f1c9c26 100644 --- a/pages/common/nix3-search.md +++ b/pages/common/nix3-search.md @@ -1,7 +1,7 @@ # nix search > Search for packages in a Nix flake. -> See `tldr nix3 flake` for information about flakes. +> See also: `nix3 flake` for information about flakes. > More information: . - Search `nixpkgs` for a package based on its name or description: diff --git a/pages/common/nix3-shell.md b/pages/common/nix3-shell.md index c82753f60..29e046a40 100644 --- a/pages/common/nix3-shell.md +++ b/pages/common/nix3-shell.md @@ -1,7 +1,7 @@ # nix shell > Start a shell in which the specified packages are available. -> See also: `tldr nix-shell`. See `tldr nix3 flake` for information about flakes. +> See also: `nix-shell` for setting up development environments, `nix3 flake` for information about flakes. > More information: . - Start an interactive shell with some packages from `nixpkgs`: diff --git a/pages/common/nix3-store.md b/pages/common/nix3-store.md index 1cff469d2..bad804585 100644 --- a/pages/common/nix3-store.md +++ b/pages/common/nix3-store.md @@ -1,7 +1,7 @@ # nix store > Manipulate the Nix store. -> See also: `tldr nix-store`. +> See also: `nix-store`. > More information: . - Collect garbage, i.e. remove unused paths to reduce space usage: diff --git a/pages/common/nkf.md b/pages/common/nkf.md index 817e0f1dc..bff2c46b3 100644 --- a/pages/common/nkf.md +++ b/pages/common/nkf.md @@ -1,7 +1,6 @@ # nkf -> Network kanji filter. -> Converts kanji code from one encoding to another. +> Network kanji filter: convert kanji code from one encoding to another. > More information: . - Convert to UTF-8 encoding: diff --git a/pages/common/noti.md b/pages/common/noti.md index 829da3300..01fe859ad 100644 --- a/pages/common/noti.md +++ b/pages/common/noti.md @@ -3,7 +3,7 @@ > Monitor a process and trigger a banner notification. > More information: . -- Display a notification when `tar` finishes compressing files: +- Display a notification when tar finishes compressing files: `noti {{tar -cjf example.tar.bz2 example/}}` diff --git a/pages/common/nvm.fish.md b/pages/common/nvm.fish.md index 2d7d37da8..fad67c40c 100644 --- a/pages/common/nvm.fish.md +++ b/pages/common/nvm.fish.md @@ -1,6 +1,6 @@ # nvm -> Install, uninstall, or switch between Node.js versions under the `fish` shell. +> Install, uninstall, or switch between Node.js versions under the fish shell. > Supports version numbers like "12.8" or "v16.13.1", and labels like "stable", "system", etc. > More information: . diff --git a/pages/common/ollama.md b/pages/common/ollama.md index acede9871..311c6320b 100644 --- a/pages/common/ollama.md +++ b/pages/common/ollama.md @@ -1,7 +1,7 @@ # ollama > A large language model runner. -> More information: . +> More information: . - Start the daemon required to run other commands: @@ -19,10 +19,18 @@ `ollama list` +- Pull/Update a specific model: + +`ollama pull {{model}}` + +- Upgrade Ollama on Linux: + +`curl -fsSL https://ollama.com/install.sh | sh` + - Delete a model: `ollama rm {{model}}` -- Create a model from a `Modelfile`: +- Create a model from a `Modelfile` ([f]): `ollama create {{new_model_name}} -f {{path/to/Modelfile}}` diff --git a/pages/common/open.fish.md b/pages/common/open.fish.md index 5ae4dabc8..4a2b14d6d 100644 --- a/pages/common/open.fish.md +++ b/pages/common/open.fish.md @@ -1,7 +1,7 @@ # open > Opens files, directories, and URIs with default applications. -> This command is available through `fish` on operating systems without the built-in `open` command (e.g. Haiku and macOS). +> This command is available through fish on operating systems without the built-in `open` command (e.g. Haiku and macOS). > More information: . - Open a file with the associated application: diff --git a/pages/common/open.md b/pages/common/open.md index d1339436f..75d9eb9ee 100644 --- a/pages/common/open.md +++ b/pages/common/open.md @@ -6,6 +6,6 @@ `tldr open -p osx` -- View documentation for the command available through `fish`: +- View documentation for the command available through fish: `tldr open.fish` diff --git a/pages/common/osage.md b/pages/common/osage.md index a198b62f6..b63993bab 100644 --- a/pages/common/osage.md +++ b/pages/common/osage.md @@ -4,19 +4,19 @@ > Layouts: `dot`, `neato`, `twopi`, `circo`, `fdp`, `sfdp`, `osage` & `patchwork`. > More information: . -- Render a `png` image with a filename based on the input filename and output format (uppercase -O): +- Render a PNG image with a filename based on the input filename and output format (uppercase -O): `osage -T {{png}} -O {{path/to/input.gv}}` -- Render a `svg` image with the specified output filename (lowercase -o): +- Render a SVG image with the specified output filename (lowercase -o): `osage -T {{svg}} -o {{path/to/image.svg}} {{path/to/input.gv}}` -- Render the output in `ps`, `pdf`, `svg`, `fig`, `png`, `gif`, `jpg`, `json`, or `dot` format: +- Render the output in PS, PDF, SVG, Fig, PNG, GIF, JPEG, JSON, or DOT format: `osage -T {{format}} -O {{path/to/input.gv}}` -- Render a `gif` image using `stdin` and `stdout`: +- Render a GIF image using `stdin` and `stdout`: `echo "{{digraph {this -> that} }}" | osage -T {{gif}} > {{path/to/image.gif}}` diff --git a/pages/common/osv-scanner.md b/pages/common/osv-scanner.md index a532775f2..5a1c6c0a1 100644 --- a/pages/common/osv-scanner.md +++ b/pages/common/osv-scanner.md @@ -3,7 +3,7 @@ > Scan various mediums for dependencies and matches them against the OSV database. > More information: . -- Scan a docker image: +- Scan a Docker image: `osv-scanner -D {{docker_image_name}}` diff --git a/pages/common/packwiz.md b/pages/common/packwiz.md index 3758082f8..3a9cefb08 100644 --- a/pages/common/packwiz.md +++ b/pages/common/packwiz.md @@ -19,6 +19,6 @@ `packwiz refresh` -- Export as a Modrinth (`.mrpack`) or Curseforge (`.zip`) file: +- Export as a Modrinth (`.mrpack`) or Curseforge (Zip) file: `packwiz {{modrinth|curseforge}} export` diff --git a/pages/common/pactl.md b/pages/common/pactl.md index 2ee0e3657..136e7a478 100644 --- a/pages/common/pactl.md +++ b/pages/common/pactl.md @@ -3,6 +3,10 @@ > Control a running PulseAudio sound server. > More information: . +- Show information about the sound server: + +`pactl info` + - List all sinks (or other types - sinks are outputs and sink-inputs are active audio streams): `pactl list {{sinks}} short` diff --git a/pages/common/pamfix.md b/pages/common/pamfix.md new file mode 100644 index 000000000..d42cee8a9 --- /dev/null +++ b/pages/common/pamfix.md @@ -0,0 +1,17 @@ +# pamfix + +> Fix errors in PAM, PBM, PGM and PPM files. +> See also: `pamfile`, `pamvalidate`. +> More information: . + +- Fix a Netpbm file that is missing its last part: + +`pamfix -truncate {{path/to/corrupted.ext}} > {{path/to/output.ext}}` + +- Fix a Netpbm file where pixel values exceed the image's `maxval` by lowering the offending pixels' values: + +`pamfix -clip {{path/to/corrupted.ext}} > {{path/to/output.ext}}` + +- Fix a Netpbm file where pixel values exceed the image's `maxval` by increasing it: + +`pamfix -changemaxval {{path/to/corrupted.pam|pbm|pgm|ppm}} > {{path/to/output.pam|pbm|pgm|ppm}}` diff --git a/pages/common/pamfixtrunc.md b/pages/common/pamfixtrunc.md new file mode 100644 index 000000000..cd892c1ff --- /dev/null +++ b/pages/common/pamfixtrunc.md @@ -0,0 +1,8 @@ +# pamfixtrunc + +> This command is superseded by `pamfix -truncate`. +> More information: . + +- View documentation for the current command: + +`tldr pamfix` diff --git a/pages/common/pamvalidate.md b/pages/common/pamvalidate.md new file mode 100644 index 000000000..cc90a8e4d --- /dev/null +++ b/pages/common/pamvalidate.md @@ -0,0 +1,9 @@ +# pamvalidate + +> Validate PAM, PGM, PBM and PPM files. +> See also: `pamfile`, `pamfix`. +> More information: . + +- Copy a Netpbm file from `stdin` to `stdout` if and only if it valid; fail otherwise: + +`{{command}} | pamvalidate > {{path/to/output.ext}}` diff --git a/pages/common/pants.md b/pages/common/pants.md new file mode 100644 index 000000000..e1d140af2 --- /dev/null +++ b/pages/common/pants.md @@ -0,0 +1,32 @@ +# pants + +> Fast, scalable, user-friendly, open-source build and developer workflow tool. +> More information: . + +- List all targets: + +`pants list ::` + +- Run all tests: + +`pants test ::` + +- Fix, format, and lint only uncommitted files: + +`pants --changed-since=HEAD fix fmt lint` + +- Typecheck only uncommitted files and their dependents: + +`pants --changed-since=HEAD --changed-dependents=transitive check` + +- Create a distributable package for the specified target: + +`pants package {{path/to/directory:target-name}}` + +- Auto-generate BUILD file targets for new source files: + +`pants tailor ::` + +- Display help: + +`pants help` diff --git a/pages/common/par2.md b/pages/common/par2.md new file mode 100644 index 000000000..0535c782a --- /dev/null +++ b/pages/common/par2.md @@ -0,0 +1,20 @@ +# par2 + +> File verification and repair using PAR 2.0 compatible parity archives (.par2 files). +> More information: . + +- Create a parity archive with a set percentage level of redundancy: + +`par2 create -r{{1..100}} -- {{path/to/file}}` + +- Create a parity archive with a chosen number of volume files (in addition to the index file): + +`par2 create -n{{1..32768}} -- {{path/to/file}}` + +- Verify a file with a parity archive: + +`par2 verify -- {{path/to/file.par2}}` + +- Repair a file with a parity archive: + +`par2 repair -- {{path/to/file.par2}}` diff --git a/pages/common/parallel.md b/pages/common/parallel.md index 9377f35c3..352fab201 100644 --- a/pages/common/parallel.md +++ b/pages/common/parallel.md @@ -11,7 +11,7 @@ `ls *.txt | parallel -j4 gzip` -- Convert JPG images to PNG using replacement strings: +- Convert JPEG images to PNG using replacement strings: `parallel convert {} {.}.png ::: *.jpg` diff --git a/pages/common/patchwork.md b/pages/common/patchwork.md index cfe0ff360..bb2ef2c5b 100644 --- a/pages/common/patchwork.md +++ b/pages/common/patchwork.md @@ -4,15 +4,15 @@ > Layouts: `dot`, `neato`, `twopi`, `circo`, `fdp`, `sfdp`, `osage` & `patchwork`. > More information: . -- Render a `png` image with a filename based on the input filename and output format (uppercase -O): +- Render a PNG image with a filename based on the input filename and output format (uppercase -O): `patchwork -T {{png}} -O {{path/to/input.gv}}` -- Render a `svg` image with the specified output filename (lowercase -o): +- Render a SVG image with the specified output filename (lowercase -o): `patchwork -T {{svg}} -o {{path/to/image.svg}} {{path/to/input.gv}}` -- Render the output in `ps`, `pdf`, `svg`, `fig`, `png`, `gif`, `jpg`, `json`, or `dot` format: +- Render the output in PS, PDF, SVG, Fig, PNG, GIF, JPEG, JSON, or DOT format: `patchwork -T {{format}} -O {{path/to/input.gv}}` diff --git a/pages/common/pbmtopi3.md b/pages/common/pbmtopi3.md new file mode 100644 index 000000000..66d6d8d12 --- /dev/null +++ b/pages/common/pbmtopi3.md @@ -0,0 +1,9 @@ +# pbmtopi3 + +> Convert a PBM image to an Atari Degas PI3 image. +> See also: `pi3topbm`. +> More information: . + +- Convert a PBM image to an Atari Degas PI3 image: + +`pbmtopi3 {{path/to/image.pbm}} > {{path/to/atari_image.pi3}}` diff --git a/pages/common/pcapfix.md b/pages/common/pcapfix.md index 0ec6ccfea..557c21826 100644 --- a/pages/common/pcapfix.md +++ b/pages/common/pcapfix.md @@ -1,21 +1,21 @@ # pcapfix -> Repair damaged or corrupted `pcap` and `pcapng` files. +> Repair damaged or corrupted PCAP and PcapNG files. > More information: . -- Repair a `pcap`/`pcapng` file (Note: for `pcap` files, only the first 262144 bytes of each packet are scanned): +- Repair a PCAP/PCapNG file (Note: for PCAP files, only the first 262144 bytes of each packet are scanned): `pcapfix {{path/to/file.pcapng}}` -- Repair an entire `pcap` file: +- Repair an entire PCAP file: `pcapfix --deep-scan {{path/to/file.pcap}}` -- Repair a `pcap`/`pcapng` file and write the repaired file to the specified location: +- Repair a PCAP/PcapNG file and write the repaired file to the specified location: `pcapfix --outfile {{path/to/repaired.pcap}} {{path/to/file.pcap}}` -- Repair a `pcapng` file and treat it as a `pcapng` file, ignoring the automatic recognition: +- Treat the specified file as a PcapNG file, ignoring automatic recognition: `pcapfix --pcapng {{path/to/file.pcapng}}` diff --git a/pages/common/pcdovtoppm.md b/pages/common/pcdovtoppm.md index 0e9dde660..8be3fdde8 100644 --- a/pages/common/pcdovtoppm.md +++ b/pages/common/pcdovtoppm.md @@ -17,4 +17,4 @@ - Use the specified [f]ont for annotations and paint the background [w]hite: -`pcdovtoppm -a {{number}} -w {{path/to/file.pcd}} > {{path/to/output.ppm}}` +`pcdovtoppm -f {{font}} -w {{path/to/file.pcd}} > {{path/to/output.ppm}}` diff --git a/pages/common/pdftocairo.md b/pages/common/pdftocairo.md index ab0d95320..8ccf93630 100644 --- a/pages/common/pdftocairo.md +++ b/pages/common/pdftocairo.md @@ -1,6 +1,6 @@ # pdftocairo -> Converts PDF files to PNG/JPEG/TIFF/PDF/PS/EPS/SVG using cairo. +> Convert PDF files to PNG/JPEG/TIFF/PDF/PS/EPS/SVG using cairo. > More information: . - Convert a PDF file to JPEG: diff --git a/pages/common/perldoc.md b/pages/common/perldoc.md index ed7586f91..4a538001e 100644 --- a/pages/common/perldoc.md +++ b/pages/common/perldoc.md @@ -7,7 +7,7 @@ `perldoc -{{f|v|a}} {{name}}` -- Search in the the question headings of Perl FAQ: +- Search in the question headings of Perl FAQ: `perldoc -q {{regex}}` diff --git a/pages/common/pgrep.md b/pages/common/pgrep.md index a721c5087..f1ceca2c8 100644 --- a/pages/common/pgrep.md +++ b/pages/common/pgrep.md @@ -1,7 +1,7 @@ # pgrep > Find or signal processes by name. -> More information: . +> More information: . - Return PIDs of any running processes with a matching command string: diff --git a/pages/common/pi1toppm.md b/pages/common/pi1toppm.md new file mode 100644 index 000000000..468e263fe --- /dev/null +++ b/pages/common/pi1toppm.md @@ -0,0 +1,9 @@ +# pi1toppm + +> Convert an Atari Degas PI1 image to a PPM image. +> See also: `ppmtopi1`. +> More information: . + +- Convert an Atari Degas PI1 image into PPM image: + +`pi1toppm {{path/to/atari_image.pi1}} > {{path/to/image.ppm}}` diff --git a/pages/common/pi3topbm.md b/pages/common/pi3topbm.md new file mode 100644 index 000000000..d06102a2a --- /dev/null +++ b/pages/common/pi3topbm.md @@ -0,0 +1,9 @@ +# pi3topbm + +> Convert an Atari Degas PI3 image to PBM image. +> See also: `pbmtopi3`. +> More information: . + +- Convert an Atari Degas PI3 image to PBM image: + +`pi1topbm {{path/to/atari_image.pi3}} > {{path/to/output_image.pbm}}` diff --git a/pages/common/pio-system.md b/pages/common/pio-system.md index fb5879ff5..ac1ed92c6 100644 --- a/pages/common/pio-system.md +++ b/pages/common/pio-system.md @@ -3,7 +3,7 @@ > Miscellaneous system commands for PlatformIO. > More information: . -- Install shell completion for the current shell (supports Bash, Fish, Zsh and PowerShell): +- Install shell completion for the current shell (supports Bash, fish, Zsh and PowerShell): `pio system completion install` diff --git a/pages/common/pipenv.md b/pages/common/pipenv.md index 0cfebb801..5bb5735d4 100644 --- a/pages/common/pipenv.md +++ b/pages/common/pipenv.md @@ -1,7 +1,7 @@ # pipenv > Simple and unified Python development workflow. -> Manages packages and the virtual environment for a project. +> Manage packages and the virtual environment for a project. > More information: . - Create a new project: diff --git a/pages/common/pkill.md b/pages/common/pkill.md index 175a464c9..bd230985b 100644 --- a/pages/common/pkill.md +++ b/pages/common/pkill.md @@ -2,7 +2,7 @@ > Signal process by name. > Mostly used for stopping processes. -> More information: . +> More information: . - Kill all processes which match: diff --git a/pages/common/plantuml.md b/pages/common/plantuml.md index a1ca3a59e..57a444d23 100644 --- a/pages/common/plantuml.md +++ b/pages/common/plantuml.md @@ -19,6 +19,14 @@ `plantuml -o {{path/to/output}} {{diagram.puml}}` +- Render a diagram without storing the diagram's source code (Note: It's stored by default when the `-nometadata` option isn't specified): + +`plantuml -nometadata {{diagram.png}} > {{diagram.puml}}` + +- Retrieve source from a `plantuml` diagram's metadata: + +`plantuml -metadata {{diagram.png}} > {{diagram.puml}}` + - Render a diagram with the configuration file: `plantuml -config {{config.cfg}} {{diagram.puml}}` diff --git a/pages/common/pnmtojpeg.md b/pages/common/pnmtojpeg.md index b81cad648..4a3222a99 100644 --- a/pages/common/pnmtojpeg.md +++ b/pages/common/pnmtojpeg.md @@ -1,6 +1,6 @@ # pnmtojpeg -> Converts a PNM image file to the JPEG/JFIF/EXIF image format. +> Convert a PNM image file to the JPEG/JFIF/EXIF image format. > More information: . - Read a PNM image as input and produce a JPEG/JFIF/EXIF image as output: diff --git a/pages/common/pnmtopng.md b/pages/common/pnmtopng.md index 9c28ebd9f..1e06c2dc9 100644 --- a/pages/common/pnmtopng.md +++ b/pages/common/pnmtopng.md @@ -1,6 +1,6 @@ # pnmtopng -> Converts a PNM image file to PNG image format. +> Convert a PNM image file to PNG image format. > More information: . - Read a PNM image as input and produce a PNG image as output: diff --git a/pages/common/pnpx.md b/pages/common/pnpx.md index 21231ed4f..74a3bc969 100644 --- a/pages/common/pnpx.md +++ b/pages/common/pnpx.md @@ -1,7 +1,8 @@ # pnpx > Directly execute binaries from npm packages, using `pnpm` instead of `npm`. -> More information: . +> Note: This command is deprecated! Use `pnpm exec` and `pnpm dlx` instead. +> More information: . - Execute the binary from a given npm module: diff --git a/pages/common/podman-ps.md b/pages/common/podman-ps.md index 01ac8cc31..0c6818e27 100644 --- a/pages/common/podman-ps.md +++ b/pages/common/podman-ps.md @@ -3,11 +3,11 @@ > List Podman containers. > More information: . -- List currently running podman containers: +- List currently running Podman containers: `podman ps` -- List all podman containers (running and stopped): +- List all Podman containers (running and stopped): `podman ps --all` diff --git a/pages/common/ppmtopi1.md b/pages/common/ppmtopi1.md new file mode 100644 index 000000000..306eeb81a --- /dev/null +++ b/pages/common/ppmtopi1.md @@ -0,0 +1,9 @@ +# ppmtopi1 + +> Convert a PPM image to an Atari Degas PI1 image. +> See also: `pi1toppm`. +> More information: . + +- Convert a PPM image into an Atari Degas PI1 image: + +`ppmtopi1 {{path/to/image.ppm}} > {{path/to/output_image.pi1}}` diff --git a/pages/common/printf.md b/pages/common/printf.md index 845811d44..2db59558c 100644 --- a/pages/common/printf.md +++ b/pages/common/printf.md @@ -19,7 +19,7 @@ `printf "{{var1: %s\tvar2: %s\n}}" "{{$VAR1}}" "{{$VAR2}}"` -- Store a formatted message in a variable (does not work on zsh): +- Store a formatted message in a variable (does not work on Zsh): `printf -v {{myvar}} {{"This is %s = %d\n" "a year" 2016}}` diff --git a/pages/common/procs.md b/pages/common/procs.md index e22644f0d..e3bd5cd44 100644 --- a/pages/common/procs.md +++ b/pages/common/procs.md @@ -11,7 +11,7 @@ `procs --tree` -- List information about processes, if the commands which started them contain `zsh`: +- List information about processes, if the commands which started them contain Zsh: `procs {{zsh}}` diff --git a/pages/common/ps.md b/pages/common/ps.md index aef4b6d7c..33919e8ab 100644 --- a/pages/common/ps.md +++ b/pages/common/ps.md @@ -11,9 +11,9 @@ `ps auxww` -- Search for a process that matches a string: +- Search for a process that matches a string (the brackets will prevent `grep` from matching itself): -`ps aux | grep {{string}}` +`ps aux | grep {{[s]tring}}` - List all processes of the current user in extra full format: diff --git a/pages/common/ptargrep.md b/pages/common/ptargrep.md index 25826a35d..506a2773d 100644 --- a/pages/common/ptargrep.md +++ b/pages/common/ptargrep.md @@ -3,7 +3,7 @@ > Find regular expression patterns in tar archive files. > More information: . -- Search for a pattern within one or more `tar` archives: +- Search for a pattern within one or more tar archives: `ptargrep "{{search_pattern}}" {{path/to/file1 path/to/file2 ...}}` @@ -11,6 +11,6 @@ `ptargrep --basename "{{search_pattern}}" {{path/to/file}}` -- Search for a case-insensitive pattern matching within a `tar` archive: +- Search for a case-insensitive pattern matching within a tar archive: `ptargrep --ignore-case "{{search_pattern}}" {{path/to/file}}` diff --git a/pages/common/pueue-completions.md b/pages/common/pueue-completions.md index 441924cbd..9e9630db9 100644 --- a/pages/common/pueue-completions.md +++ b/pages/common/pueue-completions.md @@ -7,7 +7,7 @@ `sudo pueue completions bash {{/usr/share/bash-completion/completions/pueue.bash}}` -- Generate completions for zsh: +- Generate completions for Zsh: `sudo pueue completions zsh {{/usr/share/zsh/site-functions}}` diff --git a/pages/common/pueue-send.md b/pages/common/pueue-send.md index 5451fe820..3cce39a5a 100644 --- a/pages/common/pueue-send.md +++ b/pages/common/pueue-send.md @@ -7,6 +7,6 @@ `pueue send {{task_id}} "{{input}}"` -- Send confirmation to a task expecting y/N (e.g. apt, cp): +- Send confirmation to a task expecting y/N (e.g. APT, cp): `pueue send {{task_id}} {{y}}` diff --git a/pages/common/pup.md b/pages/common/pup.md index 551de57f0..49c3d5f2b 100644 --- a/pages/common/pup.md +++ b/pages/common/pup.md @@ -11,7 +11,7 @@ `cat {{index.html}} | pup '{{tag}}'` -- Filter HTML by id: +- Filter HTML by ID: `cat {{index.html}} | pup '{{div#id}}'` diff --git a/pages/common/pydocstyle.md b/pages/common/pydocstyle.md new file mode 100644 index 000000000..910ebdb78 --- /dev/null +++ b/pages/common/pydocstyle.md @@ -0,0 +1,32 @@ +# pydocstyle + +> Statically check Python scripts for compliance with Python docstring conventions. +> More information: . + +- Analyze a Python script or all the Python scripts in a specific directory: + +`pydocstyle {{file.py|path/to/directory}}` + +- Show an explanation of each error: + +`pydocstyle {{-e|--explain}} {{file.py|path/to/directory}}` + +- Show debug information: + +`pydocstyle {{-d|--debug}} {{file.py|path/to/directory}}` + +- Display the total number of errors: + +`pydocstyle --count {{file.py|path/to/directory}}` + +- Use a specific configuration file: + +`pydocstyle --config {{path/to/config_file}} {{file.py|path/to/directory}}` + +- Ignore one or more errors: + +`pydocstyle --ignore {{D101,D2,D107,...}} {{file.py|path/to/directory}}` + +- Check for errors from a specific convention: + +`pydocstyle --convention {{pep257|numpy|google}} {{file.py|path/to/directory}}` diff --git a/pages/common/pylint.md b/pages/common/pylint.md index c9b838e5e..450fa5c60 100644 --- a/pages/common/pylint.md +++ b/pages/common/pylint.md @@ -7,6 +7,14 @@ `pylint {{path/to/file.py}}` +- Lint a package or module (must be importable; no `.py` suffix): + +`pylint {{package_or_module}}` + +- Lint a package from a directory path (must contain an `__init__.py` file): + +`pylint {{path/to/directory}}` + - Lint a file and use a configuration file (usually named `pylintrc`): `pylint --rcfile {{path/to/pylintrc}} {{path/to/file.py}}` diff --git a/pages/common/q.md b/pages/common/q.md index 7c9855848..c14946494 100644 --- a/pages/common/q.md +++ b/pages/common/q.md @@ -1,13 +1,13 @@ # q -> Execute SQL-like queries on .csv and .tsv files. +> Execute SQL-like queries on CSV and TSV files. > More information: . -- Query `.csv` file by specifying the delimiter as ',': +- Query a CSV file by specifying the delimiter as ',': `q -d',' "SELECT * from {{path/to/file}}"` -- Query `.tsv` file: +- Query a TSV file: `q -t "SELECT * from {{path/to/file}}"` diff --git a/pages/common/qcp.md b/pages/common/qcp.md index c27807192..5e26423b4 100644 --- a/pages/common/qcp.md +++ b/pages/common/qcp.md @@ -7,7 +7,7 @@ `qcp {{source_file}}` -- Copy multiple JPG files: +- Copy multiple JPEG files: `qcp {{*.jpg}}` diff --git a/pages/common/qemu-img.md b/pages/common/qemu-img.md index c55f43a88..29b18c614 100644 --- a/pages/common/qemu-img.md +++ b/pages/common/qemu-img.md @@ -1,7 +1,7 @@ # qemu-img > Create and manipulate Quick Emulator Virtual HDD images. -> More information: . +> More information: . - Create disk image with a specific size (in gigabytes): diff --git a/pages/common/qemu.md b/pages/common/qemu.md index 8d463760d..38df98e3d 100644 --- a/pages/common/qemu.md +++ b/pages/common/qemu.md @@ -22,4 +22,4 @@ - Boot from physical device (e.g. from USB to test bootable medium): -`qemu-system-i386 -hda /dev/{{storage_device}}` +`qemu-system-i386 -hda {{/dev/storage_device}}` diff --git a/pages/common/qmmp.md b/pages/common/qmmp.md index 519566847..df638514c 100644 --- a/pages/common/qmmp.md +++ b/pages/common/qmmp.md @@ -1,6 +1,7 @@ # qmmp > An audio player with an interface similar to Winamp or XMMS. +> See also: `clementine`, `ncmpcpp`, `cmus`. > More information: . - Launch the GUI: diff --git a/pages/common/qmv.md b/pages/common/qmv.md index c9981460e..2a1d31a30 100644 --- a/pages/common/qmv.md +++ b/pages/common/qmv.md @@ -7,7 +7,7 @@ `qmv {{source_file}}` -- Move multiple JPG files: +- Move multiple JPEG files: `qmv {{*.jpg}}` diff --git a/pages/common/quarkus.md b/pages/common/quarkus.md new file mode 100644 index 000000000..f112811c6 --- /dev/null +++ b/pages/common/quarkus.md @@ -0,0 +1,36 @@ +# quarkus + +> Create Quarkus projects, manage extensions and perform essential build and development tasks. +> More information: . + +- Create a new application project in a new directory: + +`quarkus create app {{project_name}}` + +- Run the current project in live coding mode: + +`quarkus dev` + +- Run the application: + +`quarkus run` + +- Run the current project in continuous testing mode: + +`quarkus test` + +- Add one or more extensions to the current project: + +`quarkus extension add {{extension_name1 extension_name2 ...}}` + +- Build a container image using Docker: + +`quarkus image build docker` + +- Deploy the application to Kubernetes: + +`quarkus deploy kubernetes` + +- Update project: + +`quarkus update` diff --git a/pages/common/ranger.md b/pages/common/ranger.md index 917d81e95..8d8404737 100644 --- a/pages/common/ranger.md +++ b/pages/common/ranger.md @@ -1,6 +1,7 @@ # ranger > Console file manager with VI key bindings. +> See also: `clifm`, `vifm`, `mc`, `dolphin`. > More information: . - Launch ranger: diff --git a/pages/common/rarcrack.md b/pages/common/rarcrack.md index 0b12ed20e..dcfefbb64 100644 --- a/pages/common/rarcrack.md +++ b/pages/common/rarcrack.md @@ -1,6 +1,6 @@ # rarcrack -> Password cracker for `rar`, `zip` and `7z` archives. +> Password cracker for RAR, Zip and 7z archives. - Brute force the password for an archive (tries to guess the archive type): diff --git a/pages/common/rclone.md b/pages/common/rclone.md index 22f09991d..514f83abc 100644 --- a/pages/common/rclone.md +++ b/pages/common/rclone.md @@ -17,7 +17,7 @@ - Copy files changed within the past 24 hours to a remote from the local machine, asking the user to confirm each file: -`rclone copy --interactive --max-age 24h {{remote_name}}:{{path/to/directory}} {{path/to/local_directory}} ` +`rclone copy --interactive --max-age 24h {{remote_name}}:{{path/to/directory}} {{path/to/local_directory}}` - Mirror a specific file or directory (Note: Unlike copy, sync removes files from the remote if it does not exist locally): diff --git a/pages/common/rkdeveloptool.md b/pages/common/rkdeveloptool.md new file mode 100644 index 000000000..db6d13ac5 --- /dev/null +++ b/pages/common/rkdeveloptool.md @@ -0,0 +1,30 @@ +# rkdeveloptool + +> Flash, dump, and manage boot firmware for Rockchip-based computer devices. +> You will need to turn on the device into Maskrom/Bootrom mode before connecting it through USB. +> Some subcommands may require to run as root. +> More information: . + +- [l]ist all connected Rockchip-based flash [d]evices: + +`rkdeveloptool ld` + +- Initialize the device by forcing it to [d]ownload and install the [b]ootloader from the specified file: + +`rkdeveloptool db {{path/to/bootloader.bin}}` + +- [u]pdate the boot[l]oader software with a new one: + +`rkdeveloptool ul {{path/to/bootloader.bin}}` + +- Write an image to a GPT-formatted flash partition, specifying the initial storage sector (usually `0x0` alias `0`): + +`rkdeveloptool wl {{initial_sector}} {{path/to/image.img}}` + +- Write to the flash partition by its user-friendly name: + +`rkdeveloptool wlx {{partition_name}} {{path/to/image.img}}` + +- [r]eset/reboot the [d]evice, exit from the Maskrom/Bootrom mode to boot into the selected flash partition: + +`rkdeveloptool rd` diff --git a/pages/common/rsync.md b/pages/common/rsync.md index 379f742dc..6461e8183 100644 --- a/pages/common/rsync.md +++ b/pages/common/rsync.md @@ -10,28 +10,28 @@ - Use archive mode (recursively copy directories, copy symlinks without resolving, and preserve permissions, ownership and modification times): -`rsync --archive {{path/to/source}} {{path/to/destination}}` +`rsync {{-a|--archive}} {{path/to/source}} {{path/to/destination}}` - Compress the data as it is sent to the destination, display verbose and human-readable progress, and keep partially transferred files if interrupted: -`rsync --compress --verbose --human-readable --partial --progress {{path/to/source}} {{path/to/destination}}` +`rsync {{-zvhP|--compress --verbose --human-readable --partial --progress}} {{path/to/source}} {{path/to/destination}}` - Recursively copy directories: -`rsync --recursive {{path/to/source}} {{path/to/destination}}` +`rsync {{-r|--recursive}} {{path/to/source}} {{path/to/destination}}` - Transfer directory contents, but not the directory itself: -`rsync --recursive {{path/to/source}}/ {{path/to/destination}}` +`rsync {{-r|--recursive}} {{path/to/source}}/ {{path/to/destination}}` -- Use archive mode, resolve symlinks and skip files that are newer on the destination: +- Use archive mode, resolve symlinks, and skip files that are newer on the destination: -`rsync --archive --update --copy-links {{path/to/source}} {{path/to/destination}}` +`rsync {{-auL|--archive --update --copy-links}} {{path/to/source}} {{path/to/destination}}` -- Transfer a directory to a remote host running `rsyncd` and delete files on the destination that do not exist on the source: +- Transfer a directory from a remote host running `rsyncd` and delete files on the destination that do not exist on the source: -`rsync --recursive --delete rsync://{{host}}:{{path/to/source}} {{path/to/destination}}` +`rsync {{-r|--recursive}} --delete rsync://{{host}}:{{path/to/source}} {{path/to/destination}}` - Transfer a file over SSH using a different port than the default (22) and show global progress: -`rsync --rsh 'ssh -p {{port}}' --info=progress2 {{host}}:{{path/to/source}} {{path/to/destination}}` +`rsync {{-e|--rsh}} 'ssh -p {{port}}' --info=progress2 {{host}}:{{path/to/source}} {{path/to/destination}}` diff --git a/pages/common/salt-key.md b/pages/common/salt-key.md index c8d35c5dd..b69b66281 100644 --- a/pages/common/salt-key.md +++ b/pages/common/salt-key.md @@ -1,6 +1,6 @@ # salt-key -> Manages salt minion keys on the salt master. +> Manage salt minion keys on the salt master. > Needs to be run on the salt master, likely as root or with sudo. > More information: . diff --git a/pages/common/sam2p.md b/pages/common/sam2p.md index 83d14db57..6087c9a0e 100644 --- a/pages/common/sam2p.md +++ b/pages/common/sam2p.md @@ -1,7 +1,7 @@ # sam2p > Raster (bitmap) image converter with smart PDF and PostScript (EPS) output. -> More information: . +> More information: . - Concatenate all PDF files into one: diff --git a/pages/common/sass.md b/pages/common/sass.md index b264c9597..f9b6a6327 100644 --- a/pages/common/sass.md +++ b/pages/common/sass.md @@ -1,6 +1,6 @@ # sass -> Converts SCSS or Sass files to CSS. +> Convert SCSS or Sass files to CSS. > More information: . - Convert a SCSS or Sass file to CSS and print out the result: diff --git a/pages/common/sc_warts2pcap.md b/pages/common/sc_warts2pcap.md index 82c0255af..ab483a581 100644 --- a/pages/common/sc_warts2pcap.md +++ b/pages/common/sc_warts2pcap.md @@ -1,13 +1,13 @@ # sc_warts2pcap -> Write packets included in `warts` object to a `pcap` file. +> Write packets included in `warts` object to a PCAP file. > This is only possible for tbit, sting and sniff. > More information: . -- Convert the data from several `warts` files into one `pcap` file: +- Convert the data from several `warts` files into one PCAP file: `sc_warts2pcap -o {{path/to/output.pcap}} {{path/to/file1.warts path/to/file2.warts ...}}` -- Convert the data from a `warts` file into a `pcap` file and sort the packets by timestamp: +- Convert the data from a `warts` file into a PCAP file and sort the packets by timestamp: `sc_warts2pcap -s -o {{path/to/output.pcap}} {{path/to/file.warts}}` diff --git a/pages/common/scp.md b/pages/common/scp.md index a6dee41f0..b5a01ff72 100644 --- a/pages/common/scp.md +++ b/pages/common/scp.md @@ -28,7 +28,7 @@ `scp {{path/to/local_file}} {{remote_username}}@{{remote_host}}:{{path/to/remote_directory}}` -- Use a specific ssh private key for authentication with the remote host: +- Use a specific SSH private key for authentication with the remote host: `scp -i {{~/.ssh/private_key}} {{path/to/local_file}} {{remote_host}}:{{path/to/remote_file}}` diff --git a/pages/common/secrethub.md b/pages/common/secrethub.md index 611cee332..a07d05ec5 100644 --- a/pages/common/secrethub.md +++ b/pages/common/secrethub.md @@ -1,7 +1,7 @@ # secrethub > Keep secrets out of config files. -> More information: . +> More information: . - Print a secret to `stdout`: diff --git a/pages/common/sed.md b/pages/common/sed.md index f39b712b8..e1f382293 100644 --- a/pages/common/sed.md +++ b/pages/common/sed.md @@ -2,7 +2,7 @@ > Edit text in a scriptable manner. > See also: `awk`, `ed`. -> More information: . +> More information: . - Replace all `apple` (basic regex) occurrences with `mango` (basic regex) in all input lines and print the result to `stdout`: diff --git a/pages/common/set.md b/pages/common/set.md index 703f4bf2a..d3269417a 100644 --- a/pages/common/set.md +++ b/pages/common/set.md @@ -15,7 +15,7 @@ `set -b` -- Write and edit text in the command line with `vi`-like keybindings (e.g. `yy`): +- Write and edit text in the command-line with `vi`-like keybindings (e.g. `yy`): `set -o {{vi}}` diff --git a/pages/common/sf.md b/pages/common/sf.md index 811dc623f..9e3dbcc22 100644 --- a/pages/common/sf.md +++ b/pages/common/sf.md @@ -1,6 +1,6 @@ # sf -> A powerful command line interface that simplifies development and build automation when working with your Salesforce org. +> A powerful command-line interface that simplifies development and build automation when working with your Salesforce org. > More information: . - Authorize a Salesforce Organization: diff --git a/pages/common/sfdp.md b/pages/common/sfdp.md index 83b9f46dd..b783c6419 100644 --- a/pages/common/sfdp.md +++ b/pages/common/sfdp.md @@ -4,19 +4,19 @@ > Layouts: `dot`, `neato`, `twopi`, `circo`, `fdp`, `sfdp`, `osage` & `patchwork`. > More information: . -- Render a `png` image with a filename based on the input filename and output format (uppercase -O): +- Render a PNG image with a filename based on the input filename and output format (uppercase -O): `sfdp -T {{png}} -O {{path/to/input.gv}}` -- Render a `svg` image with the specified output filename (lowercase -o): +- Render a SVG image with the specified output filename (lowercase -o): `sfdp -T {{svg}} -o {{path/to/image.svg}} {{path/to/input.gv}}` -- Render the output in `ps`, `pdf`, `svg`, `fig`, `png`, `gif`, `jpg`, `json`, or `dot` format: +- Render the output in PS, PDF, SVG, Fig, PNG, GIF, JPEG, JSON, or DOT format: `sfdp -T {{format}} -O {{path/to/input.gv}}` -- Render a `gif` image using `stdin` and `stdout`: +- Render a GIF image using `stdin` and `stdout`: `echo "{{digraph {this -> that} }}" | sfdp -T {{gif}} > {{path/to/image.gif}}` diff --git a/pages/common/shellcheck.md b/pages/common/shellcheck.md index 538a2dd69..e0dadf2f0 100644 --- a/pages/common/shellcheck.md +++ b/pages/common/shellcheck.md @@ -1,33 +1,36 @@ # shellcheck -> Shell script static analysis tool. -> Check shell scripts for errors, usage of deprecated/insecure features, and bad practices. -> More information: . +> Statically check shell scripts for errors, usage of deprecated/insecure features, and bad practices. +> More information: . - Check a shell script: `shellcheck {{path/to/script.sh}}` -- Check a shell script interpreting it as the specified shell dialect (overrides the shebang at the top of the script): +- Check a shell script interpreting it as the specified [s]hell dialect (overrides the shebang at the top of the script): `shellcheck --shell {{sh|bash|dash|ksh}} {{path/to/script.sh}}` -- Ignore one or more error types: +- Ignor[e] one or more error types: -`shellcheck --exclude {{SC1009,SC1073}} {{path/to/script.sh}}` +`shellcheck --exclude {{SC1009,SC1073,...}} {{path/to/script.sh}}` - Also check any sourced shell scripts: `shellcheck --check-sourced {{path/to/script.sh}}` -- Display output in the specified format (defaults to `tty`): +- Display output in the specified [f]ormat (defaults to `tty`): `shellcheck --format {{tty|checkstyle|diff|gcc|json|json1|quiet}} {{path/to/script.sh}}` -- Enable one or more optional checks: +- Enable one or more [o]ptional checks: -`shellcheck --enable={{add-default-case|avoid-nullary-conditions}}` +`shellcheck --enable {{add-default-case,avoid-nullary-conditions,...}} {{path/to/script.sh}}` - List all available optional checks that are disabled by default: `shellcheck --list-optional` + +- Adjust the level of [S]everity to consider (defaults to `style`): + +`shellcheck --severity {{error|warning|info|style}} {{path/to/script.sh}}` diff --git a/pages/common/shuf.md b/pages/common/shuf.md index 6cc9cb049..6fffc8139 100644 --- a/pages/common/shuf.md +++ b/pages/common/shuf.md @@ -9,12 +9,12 @@ - Only output the first 5 entries of the result: -`shuf --head-count={{5}} {{path/to/file}}` +`shuf --head-count=5 {{path/to/file}}` - Write the output to another file: -`shuf {{path/to/input}} --output={{path/to/output}}` +`shuf {{path/to/input_file}} --output={{path/to/output_file}}` - Generate 3 random numbers in the range 1-10 (inclusive): -`shuf --head-count={{3}} --input-range={{1-10}} --repeat` +`shuf --head-count=3 --input-range=1-10 --repeat` diff --git a/pages/common/slimrb.md b/pages/common/slimrb.md index 47c483333..74f238f7b 100644 --- a/pages/common/slimrb.md +++ b/pages/common/slimrb.md @@ -1,7 +1,7 @@ # slimrb > Convert Slim files to HTML. -> More information: . +> More information: . - Convert a Slim file to HTML: diff --git a/pages/common/sops.md b/pages/common/sops.md index 88fe9c318..b3d88b7d6 100644 --- a/pages/common/sops.md +++ b/pages/common/sops.md @@ -1,28 +1,32 @@ # sops -> SOPS (Secrets OPerationS): manage secrets. +> SOPS (Secrets OPerationS): a simple and flexible tool for managing secrets. > More information: . - Encrypt a file: -`sops -e {{path/to/myfile.json}} > {{path/to/myfile.enc.json}}` +`sops -e {{path/to/file.json}} > {{path/to/file.enc.json}}` - Decrypt a file to `stdout`: -`sops -d {{path/to/myfile.enc.json}}` +`sops -d {{path/to/file.enc.json}}` -- Rotate data keys for a sops file: +- Update the declared keys in a `sops` file: -`sops -r {{path/to/myfile.enc.yaml}}` +`sops updatekeys {{path/to/file.enc.yaml}}` + +- Rotate data keys for a `sops` file: + +`sops -r {{path/to/file.enc.yaml}}` - Change the extension of the file once encrypted: -`sops -d --input-type json {{path/to/myfile.enc.json}}` +`sops -d --input-type json {{path/to/file.enc.json}}` - Extract keys by naming them, and array elements by numbering them: -`sops -d --extract '["an_array"][1]' {{path/to/myfile.enc.json}}` +`sops -d --extract '["an_array"][1]' {{path/to/file.enc.json}}` -- Show the difference between two sops files: +- Show the difference between two `sops` files: `diff <(sops -d {{path/to/secret1.enc.yaml}}) <(sops -d {{path/to/secret2.enc.yaml}})` diff --git a/pages/common/sort.md b/pages/common/sort.md index e67cba248..f4bf1169a 100644 --- a/pages/common/sort.md +++ b/pages/common/sort.md @@ -23,6 +23,10 @@ `sort --field-separator={{:}} --key={{3n}} {{/etc/passwd}}` +- As above, but when items in the 3rd field are equal, sort by the 4th field by numbers with exponents: + +`sort -t {{:}} -k {{3,3n}} -k {{4,4g}} {{/etc/passwd}}` + - Sort a file preserving only unique lines: `sort --unique {{path/to/file}}` @@ -30,7 +34,3 @@ - Sort a file, printing the output to the specified output file (can be used to sort a file in-place): `sort --output={{path/to/file}} {{path/to/file}}` - -- Sort numbers with exponents: - -`sort --general-numeric-sort {{path/to/file}}` diff --git a/pages/common/spatial.md b/pages/common/spatial.md deleted file mode 100644 index 9d3bb7686..000000000 --- a/pages/common/spatial.md +++ /dev/null @@ -1,36 +0,0 @@ -# spatial - -> A set of commands for managing and developing SpatialOS projects. -> More information: . - -- Run this when you use a project for the first time: - -`spatial worker build` - -- Build workers for local deployment on Unity on macOS: - -`spatial worker build --target=development --target=Osx` - -- Build workers for local deployment on Unreal on Windows: - -`spatial worker build --target=local --target=Windows` - -- Deploy locally: - -`spatial local launch {{launch_config}} --snapshot={{snapshot_file}}` - -- Launch a local worker to connect to your local deployment: - -`spatial local worker launch {{worker_type}} {{launch_config}}` - -- Upload an assembly to use for cloud deployments: - -`spatial cloud upload {{assembly_name}}` - -- Launch a cloud deployment: - -`spatial cloud launch {{assembly_name}} {{launch_config}} {{deployment_name}}` - -- Clean worker directories: - -`spatial worker clean` diff --git a/pages/common/spfquery.md b/pages/common/spfquery.md index 7ab7d0419..97e9b191a 100644 --- a/pages/common/spfquery.md +++ b/pages/common/spfquery.md @@ -1,7 +1,7 @@ # spfquery > Query Sender Policy Framework records to validate e-mail senders. -> More information: . +> More information: . - Check if an IP address is allowed to send an e-mail from the specified e-mail address: diff --git a/pages/common/split.md b/pages/common/split.md index 408f9853d..dfd705f5c 100644 --- a/pages/common/split.md +++ b/pages/common/split.md @@ -5,16 +5,16 @@ - Split a file, each split having 10 lines (except the last split): -`split -l {{10}} {{path/to/file}}` +`split -l 10 {{path/to/file}}` - Split a file into 5 files. File is split such that each split has same size (except the last split): -`split -n {{5}} {{path/to/file}}` +`split -n 5 {{path/to/file}}` - Split a file with 512 bytes in each split (except the last split; use 512k for kilobytes and 512m for megabytes): -`split -b {{512}} {{path/to/file}}` +`split -b 512 {{path/to/file}}` - Split a file with at most 512 bytes in each split without breaking lines: -`split -C {{512}} {{path/to/file}}` +`split -C 512 {{path/to/file}}` diff --git a/pages/common/ssh-add.md b/pages/common/ssh-add.md index 6c833d2e6..114ab021b 100644 --- a/pages/common/ssh-add.md +++ b/pages/common/ssh-add.md @@ -4,7 +4,7 @@ > Ensure that `ssh-agent` is up and running for the keys to be loaded in it. > More information: . -- Add the default ssh keys in `~/.ssh` to the ssh-agent: +- Add the default SSH keys in `~/.ssh` to the ssh-agent: `ssh-add` diff --git a/pages/common/ssh-keygen.md b/pages/common/ssh-keygen.md index dd5c46db6..66b658b1f 100644 --- a/pages/common/ssh-keygen.md +++ b/pages/common/ssh-keygen.md @@ -1,6 +1,6 @@ # ssh-keygen -> Generate ssh keys used for authentication, password-less logins, and other things. +> Generate SSH keys used for authentication, password-less logins, and other things. > More information: . - Generate a key interactively: diff --git a/pages/common/ssh-keyscan.md b/pages/common/ssh-keyscan.md index b28098d5a..a174d862b 100644 --- a/pages/common/ssh-keyscan.md +++ b/pages/common/ssh-keyscan.md @@ -1,20 +1,20 @@ # ssh-keyscan -> Get the public ssh keys of remote hosts. +> Get the public SSH keys of remote hosts. > More information: . -- Retrieve all public ssh keys of a remote host: +- Retrieve all public SSH keys of a remote host: `ssh-keyscan {{host}}` -- Retrieve all public ssh keys of a remote host listening on a specific port: +- Retrieve all public SSH keys of a remote host listening on a specific port: `ssh-keyscan -p {{port}} {{host}}` -- Retrieve certain types of public ssh keys of a remote host: +- Retrieve certain types of public SSH keys of a remote host: `ssh-keyscan -t {{rsa,dsa,ecdsa,ed25519}} {{host}}` -- Manually update the ssh known_hosts file with the fingerprint of a given host: +- Manually update the SSH known_hosts file with the fingerprint of a given host: `ssh-keyscan -H {{host}} >> ~/.ssh/known_hosts` diff --git a/pages/common/ssh.md b/pages/common/ssh.md index ebf14f86e..606fe4f88 100644 --- a/pages/common/ssh.md +++ b/pages/common/ssh.md @@ -12,7 +12,7 @@ `ssh -i {{path/to/key_file}} {{username}}@{{remote_host}}` -- Connect to a remote server using a specific port: +- Connect to a remote server using a specific [p]ort: `ssh {{username}}@{{remote_host}} -p {{2222}}` @@ -20,7 +20,7 @@ `ssh {{username}}@{{remote_host}} -t {{command}} {{command_arguments}}` -- SSH tunneling: Dynamic port forwarding (SOCKS proxy on `localhost:1080`): +- SSH tunneling: [D]ynamic port forwarding (SOCKS proxy on `localhost:1080`): `ssh -D {{1080}} {{username}}@{{remote_host}}` @@ -28,7 +28,7 @@ `ssh -L {{9999}}:{{example.org}}:{{80}} -N -T {{username}}@{{remote_host}}` -- SSH jumping: Connect through a jumphost to a remote server (Multiple jump hops may be specified separated by comma characters): +- SSH [J]umping: Connect through a jumphost to a remote server (Multiple jump hops may be specified separated by comma characters): `ssh -J {{username}}@{{jump_host}} {{username}}@{{remote_host}}` diff --git a/pages/common/sshpass.md b/pages/common/sshpass.md index 081fafe53..9834cd3b3 100644 --- a/pages/common/sshpass.md +++ b/pages/common/sshpass.md @@ -1,17 +1,17 @@ # sshpass -> An ssh password provider. -> It works by creating a TTY, feeding the password into it, and then redirecting `stdin` to the ssh session. +> An SSH password provider. +> It works by creating a TTY, feeding the password into it, and then redirecting `stdin` to the SSH session. > More information: . - Connect to a remote server using a password supplied on a file descriptor (in this case, `stdin`): `sshpass -d {{0}} ssh {{user}}@{{hostname}}` -- Connect to a remote server with the password supplied as an option, and automatically accept unknown ssh keys: +- Connect to a remote server with the password supplied as an option, and automatically accept unknown SSH keys: `sshpass -p {{password}} ssh -o StrictHostKeyChecking=no {{user}}@{{hostname}}` -- Connect to a remote server using the first line of a file as the password, automatically accept unknown ssh keys, and launch a command: +- Connect to a remote server using the first line of a file as the password, automatically accept unknown SSH keys, and launch a command: `sshpass -f {{path/to/file}} ssh -o StrictHostKeyChecking=no {{user}}@{{hostname}} "{{command}}"` diff --git a/pages/common/st-info.md b/pages/common/st-info.md index b1daabfd2..3e043c1a5 100644 --- a/pages/common/st-info.md +++ b/pages/common/st-info.md @@ -1,6 +1,6 @@ # st-info -> Provides information about connected STLink and STM32 devices. +> Get information about connected STLink and STM32 devices. > More information: . - Display amount of program memory available: diff --git a/pages/common/stow.md b/pages/common/stow.md index 1cc5f9236..8437cde98 100644 --- a/pages/common/stow.md +++ b/pages/common/stow.md @@ -2,6 +2,7 @@ > Symlink manager. > Often used to manage dotfiles. +> See also: `chezmoi`, `tuckr`, `vcsh`, `homeshick`. > More information: . - Symlink all files recursively to a given directory: diff --git a/pages/common/streamlit.md b/pages/common/streamlit.md new file mode 100644 index 000000000..feef02114 --- /dev/null +++ b/pages/common/streamlit.md @@ -0,0 +1,20 @@ +# streamlit + +> Framework for creating interactive, data-driven web apps in Python. +> More information: . + +- Check for the Streamlit installation: + +`streamlit hello` + +- Run your Streamlit application: + +`streamlit run {{project_name}}` + +- Display help: + +`streamlit --help` + +- Display version: + +`streamlit --version` diff --git a/pages/common/sudo.md b/pages/common/sudo.md index b067b5fdf..3037b9ce5 100644 --- a/pages/common/sudo.md +++ b/pages/common/sudo.md @@ -15,7 +15,7 @@ `sudo --user={{user}} --group={{group}} {{id -a}}` -- Repeat the last command prefixed with `sudo` (only in `bash`, `zsh`, etc.): +- Repeat the last command prefixed with `sudo` (only in Bash, Zsh, etc.): `sudo !!` diff --git a/pages/common/sunicontopbm.md b/pages/common/sunicontopnm.md similarity index 100% rename from pages/common/sunicontopbm.md rename to pages/common/sunicontopnm.md diff --git a/pages/common/tar.md b/pages/common/tar.md index 124132fdf..c1ee8d727 100644 --- a/pages/common/tar.md +++ b/pages/common/tar.md @@ -28,7 +28,7 @@ `tar caf {{path/to/target.tar.xz}} {{path/to/file1 path/to/file2 ...}}` -- Lis[t] the contents of a `tar` [f]ile [v]erbosely: +- Lis[t] the contents of a tar [f]ile [v]erbosely: `tar tvf {{path/to/source.tar}}` diff --git a/pages/common/texcount.md b/pages/common/texcount.md index eeafe44aa..3b20e4f44 100644 --- a/pages/common/texcount.md +++ b/pages/common/texcount.md @@ -16,6 +16,10 @@ `texcount -inc {{file.tex}}` +- Count words in a document and subdocuments, producing subcounts by chapter (instead of subsection): + +`texcount -merge -sub=chapter {{file.tex}}` + - Count words with verbose output: `texcount -v {{path/to/file.tex}}` diff --git a/pages/common/textql.md b/pages/common/textql.md index 93deffd7c..b55f37c30 100644 --- a/pages/common/textql.md +++ b/pages/common/textql.md @@ -1,13 +1,13 @@ # textql -> Execute SQL against structured text like csv or tsv files. +> Execute SQL against structured text like CSV or TSV files. > More information: . -- Print the lines in the specified `.csv` file that match an SQL query to `stdout`: +- Print the lines in the specified CSV file that match an SQL query to `stdout`: `textql -sql "{{SELECT * FROM filename}}" {{path/to/filename.csv}}` -- Query `.tsv` file: +- Query a TSV file: `textql -dlm=tab -sql "{{SELECT * FROM filename}}" {{path/to/filename.tsv}}` diff --git a/pages/common/theharvester.md b/pages/common/theharvester.md index 3fa99e1cb..4ef95e5cd 100644 --- a/pages/common/theharvester.md +++ b/pages/common/theharvester.md @@ -9,7 +9,7 @@ - Gather information on a domain using multiple sources: -`theHarvester --domain {{domain_name}} --source {{google,bing,crtsh}}` +`theHarvester --domain {{domain_name}} --source {{duckduckgo,bing,crtsh}}` - Change the limit of results to work with: diff --git a/pages/common/tig.md b/pages/common/tig.md index 9cc7f5e97..bac529b1d 100644 --- a/pages/common/tig.md +++ b/pages/common/tig.md @@ -1,7 +1,8 @@ # tig -> A text-mode interface for Git. -> More information: . +> A configurable `ncurses`-based TUI for Git. +> See also: `gitui`, `git-gui`. +> More information: . - Show the sequence of commits starting from the current one in reverse chronological order: @@ -26,3 +27,7 @@ - Start in stash view, displaying all saved stashes: `tig stash` + +- Display help in TUI: + +`h` diff --git a/pages/common/timidity.md b/pages/common/timidity.md index 3df135387..f85182069 100644 --- a/pages/common/timidity.md +++ b/pages/common/timidity.md @@ -1,6 +1,6 @@ # timidity -> A MIDI file player and converter. +> Play and convert MIDI files. > More information: . - Play a MIDI file: diff --git a/pages/common/tldr.md b/pages/common/tldr.md index fe852ccec..66cc56d02 100644 --- a/pages/common/tldr.md +++ b/pages/common/tldr.md @@ -24,6 +24,6 @@ `tldr --update` -- List all pages for the current platform and `common`: +- [l]ist all pages for the current platform and `common`: `tldr --list` diff --git a/pages/common/tlmgr.md b/pages/common/tlmgr.md index 920528998..8dc0ae27d 100644 --- a/pages/common/tlmgr.md +++ b/pages/common/tlmgr.md @@ -1,6 +1,6 @@ # tlmgr -> Manages packages and configuration options of an existing TeX Live installation. +> Manage packages and configuration options of an existing TeX Live installation. > Some subcommands such as `tlmgr paper` have their own usage documentation. > More information: . diff --git a/pages/common/toipe.md b/pages/common/toipe.md new file mode 100644 index 000000000..3ccf0e2c1 --- /dev/null +++ b/pages/common/toipe.md @@ -0,0 +1,25 @@ +# toipe + +> Yet another typing test, but crab flavoured. +> A trusty terminal typing tester. +> More information: . + +- Start the typing test with the default wordlist: + +`toipe` + +- Use a specific wordlist: + +`toipe {{-w|--wordlist}} {{wordlist_name}}` + +- Use a custom wordlist: + +`toipe {{-f|--file}} {{path/to/file}}` + +- Specify the number of words on each test: + +`toipe {{-n|--num}} {{number_of_words}}` + +- Include punctuation: + +`toipe {{-p|--punctuation}}` diff --git a/pages/common/touch.md b/pages/common/touch.md index 93dd4270e..41c75995c 100644 --- a/pages/common/touch.md +++ b/pages/common/touch.md @@ -15,6 +15,6 @@ `touch -c -t {{YYYYMMDDHHMM.SS}} {{path/to/file1 path/to/file2 ...}}` -- Set the file time of a specific file to the time of anothe[r] file and don't [c]reate file if it doesn't exist: +- Set the files' timestamp to the [r]eference file's timestamp, and do not [c]reate the file if it does not exist: -`touch -c -r {{~/.emacs}} {{path/to/file1 path/to/file2 ...}}` +`touch -c -r {{path/to/reference_file}} {{path/to/file1 path/to/file2 ...}}` diff --git a/pages/common/traefik.md b/pages/common/traefik.md index 5eb5139c0..c9dc82f3c 100644 --- a/pages/common/traefik.md +++ b/pages/common/traefik.md @@ -3,15 +3,15 @@ > An HTTP reverse proxy and load balancer. > More information: . -- Start server with default config: +- Start the server with the default configuration: `traefik` -- Start server with a custom configuration file: +- Start the server with a custom configuration file: -`traefik --c {{config_file.toml}}` +`traefik --ConfigFile {{config_file.toml}}` -- Start server with cluster mode enabled: +- Start the server with cluster mode enabled: `traefik --cluster` diff --git a/pages/common/trawl.md b/pages/common/trawl.md index 393810a73..222046c39 100644 --- a/pages/common/trawl.md +++ b/pages/common/trawl.md @@ -1,6 +1,6 @@ # trawl -> Prints out network interface information to the console, much like ifconfig/ipconfig/ip/ifdata. +> Print out network interface information to the console, much like ifconfig/ipconfig/ip/ifdata. > More information: . - Show column names: diff --git a/pages/common/tree.md b/pages/common/tree.md index fb068c0df..a089e2c0a 100644 --- a/pages/common/tree.md +++ b/pages/common/tree.md @@ -1,7 +1,7 @@ # tree > Show the contents of the current directory as a tree. -> More information: . +> More information: . - Print files and directories up to 'num' levels of depth (where 1 means the current directory): diff --git a/pages/common/tuckr.md b/pages/common/tuckr.md index 1a4b9589b..1d70e00b6 100644 --- a/pages/common/tuckr.md +++ b/pages/common/tuckr.md @@ -1,6 +1,7 @@ # tuckr > Dotfile manager written in Rust. +> See also: `chezmoi`, `vcsh`, `homeshick`, `stow`. > More information: . - Check dotfile status: diff --git a/pages/common/twopi.md b/pages/common/twopi.md index cc7de323a..1b7a4184e 100644 --- a/pages/common/twopi.md +++ b/pages/common/twopi.md @@ -4,19 +4,19 @@ > Layouts: `dot`, `neato`, `twopi`, `circo`, `fdp`, `sfdp`, `osage` & `patchwork`. > More information: . -- Render a `png` image with a filename based on the input filename and output format (uppercase -O): +- Render a PNG image with a filename based on the input filename and output format (uppercase -O): `twopi -T {{png}} -O {{path/to/input.gv}}` -- Render a `svg` image with the specified output filename (lowercase -o): +- Render a SVG image with the specified output filename (lowercase -o): `twopi -T {{svg}} -o {{path/to/image.svg}} {{path/to/input.gv}}` -- Render the output in `ps`, `pdf`, `svg`, `fig`, `png`, `gif`, `jpg`, `json`, or `dot` format: +- Render the output in PS, PDF, SVG, Fig, PNG, GIF, JPEG, JSON, or DOT format: `twopi -T {{format}} -O {{path/to/input.gv}}` -- Render a `gif` image using `stdin` and `stdout`: +- Render a GIF image using `stdin` and `stdout`: `echo "{{digraph {this -> that} }}" | twopi -T {{gif}} > {{path/to/image.gif}}` diff --git a/pages/common/type.md b/pages/common/type.md index a692c4296..104bcccf4 100644 --- a/pages/common/type.md +++ b/pages/common/type.md @@ -1,16 +1,21 @@ # type > Display the type of command the shell will execute. +> Note: all examples are not POSIX compliant. > More information: . - Display the type of a command: `type {{command}}` -- Display all locations containing the specified executable: +- Display all locations containing the specified executable (works only in Bash/fish/Zsh shells): `type -a {{command}}` -- Display the name of the disk file that would be executed: +- Display the name of the disk file that would be executed (works only in Bash/fish/Zsh shells): `type -p {{command}}` + +- Display the type of a specific command, alias/keyword/function/builtin/file (works only in Bash/fish shells): + +`type -t {{command}}` diff --git a/pages/common/typeinc.md b/pages/common/typeinc.md new file mode 100644 index 000000000..9e7e61f76 --- /dev/null +++ b/pages/common/typeinc.md @@ -0,0 +1,21 @@ +# typeinc + +> An `ncurses` based terminal typing speed test program, written in Python. +> Try out different difficulty levels and improve your typing speed. +> More information: . + +- Enter the typing test: + +`typeinc` + +- Display the top 10 rank list for input difficulty level: + +`typeinc {{-r|--ranklist}} {{difficulty_level}}` + +- Get random English words present in our wordlist: + +`typeinc {{-w|--words}} {{word_count}}` + +- Calculate hypothetical Typeinc score: + +`typeinc {{-s|--score}}` diff --git a/pages/common/ufraw-batch.md b/pages/common/ufraw-batch.md index 5cde5ebbe..fad2207ae 100644 --- a/pages/common/ufraw-batch.md +++ b/pages/common/ufraw-batch.md @@ -3,7 +3,7 @@ > Convert RAW files from cameras into standard image files. > More information: . -- Simply convert RAW files to JPG: +- Simply convert RAW files to JPEG: `ufraw-batch --out-type=jpg {{input_file(s)}}` diff --git a/pages/common/ugrep.md b/pages/common/ugrep.md index beb719c02..1d8c38917 100644 --- a/pages/common/ugrep.md +++ b/pages/common/ugrep.md @@ -23,7 +23,7 @@ `ugrep --fuzzy={{3}} "{{search_pattern}}"` -- Also search compressed files, `zip` and `tar` archives recursively: +- Also search compressed files, Zip and tar archives recursively: `ugrep --decompress "{{search_pattern}}"` diff --git a/pages/common/unar.md b/pages/common/unar.md index 9666da33d..cd68d1e3d 100644 --- a/pages/common/unar.md +++ b/pages/common/unar.md @@ -5,20 +5,20 @@ - Extract an archive to the current directory: -`unar {{archive}}` +`unar {{path/to/archive}}` - Extract an archive to the specified directory: -`unar -o {{path/to/directory}} {{archive}}` +`unar -o {{path/to/directory}} {{path/to/archive}}` - Force overwrite if files to be unpacked already exist: -`unar -f {{archive}}` +`unar -f {{path/to/archive}}` - Force rename if files to be unpacked already exist: -`unar -r {{archive}}` +`unar -r {{path/to/archive}}` - Force skip if files to be unpacked already exist: -`unar -s {{archive}}` +`unar -s {{path/to/archive}}` diff --git a/pages/common/unison.md b/pages/common/unison.md index 97e6359db..5309a8bb4 100644 --- a/pages/common/unison.md +++ b/pages/common/unison.md @@ -1,7 +1,7 @@ # unison > Bidirectional file synchronisation tool. -> More information: . +> More information: . - Sync two directories (creates log first time these two directories are synchronized): diff --git a/pages/common/units.md b/pages/common/units.md index d287fdc70..814be86b2 100644 --- a/pages/common/units.md +++ b/pages/common/units.md @@ -1,6 +1,6 @@ # units -> Provide the conversion between two units of measure. +> Convert between two units of measure. > More information: . - Run in interactive mode: diff --git a/pages/common/unzip.md b/pages/common/unzip.md index c5817ff57..9c933964f 100644 --- a/pages/common/unzip.md +++ b/pages/common/unzip.md @@ -1,6 +1,6 @@ # unzip -> Extract files/directories from ZIP archives. +> Extract files/directories from Zip archives. > See also: `zip`. > More information: . diff --git a/pages/common/upt.md b/pages/common/upt.md new file mode 100644 index 000000000..d39166e23 --- /dev/null +++ b/pages/common/upt.md @@ -0,0 +1,38 @@ +# upt + +> Unified interface for managing packages across various operating systems, like Windows, many Linux distributions, macOS, FreeBSD and even Haiku. +> It requires the native OS package manager to be installed. +> See also: `flatpak`, `brew`, `scoop`, `apt`, `dnf`. +> More information: . + +- Update the list of available packages: + +`upt update` + +- Search for a given package: + +`upt search {{search_term}}` + +- Show information for a package: + +`upt info {{package}}` + +- Install a given package: + +`upt install {{package}}` + +- Remove a given package: + +`upt {{remove|uninstall}} {{package}}` + +- Upgrade all installed packages: + +`upt upgrade` + +- Upgrade a given package: + +`upt upgrade {{package}}` + +- List installed packages: + +`upt list` diff --git a/pages/common/usql.md b/pages/common/usql.md index 48c3614ed..fe0670719 100644 --- a/pages/common/usql.md +++ b/pages/common/usql.md @@ -15,10 +15,6 @@ `usql --command="{{sql_command}}"` -- List databases available on the server: - -`usql --list-databases` - - Run an SQL command in the `usql` prompt: `{{prompt}}=> {{command}}` @@ -29,8 +25,8 @@ - Export query results to a specific file: -`{{prompt}}=> \g {{/path/to/results.txt}}` +`{{prompt}}=> \g {{path/to/file_with_results}}` - Import data from a CSV file into a specific table: -`{{prompt}}=> \copy {{/path/to/data.csv}} {{table_name}}` +`{{prompt}}=> \copy {{path/to/data.csv}} {{table_name}}` diff --git a/pages/common/vboxmanage-cloud.md b/pages/common/vboxmanage-cloud.md index d5bf01f31..80b67f5e3 100644 --- a/pages/common/vboxmanage-cloud.md +++ b/pages/common/vboxmanage-cloud.md @@ -25,7 +25,7 @@ - Create a new image: -`VBoxManage cloud --provider={{provider_name}} --profile={{profile_name}} image create --instance-id={{instance_id}} --display-name={{display_name}} --compartment-id={{compartmet_id}}` +`VBoxManage cloud --provider={{provider_name}} --profile={{profile_name}} image create --instance-id={{instance_id}} --display-name={{display_name}} --compartment-id={{compartment_id}}` - Retrieve information about a particular image: diff --git a/pages/common/vboxmanage-registervm.md b/pages/common/vboxmanage-registervm.md index 5ec2f3b09..00ed83359 100644 --- a/pages/common/vboxmanage-registervm.md +++ b/pages/common/vboxmanage-registervm.md @@ -11,6 +11,6 @@ `VBoxManage registervm {{path/to/filename.vbox}} --password {{path/to/password_file}}` -- Prompt for the encryption password on the command line: +- Prompt for the encryption password on the command-line: `VBoxManage registervm {{path/to/filename.vbox}} --password -` diff --git a/pages/common/vcsh.md b/pages/common/vcsh.md index 3ec8b0e88..9f01bc613 100644 --- a/pages/common/vcsh.md +++ b/pages/common/vcsh.md @@ -1,6 +1,7 @@ # vcsh > Version Control System for the home directory using Git repositories. +> See also: `chezmoi`, `stow`, `tuckr`, `homeshick`. > More information: . - Initialize an (empty) repository: diff --git a/pages/common/venv.md b/pages/common/venv.md index 5a99b5d8b..d9a0cbab7 100644 --- a/pages/common/venv.md +++ b/pages/common/venv.md @@ -5,7 +5,7 @@ - Create a Python virtual environment: -` python -m venv {{path/to/virtual_environment}}` +`python -m venv {{path/to/virtual_environment}}` - Activate the virtual environment (Linux and macOS): diff --git a/pages/common/verilator.md b/pages/common/verilator.md index bf78d0814..e289c232f 100644 --- a/pages/common/verilator.md +++ b/pages/common/verilator.md @@ -1,6 +1,6 @@ # verilator -> Converts Verilog and SystemVerilog hardware description language (HDL) design into a C++ or SystemC model to be executed after compiling. +> Convert Verilog and SystemVerilog hardware description language (HDL) design into a C++ or SystemC model to be executed after compiling. > More information: . - Build a specific C project in the current directory: diff --git a/pages/common/vifm.md b/pages/common/vifm.md index 07d45f2d1..2f656b168 100644 --- a/pages/common/vifm.md +++ b/pages/common/vifm.md @@ -1,6 +1,7 @@ # vifm -> VI File Manager is a command-line file manager. +> VI File Manager is a TUI file manager. +> See also: `clifm`, `vifm`, `mc`, `caja`. > More information: . - Open the current directory: diff --git a/pages/common/virsh-connect.md b/pages/common/virsh-connect.md index 5232e84d5..e8e50cc27 100644 --- a/pages/common/virsh-connect.md +++ b/pages/common/virsh-connect.md @@ -16,6 +16,6 @@ `virsh connect qemu:///session` -- Connect as root to a remote hypervisor using ssh: +- Connect as root to a remote hypervisor using SSH: `virsh connect qemu+ssh://{{user_name@host_name}}/system` diff --git a/pages/common/virsh.md b/pages/common/virsh.md index ecfb40a45..516077354 100644 --- a/pages/common/virsh.md +++ b/pages/common/virsh.md @@ -1,8 +1,8 @@ # virsh -> Manage virsh guest domains. (Note: 'guest_id' can be the id, name or UUID of the guest). +> Manage virsh guest domains. (Note: 'guest_id' can be the ID, name or UUID of the guest). > Some subcommands such as `virsh list` have their own usage documentation. -> More information: . +> More information: . - Connect to a hypervisor session: diff --git a/pages/common/virt-qemu-run.md b/pages/common/virt-qemu-run.md new file mode 100644 index 000000000..3249228a5 --- /dev/null +++ b/pages/common/virt-qemu-run.md @@ -0,0 +1,20 @@ +# virt-qemu-run + +> Experimental tool to run a QEMU Guest VM independent of `libvirtd`. +> More information: . + +- Run a QEMU virtual machine: + +`virt-qemu-run {{path/to/guest.xml}}` + +- Run a QEMU virtual machine and store the state in a specific directory: + +`virt-qemu-run --root={{path/to/directory}} {{path/to/guest.xml}}` + +- Run a QEMU virtual machine and display verbose information about the startup: + +`virt-qemu-run --verbose {{path/to/guest.xml}}` + +- Display help: + +`virt-qemu-run --help` diff --git a/pages/common/vlc.md b/pages/common/vlc.md index 43727ba56..a71414678 100644 --- a/pages/common/vlc.md +++ b/pages/common/vlc.md @@ -1,6 +1,7 @@ # vlc > Cross-platform multimedia player. +> See also: `mpv`, `mplayer`, `ytfzf`. > More information: . - Play a file: diff --git a/pages/common/vt.md b/pages/common/vt.md index 512a50ef1..5291ce901 100644 --- a/pages/common/vt.md +++ b/pages/common/vt.md @@ -16,7 +16,7 @@ `vt analysis {{file_id|analysis_id}}` -- Download files in encrypted `.zip` format (requires premium account): +- Download files in encrypted Zip format (requires premium account): `vt download {{file_id}} --output {{path/to/directory}} --zip --zip-password {{password}}` diff --git a/pages/common/warp-diag.md b/pages/common/warp-diag.md index 3c0cd4f4a..e693757f2 100644 --- a/pages/common/warp-diag.md +++ b/pages/common/warp-diag.md @@ -4,11 +4,11 @@ > See also: `warp-cli`. > More information: . -- Generate a `zip` file with information about the system configuration and the WARP connection: +- Generate a Zip file with information about the system configuration and the WARP connection: `warp-diag` -- Generate a `zip` file with debug information including a timestamp to the output filename: +- Generate a Zip file with debug information including a timestamp to the output filename: `warp-diag --add-ts` diff --git a/pages/common/waybar.md b/pages/common/waybar.md new file mode 100644 index 000000000..65d4b4ed2 --- /dev/null +++ b/pages/common/waybar.md @@ -0,0 +1,20 @@ +# waybar + +> Highly customizable Wayland bar for Sway and Wlroots based compositors. +> More information: . + +- Start `waybar` with the default configuration and stylesheet: + +`waybar` + +- Use a different configuration file: + +`waybar {{-c|--config}} {{path/to/config.jsonc}}` + +- Use a different stylesheet file: + +`waybar {{-s|--style}} {{path/to/stylesheet.css}}` + +- Set the logging level: + +`waybar {{-l|--log-level}} {{trace|debug|info|warning|error|critical|off}}` diff --git a/pages/common/waymore.md b/pages/common/waymore.md new file mode 100644 index 000000000..5c24efb02 --- /dev/null +++ b/pages/common/waymore.md @@ -0,0 +1,21 @@ +# waymore + +> Fetch URLs of a domain from Wayback Machine, Common Crawl, Alien Vault OTX, URLScan, and VirusTotal. +> Note: Unless specified, output is dumped into the `results/` directory where waymore's `config.yml` resides (by default in `~/.config/waymore/`). +> More information: . + +- Search for URLs of a domain (output will typically be in `~/.config/waymore/results/`): + +`waymore -i {{example.com}}` + +- Limit search results to only include a list of URLs for a domain and store outputs to the specified file: + +`waymore -mode U -oU {{path/to/example.com-urls.txt}} -i {{example.com}}` + +- Only output the content bodies of URLs and store outputs to the specified directory: + +`waymore -mode R -oR {{path/to/example.com-url-responses}} -i {{example.com}}` + +- Filter the results by specifying date ranges: + +`waymore -from {{YYYYMMDD|YYYYMM|YYYY}} -to {{YYYYMMDD|YYYYMM|YYYY}} -i {{example.com}}` diff --git a/pages/common/wdiff.md b/pages/common/wdiff.md new file mode 100644 index 000000000..d90a38ef8 --- /dev/null +++ b/pages/common/wdiff.md @@ -0,0 +1,16 @@ +# wdiff + +> Display word differences between text files. +> More information: . + +- Compare two files: + +`wdiff {{path/to/file1}} {{path/to/file2}}` + +- Ignore case when comparing: + +`wdiff --ignore-case {{path/to/file1}} {{path/to/file2}}` + +- Display how many words are deleted, inserted or replaced: + +`wdiff --statistics {{path/to/file1}} {{path/to/file2}}` diff --git a/pages/common/webpack.md b/pages/common/webpack.md index c61d53988..66e54a33f 100644 --- a/pages/common/webpack.md +++ b/pages/common/webpack.md @@ -7,7 +7,7 @@ `webpack {{app.js}} {{bundle.js}}` -- Load CSS files too from the JavaScript file (this uses the CSS loader for `.css` files): +- Load CSS files too from the JavaScript file (this uses the CSS loader for CSS files): `webpack {{app.js}} {{bundle.js}} --module-bind '{{css=css}}'` diff --git a/pages/common/wfuzz.md b/pages/common/wfuzz.md index 90de31ab1..513adfb6f 100644 --- a/pages/common/wfuzz.md +++ b/pages/common/wfuzz.md @@ -3,18 +3,34 @@ > A web application bruteforcer. > More information: . -- Directory and file bruteforce using the specified wordlist and also proxying the traffic: +- Directory and file bruteforce using the specified [w]ordlist and also [p]roxying the traffic: -`wfuzz -w {{path/to/file}} -p {{127.0.0.1:8080}} {{http://example.com/FUZZ}}` +`wfuzz -w {{path/to/file}} -p {{127.0.0.1:8080:HTTP}} {{http://example.com/FUZZ}}` -- Save the results to a file: +- Save the results to a [f]ile: `wfuzz -w {{path/to/file}} -f {{filename}} {{http://example.com/FUZZ}}` -- Show colorized output while only showing the declared response codes in the output: +- Show [c]olorized output while only showing the declared response codes in the output: `wfuzz -c -w {{path/to/file}} --sc {{200,301,302}} {{http://example.com/FUZZ}}` -- Use a custom header to fuzz subdomains while hiding specific response codes and word counts. Increase the threads to 100 and include the target ip/domain: +- Use a custom [H]eader to fuzz subdomains while [h]iding specific response [c]odes and word counts. Increase the [t]hreads to 100 and include the target ip/domain: `wfuzz -w {{path/to/file}} -H {{"Host: FUZZ.example.com"}} --hc {{301}} --hw {{222}} -t {{100}} {{example.com}}` + +- Brute force Basic Authentication using a list of usernames and passwords from files for each FUZ[z] keyword, [h]iding response [c]odes of unsuccessful attempts: + +`wfuzz -c --hc {{401}} -s {{delay_between_requests_in_seconds}} -z file,{{path/to/usernames}} -z file,{{path/to/passwords}} --basic 'FUZZ:FUZ2Z' {{https://example.com}}` + +- Provide wordlist directly from the command-line and use POST request for fuzzing: + +`wfuzz -z list,{{word1-word2-...}} {{https://api.example.com}} -d {{"id=FUZZ&showwallet=true"}}` + +- Provide wordlists from a file applying base64 and md5 encoding on them (`wfuzz -e encoders` lists all available encoders): + +`wfuzz -z file,{{path/to/file}},none-base64-md5 {{https://example.com/FUZZ}}` + +- List available encoders/payloads/iterators/printers/scripts: + +`wfuzz -e {{encoders|payloads|iterators|printers|scripts}}` diff --git a/pages/common/whereis.md b/pages/common/whereis.md index 6ee3f8a0f..1bde40421 100644 --- a/pages/common/whereis.md +++ b/pages/common/whereis.md @@ -3,7 +3,7 @@ > Locate the binary, source, and manual page files for a command. > More information: . -- Locate binary, source and man pages for ssh: +- Locate binary, source and man pages for SSH: `whereis {{ssh}}` diff --git a/pages/common/wikit.md b/pages/common/wikit.md index b8e55ba94..dc2ef00a0 100644 --- a/pages/common/wikit.md +++ b/pages/common/wikit.md @@ -1,6 +1,6 @@ # wikit -> A command line program for getting Wikipedia summaries easily. +> A command-line program for getting Wikipedia summaries easily. > More information: . - Show a short summary of a specific topic on Wikipedia: diff --git a/pages/common/wireplumber.md b/pages/common/wireplumber.md index 421df182f..e8b170ac9 100644 --- a/pages/common/wireplumber.md +++ b/pages/common/wireplumber.md @@ -2,7 +2,7 @@ > A modular session/policy manager for PipeWire and a GObject-based high-level library that wraps PipeWire’s API. > See also: `wpctl`, `pipewire`. -> More information: . +> More information: . - Make WirePlumber start with the user session immediately (for systemd systems): diff --git a/pages/common/wpexec.md b/pages/common/wpexec.md index 64c90ecc4..9d5e33e4d 100644 --- a/pages/common/wpexec.md +++ b/pages/common/wpexec.md @@ -2,7 +2,7 @@ > Run WirePlumber Lua scripts. > See also: `wpctl`, `wireplumber`. -> More information: . +> More information: . - Run a WirePlumber script: diff --git a/pages/common/write.md b/pages/common/write.md index 6a7315d24..bdd45f35d 100644 --- a/pages/common/write.md +++ b/pages/common/write.md @@ -4,7 +4,7 @@ > Use the `who` command to find out all terminal_ids of all active users active on the system. See also `mesg`. > More information: . -- Send a message to a given user on a given terminal id: +- Send a message to a given user on a given terminal ID: `write {{username}} {{terminal_id}}` diff --git a/pages/common/xdelta.md b/pages/common/xdelta.md index 067cadc5a..f9ba5bb45 100644 --- a/pages/common/xdelta.md +++ b/pages/common/xdelta.md @@ -2,7 +2,7 @@ > Delta encoding utility. > Often used for applying patches to binary files. -> More information: . +> More information: . - Apply a patch: diff --git a/pages/common/xkill.md b/pages/common/xkill.md index f86234649..bc63c0bc3 100644 --- a/pages/common/xkill.md +++ b/pages/common/xkill.md @@ -12,6 +12,6 @@ `xkill -button any` -- Kill a window with a specific id (use `xwininfo` to get info about windows): +- Kill a window with a specific ID (use `xwininfo` to get info about windows): `xkill -id {{id}}` diff --git a/pages/common/xprop.md b/pages/common/xprop.md index 86bbe076f..71120de5d 100644 --- a/pages/common/xprop.md +++ b/pages/common/xprop.md @@ -15,6 +15,6 @@ `xprop -font "{{font_name}}" POINT_SIZE` -- Display all the properties of the window with the id 0x200007: +- Display all the properties of the window with the ID 0x200007: `xprop -id {{0x200007}}` diff --git a/pages/common/xz.md b/pages/common/xz.md index 1ed5a10c2..ac3e93e48 100644 --- a/pages/common/xz.md +++ b/pages/common/xz.md @@ -1,13 +1,13 @@ # xz -> Compress or decompress `.xz` and `.lzma` files. +> Compress or decompress XZ and LZMA files. > More information: . - Compress a file using xz: `xz {{path/to/file}}` -- Decompress an xz file: +- Decompress an XZ file: `xz --decompress {{path/to/file.xz}}` @@ -15,7 +15,7 @@ `xz --format=lzma {{path/to/file}}` -- Decompress an lzma file: +- Decompress an LZMA file: `xz --decompress --format=lzma {{path/to/file.lzma}}` diff --git a/pages/common/yacc.md b/pages/common/yacc.md index a598cadc4..b84f368e2 100644 --- a/pages/common/yacc.md +++ b/pages/common/yacc.md @@ -2,7 +2,7 @@ > Generate an LALR parser (in C) with a formal grammar specification file. > See also: `bison`. -> More information: . +> More information: . - Create a file `y.tab.c` containing the C parser code and compile the grammar file with all necessary constant declarations for values. (Constant declarations file `y.tab.h` is created only when the `-d` flag is used): diff --git a/pages/common/you-get.md b/pages/common/you-get.md index e6dec4a8a..0d7ac7893 100644 --- a/pages/common/you-get.md +++ b/pages/common/you-get.md @@ -1,6 +1,7 @@ # you-get > Download media contents (videos, audios, images) from the Web. +> See also: `yt-dlp`, `youtube-viewer`, `instaloader`. > More information: . - Print media information about a specific media on the web: diff --git a/pages/common/youtube-dl.md b/pages/common/youtube-dl.md index 938faad49..240063d63 100644 --- a/pages/common/youtube-dl.md +++ b/pages/common/youtube-dl.md @@ -1,6 +1,7 @@ # youtube-dl > Download videos from YouTube and other websites. +> See also: `yt-dlp`, `ytfzf`, `you-get`. > More information: . - Download a video or playlist: diff --git a/pages/common/youtube-viewer.md b/pages/common/youtube-viewer.md index e1485d7c5..5da879e38 100644 --- a/pages/common/youtube-viewer.md +++ b/pages/common/youtube-viewer.md @@ -1,6 +1,7 @@ # youtube-viewer > Search and play videos from YouTube. +> See also: `you-get`, `ytfzf`, `yt-dlp`. > More information: . - Search for a video: diff --git a/pages/common/yt-dlp.md b/pages/common/yt-dlp.md index d560237a4..5e5cec100 100644 --- a/pages/common/yt-dlp.md +++ b/pages/common/yt-dlp.md @@ -2,6 +2,7 @@ > A youtube-dl fork with additional features and fixes. > Download videos from YouTube and other websites. +> See also: `yt-dlp`, `ytfzf`. > More information: . - Download a video or playlist (with the default options from command below): @@ -12,7 +13,7 @@ `yt-dlp --list-formats "{{https://www.youtube.com/watch?v=oHg5SJYRHA0}}"` -- Download a video with a defined format, in this case the best mp4 video available (default is "bv\*+ba/b"): +- Download a video or playlist using the best MP4 video available (default is "bv\*+ba/b"): `yt-dlp --format "{{bv*[ext=mp4]+ba[ext=m4a]/b[ext=mp4]}}" "{{https://www.youtube.com/watch?v=oHg5SJYRHA0}}"` @@ -24,14 +25,10 @@ `yt-dlp --extract-audio --audio-format {{mp3}} --audio-quality {{0}} "{{https://www.youtube.com/watch?v=oHg5SJYRHA0}}"` -- Download all playlists of YouTube channel/user keeping each playlist in separate directory: +- Download all playlists of a YouTube channel/user keeping each playlist in a separate directory: `yt-dlp -o "{{%(uploader)s/%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s}}" "{{https://www.youtube.com/user/TheLinuxFoundation/playlists}}"` -- Download Udemy course keeping each chapter in separate directory under MyVideos directory in your home: +- Download a Udemy course keeping each chapter in a separate directory: -`yt-dlp -u {{user}} -p {{password}} -P "{{~/MyVideos}}" -o "{{%(playlist)s/%(chapter_number)s - %(chapter)s/%(title)s.%(ext)s}}" "{{https://www.udemy.com/java-tutorial}}"` - -- Download entire series season keeping each series and each season in separate directory under C:/MyVideos: - -`yt-dlp -P "{{C:/MyVideos}}" -o "{{%(series)s/%(season_number)s - %(season)s/%(episode_number)s - %(episode)s.%(ext)s}}" "{{https://videomore.ru/kino_v_detalayah/5_sezon/367617}}"` +`yt-dlp -u {{user}} -p {{password}} -P "{{path/to/directory}}" -o "{{%(playlist)s/%(chapter_number)s - %(chapter)s/%(title)s.%(ext)s}}" "{{https://www.udemy.com/java-tutorial}}"` diff --git a/pages/common/z.md b/pages/common/z.md index ed5d4af1e..b7f21f777 100644 --- a/pages/common/z.md +++ b/pages/common/z.md @@ -1,6 +1,6 @@ # z -> Tracks the most used (by frecency) directories and enables quickly navigating to them using string patterns or regular expressions. +> Tracks the most used (by frequency) directories and enables quickly navigating to them using string patterns or regular expressions. > More information: . - Go to a directory that contains "foo" in the name: diff --git a/pages/common/zeek.md b/pages/common/zeek.md index c34be6e8f..3492b32a0 100644 --- a/pages/common/zeek.md +++ b/pages/common/zeek.md @@ -24,6 +24,6 @@ `sudo zeek --watchdog --iface {{interface}}` -- Analyze traffic from a `pcap` file: +- Analyze traffic from a PCAP file: `zeek --readfile {{path/to/file.trace}}` diff --git a/pages/common/zint.md b/pages/common/zint.md new file mode 100644 index 000000000..b10131455 --- /dev/null +++ b/pages/common/zint.md @@ -0,0 +1,16 @@ +# zint + +> Generate barcodes and QR codes. +> More information: . + +- Generate a barcode and save it: + +`zint --data "{{UTF-8 data}}" --output {{path/to/file}}` + +- Specify a code type for generation: + +`zint --barcode {{code_type}} --data "{{UTF-8 data}}" --output {{path/to/file}}` + +- List all supported code types: + +`zint --types` diff --git a/pages/common/zip.md b/pages/common/zip.md index aa3722a73..fc26fd855 100644 --- a/pages/common/zip.md +++ b/pages/common/zip.md @@ -1,6 +1,6 @@ # zip -> Package and compress (archive) files into `zip` archive. +> Package and compress (archive) files into a Zip archive. > See also: `unzip`. > More information: . @@ -24,7 +24,7 @@ `zip -r -e {{path/to/compressed.zip}} {{path/to/file_or_directory1 path/to/file_or_directory2 ...}}` -- Archive files/directories to a multi-part [s]plit `zip` archive (e.g. 3 GB parts): +- Archive files/directories to a multi-part [s]plit Zip archive (e.g. 3 GB parts): `zip -r -s {{3g}} {{path/to/compressed.zip}} {{path/to/file_or_directory1 path/to/file_or_directory2 ...}}` diff --git a/pages/common/zip2john.md b/pages/common/zip2john.md index f5346aaa7..cf51beb19 100644 --- a/pages/common/zip2john.md +++ b/pages/common/zip2john.md @@ -1,6 +1,6 @@ # zip2john -> Extract password hashes from `zip` archives for use with John the Ripper password cracker. +> Extract password hashes from Zip archives for use with John the Ripper password cracker. > This is a utility tool usually installed as part of the John the Ripper installation. > More information: . diff --git a/pages/common/zipalign.md b/pages/common/zipalign.md index 33e2d8c29..8680fb93c 100644 --- a/pages/common/zipalign.md +++ b/pages/common/zipalign.md @@ -4,10 +4,10 @@ > Part of the Android SDK build tools. > More information: . -- Align the data of a ZIP file on 4-byte boundaries: +- Align the data of a Zip file on 4-byte boundaries: `zipalign {{4}} {{path/to/input.zip}} {{path/to/output.zip}}` -- Check that a ZIP file is correctly aligned on 4-byte boundaries and display the results in a verbose manner: +- Check that a Zip file is correctly aligned on 4-byte boundaries and display the results in a verbose manner: `zipalign -v -c {{4}} {{path/to/input.zip}}` diff --git a/pages/linux/zipcloak.md b/pages/common/zipcloak.md similarity index 52% rename from pages/linux/zipcloak.md rename to pages/common/zipcloak.md index cc51fe3f0..da03d4b03 100644 --- a/pages/linux/zipcloak.md +++ b/pages/common/zipcloak.md @@ -1,16 +1,16 @@ # zipcloak -> Encrypt the contents within a zipfile. +> Encrypt the contents within a Zip archive. > More information: . -- Encrypt the contents of a zipfile: +- Encrypt the contents of a Zip archive: `zipcloak {{path/to/archive.zip}}` -- [d]ecrypt the contents of a zipfile: +- [d]ecrypt the contents of a Zip archive: `zipcloak -d {{path/to/archive.zip}}` -- [O]utput the encrypted contents into a new zipfile: +- [O]utput the encrypted contents into a new Zip archive: `zipcloak {{path/to/archive.zip}} -O {{path/to/encrypted.zip}}` diff --git a/pages/common/zipgrep.md b/pages/common/zipgrep.md index a85300857..db197b04b 100644 --- a/pages/common/zipgrep.md +++ b/pages/common/zipgrep.md @@ -1,9 +1,9 @@ # zipgrep -> Find patterns in files in a ZIP archive using extended regular expression (supports `?`, `+`, `{}`, `()` and `|`). +> Find patterns in files in a Zip archive using extended regular expression (supports `?`, `+`, `{}`, `()` and `|`). > More information: . -- Search for a pattern within a ZIP archive: +- Search for a pattern within a Zip archive: `zipgrep "{{search_pattern}}" {{path/to/file.zip}}` @@ -15,10 +15,10 @@ `zipgrep -v "{{search_pattern}}" {{path/to/file.zip}}` -- Specify files inside a ZIP archive from search: +- Specify files inside a Zip archive from search: `zipgrep "{{search_pattern}}" {{path/to/file.zip}} {{file/to/search1}} {{file/to/search2}}` -- Exclude files inside a ZIP archive from search: +- Exclude files inside a Zip archive from search: `zipgrep "{{search_pattern}}" {{path/to/file.zip}} -x {{file/to/exclude1}} {{file/to/exclude2}}` diff --git a/pages/common/zipinfo.md b/pages/common/zipinfo.md index b8eb089ff..55d26d6d6 100644 --- a/pages/common/zipinfo.md +++ b/pages/common/zipinfo.md @@ -1,12 +1,12 @@ # zipinfo -> List detailed information about the contents of a `.zip` file. +> List detailed information about the contents of a Zip file. > More information: . -- List all files in a `.zip` file in long format (permissions, ownership, size, and modification date): +- List all files in a Zip file in long format (permissions, ownership, size, and modification date): `zipinfo {{path/to/archive.zip}}` -- List all files in a `.zip` file: +- List all files in a Zip file: `zipinfo -1 {{path/to/archive.zip}}` diff --git a/pages/common/zipnote.md b/pages/common/zipnote.md index 0bbbc647a..c6012faba 100644 --- a/pages/common/zipnote.md +++ b/pages/common/zipnote.md @@ -1,17 +1,17 @@ # zipnote -> View, add, or edit a `zip` archive's comments. -> Files can also be renamed in the `zip` archive. +> View, add, or edit a Zip archive's comments. +> Files can also be renamed in the Zip archive. > More information: . -- View the comments on a `zip` archive: +- View the comments on a Zip archive: `zipnote {{path/to/file.zip}}` -- Extract the comments on a `zip` archive to a file: +- Extract the comments on a Zip archive to a file: `zipnote {{path/to/file.zip}} > {{path/to/file.txt}}` -- Add/Update comments in a `zip` archive from a file: +- Add/Update comments in a Zip archive from a file: `zipnote -w {{path/to/file.zip}} < {{path/to/file.txt}}` diff --git a/pages/common/znew.md b/pages/common/znew.md index 49b5574da..eea5b791e 100644 --- a/pages/common/znew.md +++ b/pages/common/znew.md @@ -1,9 +1,9 @@ # znew -> Recompress files from `.Z` to `.gz` format. +> Recompress files from `.Z` to gzip format. > More information: . -- Recompress a file from `.Z` to `.gz` format: +- Recompress a file from `.Z` to gzip format: `znew {{path/to/file1.Z}}` @@ -15,6 +15,6 @@ `znew -9 {{path/to/file1.Z}}` -- Recompress a file, [K]eeping the `.Z` file if it is smaller than the `.gz` file: +- Recompress a file, [K]eeping the `.Z` file if it is smaller than the gzip file: `znew -K {{path/to/file1.Z}}` diff --git a/pages/freebsd/look.md b/pages/freebsd/look.md index fb46deba0..dd9f98491 100644 --- a/pages/freebsd/look.md +++ b/pages/freebsd/look.md @@ -10,11 +10,11 @@ - Case-insensitively search only on alphanumeric characters: -`look -{{f|-ignore-case}} -{{d|-alphanum}} {{prefix}} {{path/to/file}}` +`look {{-f|--ignore-case}} {{-d|--alphanum}} {{prefix}} {{path/to/file}}` -- Specify a string [t]ermination character (space by default): +- Specify a string termination character (space by default): -`look -{{t|-terminate}} {{,}}` +`look {{-t|--terminate}} {{,}}` - Search in `/usr/share/dict/words` (`--ignore-case` and `--alphanum` are assumed): diff --git a/pages/linux/add-apt-repository.md b/pages/linux/add-apt-repository.md index 506479fbf..f791ffee0 100644 --- a/pages/linux/add-apt-repository.md +++ b/pages/linux/add-apt-repository.md @@ -1,6 +1,6 @@ # add-apt-repository -> Manages `apt` repository definitions. +> Manage `apt` repository definitions. > More information: . - Add a new `apt` repository: diff --git a/pages/linux/agetty.md b/pages/linux/agetty.md new file mode 100644 index 000000000..6075a87c3 --- /dev/null +++ b/pages/linux/agetty.md @@ -0,0 +1,30 @@ +# agetty + +> Alternative `getty`: Open a `tty` port, prompt for a login name, and invoke the `/bin/login` command. +> It is normally invoked by `init`. +> Note: the baud rate is the speed of data transfer between a terminal and a device over a serial connection. +> More information: . + +- Connect `stdin` to a port (relative to `/dev`) and optionally specify a baud rate (defaults to 9600): + +`agetty {{tty}} {{115200}}` + +- Assume `stdin` is already connected to a `tty` and set a timeout for the login: + +`agetty {{-t|--timeout}} {{timeout_in_seconds}} -` + +- Assume the `tty` is [8]-bit, overriding the `TERM` environment variable set by `init`: + +`agetty -8 - {{term_var}}` + +- Skip the login (no login) and invoke, as root, another login program instead of `/bin/login`: + +`agetty {{-n|--skip-login}} {{-l|--login-program}} {{login_program}} {{tty}}` + +- Do not display the pre-login (issue) file (`/etc/issue` by default) before writing the login prompt: + +`agetty {{-i|--noissue}} -` + +- Change the root directory and write a specific fake host into the `utmp` file: + +`agetty {{-r|--chroot}} {{/path/to/root_directory}} {{-H|--host}} {{fake_host}} -` diff --git a/pages/linux/apt-add-repository.md b/pages/linux/apt-add-repository.md index 13d0ca2a8..2fe5d614a 100644 --- a/pages/linux/apt-add-repository.md +++ b/pages/linux/apt-add-repository.md @@ -1,6 +1,6 @@ # apt-add-repository -> Manages `apt` repository definitions. +> Manage `apt` repository definitions. > More information: . - Add a new `apt` repository: diff --git a/pages/linux/apt-key.md b/pages/linux/apt-key.md index 7f34d869e..e1166d02e 100644 --- a/pages/linux/apt-key.md +++ b/pages/linux/apt-key.md @@ -20,6 +20,6 @@ `wget -qO - {{https://host.tld/filename.key}} | apt-key add -` -- Add a key from keyserver with only key id: +- Add a key from keyserver with only key ID: `apt-key adv --keyserver {{pgp.mit.edu}} --recv {{KEYID}}` diff --git a/pages/linux/arch-chroot.md b/pages/linux/arch-chroot.md index 92c702369..3a80cfb0d 100644 --- a/pages/linux/arch-chroot.md +++ b/pages/linux/arch-chroot.md @@ -3,7 +3,7 @@ > Enhanced `chroot` command to help in the Arch Linux installation process. > More information: . -- Start an interactive shell (`bash`, by default) in a new root directory: +- Start an interactive shell (Bash, by default) in a new root directory: `arch-chroot {{path/to/new/root}}` @@ -11,10 +11,10 @@ `arch-chroot -u {{user}} {{path/to/new/root}}` -- Run a custom command (instead of the default `bash`) in the new root directory: +- Run a custom command (instead of the default Bash) in the new root directory: `arch-chroot {{path/to/new/root}} {{command}} {{command_arguments}}` -- Specify the shell, other than the default `bash` (in this case, the `zsh` package should have been installed in the target system): +- Specify the shell, other than the default Bash (in this case, the `zsh` package should have been installed in the target system): `arch-chroot {{path/to/new/root}} {{zsh}}` diff --git a/pages/linux/arecord.md b/pages/linux/arecord.md index e8ffa5e45..8c4820ff5 100644 --- a/pages/linux/arecord.md +++ b/pages/linux/arecord.md @@ -22,3 +22,7 @@ - Allow interactive interface (e.g. use space-bar or enter to play or pause): `arecord --interactive` + +- Test your microphone by recording a 5 second sample and playing it back: + +`arecord -d 5 test-mic.wav && aplay test-mic.wav && rm test-mic.wav` diff --git a/pages/linux/arpaname.md b/pages/linux/arpaname.md index 023f9ee48..315b2586e 100644 --- a/pages/linux/arpaname.md +++ b/pages/linux/arpaname.md @@ -1,6 +1,6 @@ # arpaname -> Provides corresponding ARPA name for IP addresses. +> Get the corresponding ARPA name for a IP addresses. > More information: . - Translate IP addresses (IPv4 and IPv6) to the corresponding ARPA name: diff --git a/pages/linux/asterisk.md b/pages/linux/asterisk.md index 709e3922c..e5d9c01e9 100644 --- a/pages/linux/asterisk.md +++ b/pages/linux/asterisk.md @@ -1,7 +1,7 @@ # asterisk > Run and manage telephone and exchange (phone) server instances. -> More information: . +> More information: . - [R]econnect to a running server, and turn on logging 3 levels of [v]erbosity: diff --git a/pages/linux/atool.md b/pages/linux/atool.md index a4faa9d6d..d0e034d45 100644 --- a/pages/linux/atool.md +++ b/pages/linux/atool.md @@ -3,7 +3,7 @@ > Manage archives of various formats. > More information: . -- List files in a `zip` archive: +- List files in a Zip archive: `atool --list {{path/to/archive.zip}}` @@ -11,10 +11,10 @@ `atool --extract {{path/to/archive.tar.gz}}` -- Create a new `7z` archive with two files: +- Create a new 7z archive with two files: `atool --add {{path/to/archive.7z}} {{path/to/file1 path/to/file2 ...}}` -- Extract all `zip` and rar archives in the current directory: +- Extract all Zip and rar archives in the current directory: `atool --each --extract {{*.zip *.rar}}` diff --git a/pages/linux/auditctl.md b/pages/linux/auditctl.md new file mode 100644 index 000000000..72e16da6e --- /dev/null +++ b/pages/linux/auditctl.md @@ -0,0 +1,32 @@ +# auditctl + +> Utility to control the behavior, get status and manage rules of the Linux Auditing System. +> More information: . + +- Display the [s]tatus of the audit system: + +`sudo auditctl -s` + +- [l]ist all currently loaded audit rules: + +`sudo auditctl -l` + +- [D]elete all audit rules: + +`sudo auditctl -D` + +- [e]nable/disable the audit system: + +`sudo auditctl -e {{1|0}}` + +- Watch a file for changes: + +`sudo auditctl -a always,exit -F arch=b64 -F path={{/path/to/file}} -F perm=wa` + +- Recursively watch a directory for changes: + +`sudo auditctl -a always,exit -F arch=b64 -F dir={{/path/to/directory/}} -F perm=wa` + +- Display [h]elp: + +`auditctl -h` diff --git a/pages/linux/aur.md b/pages/linux/aur.md index d9a834c40..d87e2f6b1 100644 --- a/pages/linux/aur.md +++ b/pages/linux/aur.md @@ -19,3 +19,7 @@ - [u]pgrade local repository packages: `aur sync --upgrades` + +- Install a package without viewing changes in Vim and do not confirm dependency installation: + +`aur sync --noview --noconfirm {{package}}` diff --git a/pages/linux/autorecon.md b/pages/linux/autorecon.md new file mode 100644 index 000000000..9ea6d56e7 --- /dev/null +++ b/pages/linux/autorecon.md @@ -0,0 +1,20 @@ +# autorecon + +> A multi-threaded network reconnaissance tool which performs automated enumeration of services. +> More information: . + +- Perform reconnaissance on target host(s) (detailed scan results will be dumped in `./results`): + +`sudo autorecon {{host_or_ip1,host_or_ip2,...}}` + +- Perform reconnaissance on [t]arget(s) from a file: + +`sudo autorecon --target-file {{path/to/file}}` + +- [o]utput results to a different directory: + +`sudo autorecon --output {{path/to/results}} {{host_or_ip1,host_or_ip2,...}}` + +- Limit scanning to specific [p]orts and protocols (`T` for TCP, `U` for UDP, `B` for both): + +`sudo autorecon --ports {{T:21-25,80,443,U:53,B:123}} {{host_or_ip1,host_or_ip2,...}}` diff --git a/pages/linux/avahi-browse.md b/pages/linux/avahi-browse.md index 065b9936c..dc156dac8 100644 --- a/pages/linux/avahi-browse.md +++ b/pages/linux/avahi-browse.md @@ -1,6 +1,6 @@ # avahi-browse -> Displays services and hosts exposed on the local network via mDNS/DNS-SD. +> Display services and hosts exposed on the local network via mDNS/DNS-SD. > Avahi is compatible with Bonjour (Zeroconf) found in Apple devices. > More information: . diff --git a/pages/linux/blkdiscard.md b/pages/linux/blkdiscard.md index 3937625e2..adc701456 100644 --- a/pages/linux/blkdiscard.md +++ b/pages/linux/blkdiscard.md @@ -5,12 +5,12 @@ - Discard all sectors on a device, removing all data: -`blkdiscard /dev/{{device}}` +`blkdiscard {{/dev/device}}` - Securely discard all blocks on a device, removing all data: -`blkdiscard --secure /dev/{{device}}` +`blkdiscard --secure {{/dev/device}}` - Discard the first 100 MB of a device: -`blkdiscard --length {{100MB}} /dev/{{device}}` +`blkdiscard --length {{100MB}} {{/dev/device}}` diff --git a/pages/linux/blkpr.md b/pages/linux/blkpr.md new file mode 100644 index 000000000..0334969cd --- /dev/null +++ b/pages/linux/blkpr.md @@ -0,0 +1,24 @@ +# blkpr + +> Register, reserve, release, preempt, and clear persistent reservations on a block device that supports Persistent Reservations. +> More information: . + +- Register (command) a new reservation with a given key on a given device: + +`blkpr {{-c|--command}} register {{-k|--key}} {{reservation_key}} {{path/to/device}}` + +- Set the type of an existing reservation to exclusive access: + +`blkpr -c reserve {{-k|--key}} {{reservation_key}} {{-t|--type}} exclusive-access {{path/to/device}}` + +- Preempt the existing reservation with a given key and replace it with a new reservation: + +`blkpr -c preempt {{-K|--oldkey}} {{old_key}} {{-k|--key}} {{new_key}} {{-t|--type}} write-exclusive {{path/to/device}}` + +- Release a reservation with a given key and type on a given device: + +`blkpr -c release {{-k|--key}} {{reservation_key}} {{-t|--type}} {{reservation_type}} {{path/to/device}}` + +- Clear all reservations from a given device: + +`blkpr -c clear {{-k|--key}} {{key}} {{path/to/device}}` diff --git a/pages/linux/bwa.md b/pages/linux/bwa.md new file mode 100644 index 000000000..e8896d5d2 --- /dev/null +++ b/pages/linux/bwa.md @@ -0,0 +1,25 @@ +# bwa + +> Burrows-Wheeler Alignment tool. +> Short, low-divergent DNA sequences mapper against a large reference genome, such as the human genome. +> More information: . + +- Index the reference genome: + +`bwa index {{path/to/reference.fa}}` + +- Map single-end reads (sequences) to indexed genome using 32 [t]hreads and compress the result to save space: + +`bwa mem -t 32 {{path/to/reference.fa}} {{path/to/read_single_end.fq.gz}} | gzip > {{path/to/alignment_single_end.sam.gz}}` + +- Map pair-end reads (sequences) to the indexed genome using 32 [t]hreads and compress the result to save space: + +`bwa mem -t 32 {{path/to/reference.fa}} {{path/to/read_pair_end_1.fq.gz}} {{path/to/read_pair_end_2.fq.gz}} | gzip > {{path/to/alignment_pair_end.sam.gz}}` + +- Map pair-end reads (sequences) to the indexed genome using 32 [t]hreads with [M]arking shorter split hits as secondary for output SAM file compatibility in Picard software and compress the result: + +`bwa mem -M -t 32 {{path/to/reference.fa}} {{path/to/read_pair_end_1.fq.gz}} {{path/to/read_pair_end_2.fq.gz}} | gzip > {{path/to/alignment_pair_end.sam.gz}}` + +- Map pair-end reads (sequences) to indexed genome using 32 [t]hreads with FASTA/Q [C]omments (e.g. BC:Z:CGTAC) appending to a compressed result: + +`bwa mem -C -t 32 {{path/to/reference.fa}} {{path/to/read_pair_end_1.fq.gz}} {{path/to/read_pair_end_2.fq.gz}} | gzip > {{path/to/alignment_pair_end.sam.gz}}` diff --git a/pages/linux/cacaclock.md b/pages/linux/cacaclock.md new file mode 100644 index 000000000..4f7f79352 --- /dev/null +++ b/pages/linux/cacaclock.md @@ -0,0 +1,16 @@ +# cacaclock + +> Display the current time as ASCII art. +> More information: . + +- Display the time: + +`cacaclock` + +- Change the font: + +`cacaclock -f {{font}}` + +- Change the format using an `strftime` format specification: + +`cacaclock -d {{strftime_arguments}}` diff --git a/pages/linux/cacademo.md b/pages/linux/cacademo.md new file mode 100644 index 000000000..3e6826b7b --- /dev/null +++ b/pages/linux/cacademo.md @@ -0,0 +1,8 @@ +# cacademo + +> Display a random ASCII art animation. +> More information: . + +- View an animation: + +`cacademo` diff --git a/pages/linux/cacafire.md b/pages/linux/cacafire.md new file mode 100644 index 000000000..cc55af20e --- /dev/null +++ b/pages/linux/cacafire.md @@ -0,0 +1,8 @@ +# cacafire + +> Display an animated ASCII fire. +> More information: . + +- Display the ASCII fire: + +`cacafire` diff --git a/pages/linux/cacaview.md b/pages/linux/cacaview.md new file mode 100644 index 000000000..0d58e589e --- /dev/null +++ b/pages/linux/cacaview.md @@ -0,0 +1,8 @@ +# cacaview + +> Display an image in PMN format. +> More information: . + +- Display an image: + +`cacaview {{path/to/image}}` diff --git a/pages/linux/caja.md b/pages/linux/caja.md index 78bc8e4f8..0ad032b17 100644 --- a/pages/linux/caja.md +++ b/pages/linux/caja.md @@ -1,6 +1,7 @@ # caja -> Manages files and directories in MATE desktop environment. +> Manage files and directories in the MATE desktop environment. +> See also: `nautilus`, `dolphin`, `thunar`, `ranger`. > More information: . - Open the current user home directory: diff --git a/pages/linux/chcon.md b/pages/linux/chcon.md index e83bacaaf..9b37c0aab 100644 --- a/pages/linux/chcon.md +++ b/pages/linux/chcon.md @@ -1,6 +1,7 @@ # chcon > Change SELinux security context of a file or files/directories. +> See also: `secon`, `restorecon`, `semanage-fcontext`. > More information: . - View security context of a file: diff --git a/pages/linux/choom.md b/pages/linux/choom.md new file mode 100644 index 000000000..bb135dba5 --- /dev/null +++ b/pages/linux/choom.md @@ -0,0 +1,16 @@ +# choom + +> Display and change the adjust out-of-memory killer score. +> More information: . + +- Display the OOM-killer score of the process with a specific ID: + +`choom -p {{pid}}` + +- Change the adjust OOM-killer score of a specific process: + +`choom -p {{pid}} -n {{-1000..+1000}}` + +- Run a command with a specific adjust OOM-killer score: + +`choom -n {{-1000..+1000}} {{command}} {{argument1 argument2 ...}}` diff --git a/pages/linux/chrt.md b/pages/linux/chrt.md index e0f195a79..5d32bb5ff 100644 --- a/pages/linux/chrt.md +++ b/pages/linux/chrt.md @@ -1,7 +1,7 @@ # chrt > Manipulate the real-time attributes of a process. -> More information: . +> More information: . - Display attributes of a process: @@ -15,6 +15,10 @@ `chrt --max` -- Set the scheduling policy for a process: +- Set the scheduling priority of a process: -`chrt --pid {{PID}} --{{deadline|idle|batch|rr|fifo|other}}` +`chrt --pid {{priority}} {{PID}}` + +- Set the scheduling policy of a process: + +`chrt --{{deadline|idle|batch|rr|fifo|other}} --pid {{priority}} {{PID}}` diff --git a/pages/linux/cmus.md b/pages/linux/cmus.md index f58d06231..30830ea16 100644 --- a/pages/linux/cmus.md +++ b/pages/linux/cmus.md @@ -2,6 +2,7 @@ > Command-line Music Player. > Use arrow keys to navigate, `` to select, and numbers 1-8 switch between different views. +> See also: `ncmpcpp`, `clementine`, `qmmp`. > More information: . - Open cmus into the specified directory (this will become your new working directory): diff --git a/pages/linux/cockpit-desktop.md b/pages/linux/cockpit-desktop.md index 35af50aa8..b3ac993a4 100644 --- a/pages/linux/cockpit-desktop.md +++ b/pages/linux/cockpit-desktop.md @@ -1,6 +1,6 @@ # cockpit-desktop -> Provides secure access to Cockpit pages in an already running session. +> Securely access Cockpit pages in a running session. > It starts `cockpit-ws` and a web browser in an isolated network space and a `cockpit-bridge` in a running user session. > More information: . diff --git a/pages/linux/compseq.md b/pages/linux/compseq.md new file mode 100644 index 000000000..e9c519c6a --- /dev/null +++ b/pages/linux/compseq.md @@ -0,0 +1,36 @@ +# compseq + +> Calculate the composition of unique words in sequences. +> More information: . + +- Count observed frequencies of words in a FASTA file, providing parameter values with interactive prompt: + +`compseq {{path/to/file.fasta}}` + +- Count observed frequencies of amino acid pairs from a FASTA file, save output to a text file: + +`compseq {{path/to/input_protein.fasta}} -word 2 {{path/to/output_file.comp}}` + +- Count observed frequencies of hexanucleotides from a FASTA file, save output to a text file and ignore zero counts: + +`compseq {{path/to/input_dna.fasta}} -word 6 {{path/to/output_file.comp}} -nozero` + +- Count observed frequencies of codons in a particular reading frame; ignoring any overlapping counts (i.e. move window across by word-length 3): + +`compseq -sequence {{path/to/input_rna.fasta}} -word 3 {{path/to/output_file.comp}} -nozero -frame {{1}}` + +- Count observed frequencies of codons frame-shifted by 3 positions; ignoring any overlapping counts (should report all codons except the first one): + +`compseq -sequence {{path/to/input_rna.fasta}} -word 3 {{path/to/output_file.comp}} -nozero -frame 3` + +- Count amino acid triplets in a FASTA file and compare to a previous run of `compseq` to calculate expected and normalised frequency values: + +`compseq -sequence {{path/to/human_proteome.fasta}} -word 3 {{path/to/output_file1.comp}} -nozero -infile {{path/to/output_file2.comp}}` + +- Approximate the above command without a previously prepared file, by calculating expected frequencies using the single base/residue frequencies in the supplied input sequence(s): + +`compseq -sequence {{path/to/human_proteome.fasta}} -word 3 {{path/to/output_file.comp}} -nozero -calcfreq` + +- Display help (use `-help -verbose` for more information on associated and general qualifiers): + +`compseq -help` diff --git a/pages/linux/ctop.md b/pages/linux/ctop.md new file mode 100644 index 000000000..3e426eec7 --- /dev/null +++ b/pages/linux/ctop.md @@ -0,0 +1,20 @@ +# ctop + +> Instantly visualize container performance and health with real-time metrics on CPU, memory, and block IO usage. +> More information: . + +- Show only [a]ctive containers: + +`ctop -a` + +- [r]everse the container sort order: + +`ctop -r` + +- [i]nvert the default colors: + +`ctop -i` + +- Display [h]elp: + +`ctop -h` diff --git a/pages/linux/dconf-reset.md b/pages/linux/dconf-reset.md index 5752c659b..bcf4717fb 100644 --- a/pages/linux/dconf-reset.md +++ b/pages/linux/dconf-reset.md @@ -6,8 +6,8 @@ - Reset a specific key value: -`dconf read {{/path/to/key}}` +`dconf reset {{/path/to/key}}` - Reset a specific directory: -`dconf read -d {{/path/to/directory/}}` +`dconf reset -f {{/path/to/directory/}}` diff --git a/pages/linux/dd.md b/pages/linux/dd.md index 02b22516a..545dae5f8 100644 --- a/pages/linux/dd.md +++ b/pages/linux/dd.md @@ -5,11 +5,11 @@ - Make a bootable USB drive from an isohybrid file (such as `archlinux-xxx.iso`) and show the progress: -`dd status=progress if={{path/to/file.iso}} of={{/dev/usb_drive}}` +`dd if={{path/to/file.iso}} of={{/dev/usb_drive}} status=progress` - Clone a drive to another drive with 4 MiB block size and flush writes before the command terminates: -`dd bs={{4M}} conv={{fsync}} if={{/dev/source_drive}} of={{/dev/dest_drive}}` +`dd bs=4M conv=fsync if={{/dev/source_drive}} of={{/dev/dest_drive}}` - Generate a file with a specific number of random bytes by using kernel random driver: @@ -17,12 +17,12 @@ - Benchmark the write performance of a disk: -`dd bs={{1M}} count={{1000000}} if=/dev/zero of={{path/to/file_1GB}}` +`dd bs={{1M}} count={{1024}} if=/dev/zero of={{path/to/file_1GB}}` -- Create a system backup and save it into an IMG file (can be restored later by swapping `if` and `of`): +- Create a system backup, save it into an IMG file (can be restored later by swapping `if` and `of`), and show the progress: -`dd if={{/dev/drive_device}} of={{path/to/file.img}}` +`dd if={{/dev/drive_device}} of={{path/to/file.img}} status=progress` -- Check the progress of an ongoing dd operation (run this command from another shell): +- Check the progress of an ongoing `dd` operation (run this command from another shell): `kill -USR1 $(pgrep -x dd)` diff --git a/pages/linux/dhcpcd.md b/pages/linux/dhcpcd.md new file mode 100644 index 000000000..a6c10d311 --- /dev/null +++ b/pages/linux/dhcpcd.md @@ -0,0 +1,12 @@ +# dhcpcd + +> DHCP client. +> More information: . + +- Release all address leases: + +`sudo dhcpcd --release` + +- Request the DHCP server for new leases: + +`sudo dhcpcd --rebind` diff --git a/pages/linux/distrobox-list.md b/pages/linux/distrobox-list.md index dc1d740e0..5fd88840e 100644 --- a/pages/linux/distrobox-list.md +++ b/pages/linux/distrobox-list.md @@ -1,7 +1,7 @@ # distrobox-list > List all Distrobox containers. See also: `tldr distrobox`. -> Distrobox containers are listed separately from the rest of normal podman or Docker containers. +> Distrobox containers are listed separately from the rest of normal Podman or Docker containers. > More information: . - List all Distrobox containers: diff --git a/pages/linux/dmenu.md b/pages/linux/dmenu.md index 5201208a3..1c852b724 100644 --- a/pages/linux/dmenu.md +++ b/pages/linux/dmenu.md @@ -1,7 +1,7 @@ # dmenu > Dynamic menu. -> Creates a menu from a text input with each item on a new line. +> Create a menu from a text input with each item on a new line. > More information: . - Display a menu of the output of the `ls` command: diff --git a/pages/linux/dnf5.md b/pages/linux/dnf5.md new file mode 100644 index 000000000..ff4bc4e74 --- /dev/null +++ b/pages/linux/dnf5.md @@ -0,0 +1,38 @@ +# dnf5 + +> Package management utility for RHEL, Fedora, and CentOS (it replaces dnf, which in turn replaced yum). +> DNF5 is a C++ rewrite of the DNF package manager featuring improved performance and a smaller size. +> For equivalent commands in other package managers, see . +> More information: . + +- Upgrade installed packages to the newest available versions: + +`sudo dnf5 upgrade` + +- Search packages via keywords: + +`dnf5 search {{keyword1 keyword2 ...}}` + +- Display details about a package: + +`dnf5 info {{package}}` + +- Install new packages (Note: use `-y` to confirm all prompts automatically): + +`sudo dnf5 install {{package1 package2 ...}}` + +- Remove packages: + +`sudo dnf5 remove {{package1 package2 ...}}` + +- List installed packages: + +`dnf5 list --installed` + +- Find which packages provide a given command: + +`dnf5 provides {{command}}` + +- Remove or expire cached data: + +`sudo dnf5 clean all` diff --git a/pages/linux/dockerd.md b/pages/linux/dockerd.md index 3c68318bc..8d92e8334 100644 --- a/pages/linux/dockerd.md +++ b/pages/linux/dockerd.md @@ -1,13 +1,13 @@ # dockerd -> A persistent process to start and manage docker containers. -> More information: . +> A persistent process to start and manage Docker containers. +> More information: . -- Run docker daemon: +- Run Docker daemon: `dockerd` -- Run docker daemon and configure it to listen to specific sockets (UNIX and TCP): +- Run Docker daemon and configure it to listen to specific sockets (UNIX and TCP): `dockerd --host unix://{{path/to/tmp.sock}} --host tcp://{{ip}}` @@ -21,4 +21,4 @@ - Run and set a specific log level: -`dockerd --log-level={{debug|info|warn|error|fatal}}` +`dockerd --log-level {{debug|info|warn|error|fatal}}` diff --git a/pages/linux/dolphin.md b/pages/linux/dolphin.md index 022a89c54..cdbc47e1e 100644 --- a/pages/linux/dolphin.md +++ b/pages/linux/dolphin.md @@ -1,6 +1,7 @@ # dolphin > KDE's file manager to manage files and directories. +> See also: `nautilus`, `caja`, `thunar`, `ranger`. > More information: . - Launch the file manager: @@ -23,7 +24,7 @@ `dolphin --split {{path/to/directory1}} {{path/to/directory2}}` -- Launch the daemon (only required to use the DBus interface): +- Launch the daemon (only required to use the D-Bus interface): `dolphin --daemon` diff --git a/pages/linux/e2undo.md b/pages/linux/e2undo.md index 4faed7c70..84191f53a 100644 --- a/pages/linux/e2undo.md +++ b/pages/linux/e2undo.md @@ -2,7 +2,7 @@ > Replay undo logs for an ext2/ext3/ext4 filesystem. > This can be used to undo a failed operation by an e2fsprogs program. -> More information: . +> More information: . - Display information about a specific undo file: diff --git a/pages/linux/eopkg.md b/pages/linux/eopkg.md index b94037ef0..c6f440e54 100644 --- a/pages/linux/eopkg.md +++ b/pages/linux/eopkg.md @@ -1,7 +1,7 @@ # eopkg > Package manager for Solus. -> More information: . +> More information: . - Install a specific package: diff --git a/pages/linux/ethtool.md b/pages/linux/ethtool.md index 2d3484243..ec1383464 100644 --- a/pages/linux/ethtool.md +++ b/pages/linux/ethtool.md @@ -1,7 +1,7 @@ # ethtool > Display and modify Network Interface Controller (NIC) parameters. -> More information: . +> More information: . - Display the current settings for an interface: diff --git a/pages/linux/eu-readelf.md b/pages/linux/eu-readelf.md new file mode 100644 index 000000000..348c186a6 --- /dev/null +++ b/pages/linux/eu-readelf.md @@ -0,0 +1,12 @@ +# eu-readelf + +> Displays information about ELF files. +> More information: . + +- Display all extractable information contained in the ELF file: + +`eu-readelf --all {{path/to/file}}` + +- Display the contents of all NOTE segments/sections, or of a particular segment/section: + +`eu-readelf --notes[={{.note.ABI-tag}}] {{path/to/file}}` diff --git a/pages/linux/evtest.md b/pages/linux/evtest.md new file mode 100644 index 000000000..675b6396d --- /dev/null +++ b/pages/linux/evtest.md @@ -0,0 +1,20 @@ +# evtest + +> Display information from input device drivers. +> More information: . + +- List all detected input devices: + +`sudo evtest` + +- Display events from a specific input device: + +`sudo evtest /dev/input/event{{number}}` + +- Grab the device exclusively, preventing other clients from receiving events: + +`sudo evtest --grab /dev/input/event{{number}}` + +- Query the state of a specific key or button on an input device: + +`sudo evtest --query /dev/input/event{{number}} {{event_type}} {{event_code}}` diff --git a/pages/linux/export.md b/pages/linux/export.md index c9ef7df52..ffc36387c 100644 --- a/pages/linux/export.md +++ b/pages/linux/export.md @@ -18,3 +18,7 @@ - Append a pathname to the environment variable `PATH`: `export PATH=$PATH:{{path/to/append}}` + +- Display a list of active exported variables in shell command form: + +`export -p` diff --git a/pages/linux/faketime.md b/pages/linux/faketime.md index dab425b8f..32a796eaf 100644 --- a/pages/linux/faketime.md +++ b/pages/linux/faketime.md @@ -7,7 +7,7 @@ `faketime '{{today 23:30}}' {{date}}` -- Open a new `bash` shell, which uses yesterday as the current date: +- Open a new Bash shell, which uses yesterday as the current date: `faketime '{{yesterday}}' {{bash}}` diff --git a/pages/linux/fatlabel.md b/pages/linux/fatlabel.md index 1b100d305..b615b74de 100644 --- a/pages/linux/fatlabel.md +++ b/pages/linux/fatlabel.md @@ -1,6 +1,6 @@ # fatlabel -> Sets or gets the label of a FAT32 partition. +> Get or set the label of a FAT32 partition. > More information: . - Get the label of a FAT32 partition: diff --git a/pages/linux/feedreader.md b/pages/linux/feedreader.md index 9bf3feac2..5a51cef10 100644 --- a/pages/linux/feedreader.md +++ b/pages/linux/feedreader.md @@ -1,7 +1,8 @@ # feedreader > A GUI desktop RSS client. -> More information: . +> Note: FeedReader is no longer being maintained. +> More information: . - Print the count of unread articles: diff --git a/pages/linux/ffuf.md b/pages/linux/ffuf.md deleted file mode 100644 index 8b38af239..000000000 --- a/pages/linux/ffuf.md +++ /dev/null @@ -1,28 +0,0 @@ -# ffuf - -> Subdomain and directory discovery tool. -> More information: . - -- Discover directories using a [w]ordlist on a target [u]rl with [c]olorized and [v]erbose output: - -`ffuf -w {{path/to/wordlist}} -u {{https://target/FUZZ}} -c -v` - -- Fuzz host-[H]eaders with a host file on a target website and [m]atch HTTP 200 [c]ode responses: - -`ffuf -w {{hosts.txt}} -u {{https://example.org}} -H "{{Host: FUZZ}}" -mc {{200}}` - -- Discover directories using a [w]ordlist on a target website with a max individual job time of 60 seconds and recursion discovery depth of 2 levels: - -`ffuf -w {{path/to/wordlist}} -u {{https://target/FUZZ}} -maxtime-job {{60}} -recursion -recursion-depth {{2}}` - -- Fuzz GET parameter on a target website and [f]ilter out message [s]ize response of 4242 bytes: - -`ffuf -w {{path/to/param_names.txt}} -u {{https://target/script.php?FUZZ=test_value}} -fs {{4242}}` - -- Fuzz POST method with POST [d]ata of password on a target website and [f]ilter out HTTP response [c]ode 401: - -`ffuf -w {{path/to/postdata.txt}} -X {{POST}} -d "{{username=admin\&password=FUZZ}}" -u {{https://target/login.php}} -fc {{401}}` - -- Discover subdomains using a subdomain list on a target website: - -`ffuf -w {{subdomains.txt}} -u {{https://website.com}} -H "{{Host: FUZZ.website.com}}"` diff --git a/pages/linux/firejail.md b/pages/linux/firejail.md index 688a7481f..a7971e6c1 100644 --- a/pages/linux/firejail.md +++ b/pages/linux/firejail.md @@ -26,3 +26,11 @@ - Shutdown a running sandbox: `firejail --shutdown={{7777}}` + +- Run a restricted Firefox session to browse the internet: + +`firejail --seccomp --private --private-dev --private-tmp --protocol=inet firefox --new-instance --no-remote --safe-mode --private-window` + +- Use custom hosts file (overriding `/etc/hosts` file): + +`firejail --hosts-file={{~/myhosts}} {{curl http://mysite.arpa}}` diff --git a/pages/linux/genid.md b/pages/linux/genid.md deleted file mode 100644 index bc3da06f6..000000000 --- a/pages/linux/genid.md +++ /dev/null @@ -1,24 +0,0 @@ -# genid - -> Generate IDs, such as snowflakes, UUIDs, and a new GAID. -> More information: . - -- Generate a UUIDv4: - -`genid uuid` - -- Generate a UUIDv5 using a namespace UUID and a specific name: - -`genid uuidv5 {{ce598faa-8dd0-49ee-8525-9e24fff71dca}} {{name}}` - -- Generate a Discord Snowflake, without a trailing newline (useful in shell scripts): - -`genid --script snowflake` - -- Generate a Generic Anonymous ID with a specific "real ID": - -`genid gaid {{real_id}}` - -- Generate a Snowflake with the epoch set to a specific date: - -`genid snowflake --epoch={{unix_epoch_time}}` diff --git a/pages/linux/getenforce.md b/pages/linux/getenforce.md new file mode 100644 index 000000000..e06be2f0f --- /dev/null +++ b/pages/linux/getenforce.md @@ -0,0 +1,9 @@ +# getenforce + +> Get the current mode of SELinux (i.e. enforcing, permissive, or disabled). +> See also: `setenforce`, `semanage-permissive`. +> More information: . + +- Display the current mode of SELinux: + +`getenforce` diff --git a/pages/linux/getsebool.md b/pages/linux/getsebool.md new file mode 100644 index 000000000..aafd10234 --- /dev/null +++ b/pages/linux/getsebool.md @@ -0,0 +1,17 @@ +# getsebool + +> Get SELinux boolean value. +> See also: `semanage-boolean`, `setsebool`. +> More information: . + +- Show the current setting of a boolean: + +`getsebool {{httpd_can_connect_ftp}}` + +- Show the current setting of [a]ll booleans: + +`getsebool -a` + +- Show the current setting of all booleans with explanations: + +`sudo semanage boolean {{-l|--list}}` diff --git a/pages/linux/groupmod.md b/pages/linux/groupmod.md index 0a59edaa6..3bc8f8b25 100644 --- a/pages/linux/groupmod.md +++ b/pages/linux/groupmod.md @@ -8,6 +8,6 @@ `sudo groupmod --new-name {{new_group}} {{group_name}}` -- Change the group id: +- Change the group ID: `sudo groupmod --gid {{new_id}} {{group_name}}` diff --git a/pages/linux/grub-editenv.md b/pages/linux/grub-editenv.md index 03baa0bf8..1b3fa45c4 100644 --- a/pages/linux/grub-editenv.md +++ b/pages/linux/grub-editenv.md @@ -15,6 +15,6 @@ `grub-editenv /boot/grub/grubenv unset saved_entry` -- Append "quiet splash" to the kernel command line: +- Append "quiet splash" to the kernel command-line: `grub-editenv /boot/grub/grubenv list kernel_cmdline` diff --git a/pages/linux/gummy.md b/pages/linux/gummy.md index a19674672..5e5088b2e 100644 --- a/pages/linux/gummy.md +++ b/pages/linux/gummy.md @@ -1,7 +1,7 @@ # gummy > Screen brightness/temperature manager for Linux/X11. -> More information: . +> More information: . - Set the screen temperature to 3000K: diff --git a/pages/linux/hdparm.md b/pages/linux/hdparm.md index fda072246..89da8d650 100644 --- a/pages/linux/hdparm.md +++ b/pages/linux/hdparm.md @@ -5,23 +5,23 @@ - Request the identification info of a given device: -`sudo hdparm -I /dev/{{device}}` +`sudo hdparm -I {{/dev/device}}` - Get the Advanced Power Management level: -`sudo hdparm -B /dev/{{device}}` +`sudo hdparm -B {{/dev/device}}` - Set the Advanced Power Management value (values 1-127 permit spin-down, and values 128-254 do not): -`sudo hdparm -B {{1}} /dev/{{device}}` +`sudo hdparm -B {{1}} {{/dev/device}}` - Display the device's current power mode status: -`sudo hdparm -C /dev/{{device}}` +`sudo hdparm -C {{/dev/device}}` - Force a drive to immediately enter standby mode (usually causes a drive to spin down): -`sudo hdparm -y /dev/{{device}}` +`sudo hdparm -y {{/dev/device}}` - Put the drive into idle (low-power) mode, also setting its standby timeout: diff --git a/pages/linux/homeshick.md b/pages/linux/homeshick.md index cece7f486..ed38436b9 100644 --- a/pages/linux/homeshick.md +++ b/pages/linux/homeshick.md @@ -1,6 +1,7 @@ # homeshick > Synchronize Git dotfiles. +> See also: `chezmoi`, `stow`, `tuckr`, `vcsh`. > More information: . - Create a new castle: diff --git a/pages/linux/hyprctl.md b/pages/linux/hyprctl.md new file mode 100644 index 000000000..156e97544 --- /dev/null +++ b/pages/linux/hyprctl.md @@ -0,0 +1,32 @@ +# hyprctl + +> Control parts of the Hyprland Wayland compositor. +> More information: . + +- Reload Hyprland configuration: + +`hyprctl reload` + +- Return the active window name: + +`hyprctl activewindow` + +- List all connected input devices: + +`hyprctl devices` + +- List all outputs with respective properties: + +`hyprctl workspaces` + +- Call a dispatcher with an argument: + +`hyprctl dispatch exec {{app}}` + +- Set a configuration keyword dynamically: + +`hyprctl keyword {{keyword}} {{value}}` + +- Display version: + +`hyprctl version` diff --git a/pages/linux/hyprpm.md b/pages/linux/hyprpm.md new file mode 100644 index 000000000..42fae2620 --- /dev/null +++ b/pages/linux/hyprpm.md @@ -0,0 +1,32 @@ +# hyprpm + +> Control plugins for the Hyprland Wayland compositor. +> More information: . + +- Add a plugin: + +`hyprpm add {{git_url}}` + +- Remove a plugin: + +`hyprpm remove {{git_url|plugin_name}}` + +- Enable a plugin: + +`hyprpm enable {{plugin_name}}` + +- Disable a plugin: + +`hyprpm disable {{plugin_name}}` + +- Update and check all plugins: + +`hyprpm update` + +- Force an operation: + +`hyprpm {{-f|--force}} {{operation}}` + +- List all installed plugins: + +`hyprpm list` diff --git a/pages/linux/ico.md b/pages/linux/ico.md index e494fa96d..8bcc0cfff 100644 --- a/pages/linux/ico.md +++ b/pages/linux/ico.md @@ -1,6 +1,6 @@ # ico -> Displays an animation of a polyhedron. +> Display an animation of a polyhedron. > More information: . - Display the wireframe of an icosahedron that changes its position every 0.1 seconds: diff --git a/pages/linux/id3v2.md b/pages/linux/id3v2.md index 77cf55914..0a4c9d93d 100644 --- a/pages/linux/id3v2.md +++ b/pages/linux/id3v2.md @@ -1,6 +1,6 @@ # id3v2 -> Manages id3v2 tags, converts and lists id3v1. +> Manage id3v2 tags, converts and lists id3v1. > More information: . - List all genres: @@ -9,7 +9,7 @@ - List all tags of specific files: -`id3v2 --list-tags {{path/to/file1 path/to/file2 ...}}` +`id3v2 --list {{path/to/file1 path/to/file2 ...}}` - Delete all `id3v2` or `id3v1` tags of specific files: diff --git a/pages/linux/ip-link.md b/pages/linux/ip-link.md index 5dc3c0e63..ad90f5156 100644 --- a/pages/linux/ip-link.md +++ b/pages/linux/ip-link.md @@ -1,7 +1,7 @@ # ip link > Manage network interfaces. -> More information: . +> More information: . - Show information about all network interfaces: diff --git a/pages/linux/ip-rule.md b/pages/linux/ip-rule.md index 46b729051..cbb5e058c 100644 --- a/pages/linux/ip-rule.md +++ b/pages/linux/ip-rule.md @@ -1,7 +1,7 @@ # ip rule > IP routing policy database management. -> More information: . +> More information: . - Display the routing policy: diff --git a/pages/linux/ip.md b/pages/linux/ip.md index 110584516..51cb93e56 100644 --- a/pages/linux/ip.md +++ b/pages/linux/ip.md @@ -2,7 +2,7 @@ > Show/manipulate routing, devices, policy routing and tunnels. > Some subcommands such as `ip address` have their own usage documentation. -> More information: . +> More information: . - List interfaces with detailed info: diff --git a/pages/linux/ipcs.md b/pages/linux/ipcs.md new file mode 100644 index 000000000..a913e6e3e --- /dev/null +++ b/pages/linux/ipcs.md @@ -0,0 +1,37 @@ +# ipcs + +> Show information about the usage of System V IPC facilities: shared memory segments, message queues, and semaphore arrays. +> See also: `lsipc` for a more flexible tool, `ipcmk` for creating IPC facilities, and `ipcrm` for deleting them. +> More information: . + +- Show information about all active IPC facilities: + +`ipcs` + +- Show information about active shared [m]emory segments, message [q]ueues or [s]empahore sets: + +`ipcs {{--shmems|--queues|--semaphores}}` + +- Show full details on the resource with a specific [i]D: + +`ipcs {{--shmems|--queues|--semaphores}} --id {{resource_id}}` + +- Show [l]imits in [b]ytes or in a human-readable format: + +`ipcs --limits {{--bytes|--human}}` + +- Show s[u]mmary about current usage: + +`ipcs --summary` + +- Show [c]reator's and owner's UIDs and PIDs for all IPC facilities: + +`ipcs --creator` + +- Show the [p]ID of the last operators for all IPC facilities: + +`ipcs --pid` + +- Show last access [t]imes for all IPC facilities: + +`ipcs --time` diff --git a/pages/linux/iptables-save.md b/pages/linux/iptables-save.md index 655aaa688..b0d241ca5 100644 --- a/pages/linux/iptables-save.md +++ b/pages/linux/iptables-save.md @@ -1,7 +1,7 @@ # iptables-save > Save the `iptables` IPv4 configuration. -> Use `ip6tables-save` to to the same for IPv6. +> Use `ip6tables-save` to do the same for IPv6. > More information: . - Print the `iptables` configuration: diff --git a/pages/linux/journalctl.md b/pages/linux/journalctl.md index e447ec1df..6fb38e2c9 100644 --- a/pages/linux/journalctl.md +++ b/pages/linux/journalctl.md @@ -11,9 +11,9 @@ `journalctl --vacuum-time={{2d}}` -- [f]ollow new messages (like `tail -f` for traditional syslog): +- Show only the last N li[n]es and [f]ollow new messages (like `tail -f` for traditional syslog): -`journalctl -f` +`journalctl --lines {{N}} --follow` - Show all messages by a specific [u]nit: diff --git a/pages/linux/kdialog.md b/pages/linux/kdialog.md index 737b58731..48ffe4360 100644 --- a/pages/linux/kdialog.md +++ b/pages/linux/kdialog.md @@ -1,7 +1,7 @@ # kdialog > Show KDE dialog boxes from within shell scripts. -> More information: . +> More information: . - Open a dialog box displaying a specific message: @@ -31,6 +31,6 @@ `kdialog --getopenfilename` -- Open a progressbar dialog and print a DBUS reference for communication to `stdout`: +- Open a progressbar dialog and print a D-Bus reference for communication to `stdout`: `kdialog --progressbar "{{message}}"` diff --git a/pages/linux/kill.md b/pages/linux/kill.md index fe9c3d4bd..e5b071050 100644 --- a/pages/linux/kill.md +++ b/pages/linux/kill.md @@ -10,7 +10,7 @@ - List signal values and their corresponding names (to be used without the `SIG` prefix): -`kill -{{L|-table}}` +`kill {{-L|--table}}` - Terminate a background job: diff --git a/pages/linux/krfb-virtualmonitor.md b/pages/linux/krfb-virtualmonitor.md new file mode 100644 index 000000000..6a44c51cb --- /dev/null +++ b/pages/linux/krfb-virtualmonitor.md @@ -0,0 +1,8 @@ +# krfb-virtualmonitor + +> Create a virtual monitor and allow that monitor to be used with VNC. +> More information: . + +- Create a virtual monitor: + +`krfb-virtualmonitor --resolution {{1920}}x{{1080}} --name {{monitor_name}} --password {{password}} --port {{5900}}` diff --git a/pages/linux/last.md b/pages/linux/last.md new file mode 100644 index 000000000..c6000b467 --- /dev/null +++ b/pages/linux/last.md @@ -0,0 +1,37 @@ +# last + +> List information of last user logins. +> See also: `lastb`, `login`. +> More information: . + +- List login information (e.g., username, terminal, boot time, kernel) of all users: + +`last` + +- List login information of a specific user: + +`last {{username}}` + +- List information of a specific TTY: + +`last {{tty1}}` + +- List most recent information (by default, the newest are at the top): + +`last | tac` + +- List information of system boots: + +`last "{{system boot}}"` + +- List information with a specific [t]imestamp format: + +`last --time-format {{notime|full|iso}}` + +- List information [s]ince a specific time and date: + +`last --since {{-7days}}` + +- List information (i.e., hostname and IP) of remote hosts: + +`last --dns` diff --git a/pages/linux/look.md b/pages/linux/look.md index 6d50adeba..ac1c73837 100644 --- a/pages/linux/look.md +++ b/pages/linux/look.md @@ -11,11 +11,11 @@ - Case-insensitively search only on blank and alphanumeric characters: -`look -{{f|-ignore-case}} -{{d|-alphanum}} {{prefix}} {{path/to/file}}` +`look {{-f|--ignore-case}} {{-d|--alphanum}} {{prefix}} {{path/to/file}}` -- Specify a string [t]ermination character (space by default): +- Specify a string termination character (space by default): -`look -{t|-terminate} {{,}}` +`look {{-t|--terminate}} {{,}}` - Search in `/usr/share/dict/words` (`--ignore-case` and `--alphanum` are assumed): @@ -23,4 +23,4 @@ - Search in `/usr/share/dict/web2` (`--ignore-case` and `--alphanum` are assumed): -`look -{{a|-alternative}} {{prefix}}` +`look {{-a|--alternative}} {{prefix}}` diff --git a/pages/linux/losetup.md b/pages/linux/losetup.md index 78a47064c..2bb5fbf0e 100644 --- a/pages/linux/losetup.md +++ b/pages/linux/losetup.md @@ -9,7 +9,7 @@ - Attach a file to a given loop device: -`sudo losetup /dev/{{loop}} /{{path/to/file}}` +`sudo losetup {{/dev/loop}} /{{path/to/file}}` - Attach a file to a new free loop device and scan the device for partitions: @@ -17,7 +17,7 @@ - Attach a file to a read-only loop device: -`sudo losetup --read-only /dev/{{loop}} /{{path/to/file}}` +`sudo losetup --read-only {{/dev/loop}} /{{path/to/file}}` - Detach all loop devices: @@ -25,4 +25,4 @@ - Detach a given loop device: -`sudo losetup -d /dev/{{loop}}` +`sudo losetup -d {{/dev/loop}}` diff --git a/pages/linux/lrztar.md b/pages/linux/lrztar.md index 3099859fe..7c9761ada 100644 --- a/pages/linux/lrztar.md +++ b/pages/linux/lrztar.md @@ -4,7 +4,7 @@ > See also: `tar`, `lrzuntar`, `lrunzip`. > More information: . -- Archive a directory with `tar`, then compress: +- Archive a directory with tar, then compress: `lrztar {{path/to/directory}}` diff --git a/pages/linux/lsb_release.md b/pages/linux/lsb_release.md index fd54439aa..9f980c478 100644 --- a/pages/linux/lsb_release.md +++ b/pages/linux/lsb_release.md @@ -1,6 +1,6 @@ # lsb_release -> Provides certain LSB (Linux Standard Base) and distribution-specific information. +> Get LSB (Linux Standard Base) and distribution-specific information. > More information: . - Print all available information: diff --git a/pages/linux/lscpu.md b/pages/linux/lscpu.md index 2d5c72a69..64b8618a1 100644 --- a/pages/linux/lscpu.md +++ b/pages/linux/lscpu.md @@ -1,6 +1,6 @@ # lscpu -> Displays information about the CPU architecture. +> Display information about the CPU architecture. > More information: . - Display information about all CPUs: diff --git a/pages/linux/lsipc.md b/pages/linux/lsipc.md new file mode 100644 index 000000000..7862f39f8 --- /dev/null +++ b/pages/linux/lsipc.md @@ -0,0 +1,29 @@ +# lsipc + +> Show information on System V IPC facilities currently employed in the system. +> See also: `ipcs` for the older tool. +> More information: . + +- Show information about all active IPC facilities: + +`lsipc` + +- Show information about active shared [m]emory segments, message [q]ueues or [s]empahore sets: + +`lsipc {{--shmems|--queues|--semaphores}}` + +- Show full details on the resource with a specific [i]D: + +`lsipc {{--shmems|--queues|--semaphores}} --id {{resource_id}}` + +- Print the given [o]utput columns (see all supported columns with `--help`): + +`lsipc --output {{KEY,ID,PERMS,SEND,STATUS,NSEMS,RESOURCE,...}}` + +- Use [r]aw, [J]SON, [l]ist or [e]xport (key="value") format: + +`lsipc {{--raw|--json|--list|--export}}` + +- Don't truncate the output: + +`lsipc --notruncate` diff --git a/pages/linux/lslogins.md b/pages/linux/lslogins.md index 44079339e..54f16a99d 100644 --- a/pages/linux/lslogins.md +++ b/pages/linux/lslogins.md @@ -1,7 +1,7 @@ # lslogins > Show information about users on a Linux system. -> More information: . +> More information: . - Display users in the system: diff --git a/pages/linux/lsns.md b/pages/linux/lsns.md index 8ffa45709..898709ead 100644 --- a/pages/linux/lsns.md +++ b/pages/linux/lsns.md @@ -1,7 +1,7 @@ # lsns > List information about all namespaces or about the specified namespace. -> More information: . +> More information: . - List all namespaces: diff --git a/pages/linux/lvcreate.md b/pages/linux/lvcreate.md index 9c6a2983c..3b93e9f6c 100644 --- a/pages/linux/lvcreate.md +++ b/pages/linux/lvcreate.md @@ -2,7 +2,7 @@ > Create a logical volume in an existing volume group. A volume group is a collection of logical and physical volumes. > See also: `lvm`. -> More information: . +> More information: . - Create a logical volume of 10 gigabytes in the volume group vg1: diff --git a/pages/linux/lvdisplay.md b/pages/linux/lvdisplay.md index e3c0268d3..da802d840 100644 --- a/pages/linux/lvdisplay.md +++ b/pages/linux/lvdisplay.md @@ -2,7 +2,7 @@ > Display information about Logical Volume Manager (LVM) logical volumes. > See also: `lvm`. -> More information: . +> More information: . - Display information about all logical volumes: diff --git a/pages/linux/lvm.md b/pages/linux/lvm.md index 571d96477..abb58691a 100644 --- a/pages/linux/lvm.md +++ b/pages/linux/lvm.md @@ -1,7 +1,7 @@ # lvm > Manage physical volumes, volume groups, and logical volumes using the Logical Volume Manager (LVM) interactive shell. -> More information: . +> More information: . - Start the Logical Volume Manager interactive shell: diff --git a/pages/linux/lvreduce.md b/pages/linux/lvreduce.md index 62053ce6e..10bc7c48e 100644 --- a/pages/linux/lvreduce.md +++ b/pages/linux/lvreduce.md @@ -2,7 +2,7 @@ > Reduce the size of a logical volume. > See also: `lvm`. -> More information: . +> More information: . - Reduce a volume's size to 120 GB: diff --git a/pages/linux/lvremove.md b/pages/linux/lvremove.md index 76b38ba9f..350f8cccc 100644 --- a/pages/linux/lvremove.md +++ b/pages/linux/lvremove.md @@ -2,7 +2,7 @@ > Remove logical volumes. > See also: `lvm`. -> More information: . +> More information: . - Remove a logical volume in a volume group: diff --git a/pages/linux/lvresize.md b/pages/linux/lvresize.md index a5dea44a8..44f1546ea 100644 --- a/pages/linux/lvresize.md +++ b/pages/linux/lvresize.md @@ -2,7 +2,7 @@ > Change the size of a logical volume. > See also: `lvm`. -> More information: . +> More information: . - Change the size of a logical volume to 120 GB: diff --git a/pages/linux/lvs.md b/pages/linux/lvs.md index e03f9481e..22b7afe33 100644 --- a/pages/linux/lvs.md +++ b/pages/linux/lvs.md @@ -2,7 +2,7 @@ > Display information about logical volumes. > See also: `lvm`. -> More information: . +> More information: . - Display information about logical volumes: diff --git a/pages/linux/lxterminal.md b/pages/linux/lxterminal.md index d4ce43035..7dadd2444 100644 --- a/pages/linux/lxterminal.md +++ b/pages/linux/lxterminal.md @@ -1,7 +1,7 @@ # lxterminal > Terminal emulator for LXDE. -> More information: . +> More information: . - Open an LXTerminal window: diff --git a/pages/linux/man.md b/pages/linux/man.md index e41b01cbe..c5fc60646 100644 --- a/pages/linux/man.md +++ b/pages/linux/man.md @@ -29,7 +29,7 @@ - Display the man page using a specific locale: -`man --locale={{locale}} {{command}}` +`man --locale {{locale}} {{command}}` - Search for manpages containing a search string: diff --git a/pages/linux/mandb.md b/pages/linux/mandb.md index ddb5e6f03..40ed80116 100644 --- a/pages/linux/mandb.md +++ b/pages/linux/mandb.md @@ -1,7 +1,7 @@ # mandb > Manage the pre-formatted manual page database. -> More information: . +> More information: . - Purge and process manual pages: diff --git a/pages/linux/mashtree.md b/pages/linux/mashtree.md index 224c2e2a5..b2692cc86 100644 --- a/pages/linux/mashtree.md +++ b/pages/linux/mashtree.md @@ -1,6 +1,6 @@ # mashtree -> Makes a fast tree from genomes. +> Make a fast tree from genomes. > Does not make a phylogeny. > More information: . diff --git a/pages/linux/matchpathcon.md b/pages/linux/matchpathcon.md new file mode 100644 index 000000000..ed451678d --- /dev/null +++ b/pages/linux/matchpathcon.md @@ -0,0 +1,17 @@ +# matchpathcon + +> Lookup the persistent SELinux security context setting of a path. +> See also: `semanage-fcontext`, `secon`, `chcon`, `restorecon`. +> More information: . + +- Lookup the persistent security context setting of an absolute path: + +`matchpathcon {{/path/to/file}}` + +- Restrict lookup to settings on a specific file type: + +`matchpathcon -m {{file|dir|pipe|chr_file|blk_file|lnk_file|sock_file}} {{/path/to/file}}` + +- [V]erify that the persistent and current security context of a path agree: + +`matchpathcon -V {{/path/to/file}}` diff --git a/pages/linux/mke2fs.md b/pages/linux/mke2fs.md index 9301f55af..fff11fb3f 100644 --- a/pages/linux/mke2fs.md +++ b/pages/linux/mke2fs.md @@ -1,6 +1,6 @@ # mke2fs -> Creates a Linux filesystem inside a partition. +> Create a Linux filesystem inside a partition. > More information: . - Create an ext2 filesystem in partition 1 of device b (`sdb1`): diff --git a/pages/linux/mkfs.cramfs.md b/pages/linux/mkfs.cramfs.md index f2341b5b8..0fa2b6dcf 100644 --- a/pages/linux/mkfs.cramfs.md +++ b/pages/linux/mkfs.cramfs.md @@ -1,6 +1,6 @@ # mkfs.cramfs -> Creates a ROM filesystem inside a partition. +> Create a ROM filesystem inside a partition. > More information: . - Create a ROM filesystem inside partition 1 on device b (`sdb1`): diff --git a/pages/linux/mkfs.exfat.md b/pages/linux/mkfs.exfat.md index da5213a74..464b8d6c1 100644 --- a/pages/linux/mkfs.exfat.md +++ b/pages/linux/mkfs.exfat.md @@ -1,6 +1,6 @@ # mkfs.exfat -> Creates an exfat filesystem inside a partition. +> Create an exfat filesystem inside a partition. > More information: . - Create an exfat filesystem inside partition 1 on device b (`sdb1`): diff --git a/pages/linux/mkfs.ext4.md b/pages/linux/mkfs.ext4.md index aa479958b..190eb86d5 100644 --- a/pages/linux/mkfs.ext4.md +++ b/pages/linux/mkfs.ext4.md @@ -1,6 +1,6 @@ # mkfs.ext4 -> Creates an ext4 filesystem inside a partition. +> Create an ext4 filesystem inside a partition. > More information: . - Create an ext4 filesystem inside partition 1 on device b (`sdb1`): diff --git a/pages/linux/mkfs.f2fs.md b/pages/linux/mkfs.f2fs.md new file mode 100644 index 000000000..b320882d6 --- /dev/null +++ b/pages/linux/mkfs.f2fs.md @@ -0,0 +1,12 @@ +# mkfs.f2fs + +> Create an F2FS filesystem inside a partition. +> More information: . + +- Create an F2FS filesystem inside partition 1 on device b (`sdb1`): + +`sudo mkfs.f2fs {{/dev/sdb1}}` + +- Create an F2FS filesystem with a volume label: + +`sudo mkfs.f2fs -l {{volume_label}} {{/dev/sdb1}}` diff --git a/pages/linux/mkfs.fat.md b/pages/linux/mkfs.fat.md index 3c44843a7..8e483e40a 100644 --- a/pages/linux/mkfs.fat.md +++ b/pages/linux/mkfs.fat.md @@ -1,6 +1,6 @@ # mkfs.fat -> Creates an MS-DOS filesystem inside a partition. +> Create an MS-DOS filesystem inside a partition. > More information: . - Create a fat filesystem inside partition 1 on device b (`sdb1`): diff --git a/pages/linux/mkfs.minix.md b/pages/linux/mkfs.minix.md index d7903fcce..ba3905052 100644 --- a/pages/linux/mkfs.minix.md +++ b/pages/linux/mkfs.minix.md @@ -1,6 +1,6 @@ # mkfs.minix -> Creates a Minix filesystem inside a partition. +> Create a Minix filesystem inside a partition. > More information: . - Create a Minix filesystem inside partition 1 on device b (`sdb1`): diff --git a/pages/linux/mkfs.ntfs.md b/pages/linux/mkfs.ntfs.md index 836b854cc..a72584205 100644 --- a/pages/linux/mkfs.ntfs.md +++ b/pages/linux/mkfs.ntfs.md @@ -1,6 +1,6 @@ # mkfs.ntfs -> Creates a NTFS filesystem inside a partition. +> Create a NTFS filesystem inside a partition. > More information: . - Create a NTFS filesystem inside partition 1 on device b (`sdb1`): diff --git a/pages/linux/mkfs.vfat.md b/pages/linux/mkfs.vfat.md index 9a9e24c2b..22bd41d1c 100644 --- a/pages/linux/mkfs.vfat.md +++ b/pages/linux/mkfs.vfat.md @@ -1,6 +1,6 @@ # mkfs.vfat -> Creates an MS-DOS filesystem inside a partition. +> Create an MS-DOS filesystem inside a partition. > More information: . - Create a vfat filesystem inside partition 1 on device b (`sdb1`): diff --git a/pages/linux/mksquashfs.md b/pages/linux/mksquashfs.md index efe7bba98..bc9f836b5 100644 --- a/pages/linux/mksquashfs.md +++ b/pages/linux/mksquashfs.md @@ -15,7 +15,7 @@ `mksquashfs {{path/to/file_or_directory1 path/to/file_or_directory2 ...}} {{filesystem.squashfs}} -e {{file|directory1 file|directory2 ...}}` -- Create or append files and directories to a squashfs filesystem, [e]xcluding those ending with `.gz`: +- Create or append files and directories to a squashfs filesystem, [e]xcluding those ending with gzip: `mksquashfs {{path/to/file_or_directory1 path/to/file_or_directory2 ...}} {{filesystem.squashfs}} -wildcards -e "{{*.gz}}"` diff --git a/pages/linux/mlabel.md b/pages/linux/mlabel.md index 005c5af29..9eb711c8e 100644 --- a/pages/linux/mlabel.md +++ b/pages/linux/mlabel.md @@ -5,4 +5,4 @@ - Set a filesystem label: -`mlabel -i /dev/{{sda}} ::"{{new_label}}"` +`mlabel -i {{/dev/sda}} ::"{{new_label}}"` diff --git a/pages/linux/mopac.md b/pages/linux/mopac.md new file mode 100644 index 000000000..b752e260b --- /dev/null +++ b/pages/linux/mopac.md @@ -0,0 +1,12 @@ +# mopac + +> MOPAC (Molecular Orbital PACkage) is a semiempirical quantum chemistry program based on Dewar and Thiel's NDDO approximation. +> More information: . + +- Perform calculations according to an input file (`.mop`, `.dat`, and `.arc`): + +`mopac {{path/to/input_file}}` + +- Minimal working example with HF that writes to the current directory and streams the output file: + +`touch test.out; echo "PM7\n#comment\n\nH 0.95506 0.05781 -0.03133\nF 1.89426 0.05781 -0.03133" > test.mop; mopac test.mop & tail -f test.out` diff --git a/pages/linux/mount.ddi.md b/pages/linux/mount.ddi.md index b21e42754..d76369a72 100644 --- a/pages/linux/mount.ddi.md +++ b/pages/linux/mount.ddi.md @@ -1,7 +1,7 @@ # mount.ddi > Mount Discoverable Disk Images. -> See `tldr systemd-dissect` for other commands relevant to DDIs. +> See also: `systemd-dissect` for other commands relevant to DDIs. > More information: . - Mount an OS image: diff --git a/pages/linux/nautilus.md b/pages/linux/nautilus.md index 66b90143a..2b643cf79 100644 --- a/pages/linux/nautilus.md +++ b/pages/linux/nautilus.md @@ -2,6 +2,7 @@ > Default file explorer for GNOME desktop environment. > Also known as GNOME Files. +> See also: `dolphin`, `caja`, `thunar`, `vifm`. > More information: . - Launch Nautilus: diff --git a/pages/linux/navi.md b/pages/linux/navi.md index 7af717f35..60b1b1326 100644 --- a/pages/linux/navi.md +++ b/pages/linux/navi.md @@ -1,6 +1,6 @@ # navi -> An interactive cheatsheet tool for the command line and application launchers. +> An interactive cheatsheet tool for the command-line and application launchers. > More information: . - Browse through all available cheatsheets: diff --git a/pages/linux/nemo.md b/pages/linux/nemo.md index c67fc8e0c..82b2a67b7 100644 --- a/pages/linux/nemo.md +++ b/pages/linux/nemo.md @@ -1,6 +1,6 @@ # nemo -> Manages files and directories in Cinnamon desktop environment. +> Manage files and directories in Cinnamon desktop environment. > More information: . - Open the current user home directory: diff --git a/pages/linux/nsenter.md b/pages/linux/nsenter.md index 309b0d502..242d9f533 100644 --- a/pages/linux/nsenter.md +++ b/pages/linux/nsenter.md @@ -1,7 +1,7 @@ # nsenter > Run a new command in a running process' namespace. -> Particularly useful for docker images or chroot jails. +> Particularly useful for Docker images or chroot jails. > More information: . - Run a specific command using the same namespaces as an existing process: diff --git a/pages/linux/ntpd.md b/pages/linux/ntpd.md new file mode 100644 index 000000000..cb0874454 --- /dev/null +++ b/pages/linux/ntpd.md @@ -0,0 +1,16 @@ +# ntpd + +> The official NTP (Network Time Protocol) daemon to synchronize the system clock to remote time servers or local reference clocks. +> More information: . + +- Start the daemon: + +`sudo ntpd` + +- Synchronize system time with remote servers a single time (quit after synchronizing): + +`sudo ntpd --quit` + +- Synchronize a single time allowing "Big" adjustments: + +`sudo ntpd --panicgate --quit` diff --git a/pages/linux/ntpdate.md b/pages/linux/ntpdate.md index faf68c452..54eaaea8f 100644 --- a/pages/linux/ntpdate.md +++ b/pages/linux/ntpdate.md @@ -1,7 +1,7 @@ # ntpdate > Synchronize and set the date and time via NTP. -> More information: . +> More information: . - Synchronize and set date and time: diff --git a/pages/linux/numactl.md b/pages/linux/numactl.md index 25545386e..3924f8718 100644 --- a/pages/linux/numactl.md +++ b/pages/linux/numactl.md @@ -1,7 +1,7 @@ # numactl > Control NUMA policy for processes or shared memory. -> More information: . +> More information: . - Run a command on node 0 with memory allocated on node 0 and 1: diff --git a/pages/linux/obabel.md b/pages/linux/obabel.md index 3c0ef0169..e9b8307df 100644 --- a/pages/linux/obabel.md +++ b/pages/linux/obabel.md @@ -1,7 +1,7 @@ # obabel > Translate chemistry-related data. -> More information: . +> More information: . - Convert a .mol file to XYZ coordinates: @@ -9,7 +9,7 @@ - Convert a SMILES string to a 500x500 picture: -`obabel -:"{{SMILES}} -O {{path/to/output_file.png}} -xp 500` +`obabel -:"{{SMILES}}" -O {{path/to/output_file.png}} -xp 500` - Convert a file of SMILES string to separate 3D .mol files: diff --git a/pages/linux/objcopy.md b/pages/linux/objcopy.md new file mode 100644 index 000000000..0fa6b238e --- /dev/null +++ b/pages/linux/objcopy.md @@ -0,0 +1,24 @@ +# objcopy + +> Copy the contents of an object file to another file. +> More information: . + +- Copy data to another file: + +`objcopy {{path/to/source_file}} {{path/to/target_file}}` + +- Translate object files from one format to another: + +`objcopy --input-target={{input_format}} --output-target {{output_format}} {{path/to/source_file}} {{path/to/target_file}}` + +- Strip all symbol information from the file: + +`objcopy --strip-all {{path/to/source_file}} {{path/to/target_file}}` + +- Strip debugging information from the file: + +`objcopy --strip-debug {{path/to/source_file}} {{path/to/target_file}}` + +- Copy a specific section from the source file to the destination file: + +`objcopy --only-section {{section}} {{path/to/source_file}} {{path/to/target_file}}` diff --git a/pages/linux/partx.md b/pages/linux/partx.md index f42adc475..50df5e007 100644 --- a/pages/linux/partx.md +++ b/pages/linux/partx.md @@ -1,7 +1,7 @@ # partx > Parse a partition table and tell the kernel about it. -> More information: . +> More information: . - List the partitions on a block device or disk image: diff --git a/pages/linux/pidof.md b/pages/linux/pidof.md index f5f1c2710..2fe0f2a00 100644 --- a/pages/linux/pidof.md +++ b/pages/linux/pidof.md @@ -1,6 +1,6 @@ # pidof -> Gets the ID of a process using its name. +> Get the ID of a process using its name. > More information: . - List all process IDs with given name: diff --git a/pages/linux/pidstat.md b/pages/linux/pidstat.md index 554394c5b..3be8406cf 100644 --- a/pages/linux/pidstat.md +++ b/pages/linux/pidstat.md @@ -11,7 +11,7 @@ `pidstat -r` -- Show input/output usage per process id: +- Show input/output usage per process ID: `pidstat -d` diff --git a/pages/linux/pkgctl-db-update.md b/pages/linux/pkgctl-db-update.md index 2ac713704..94ccc9b5b 100644 --- a/pages/linux/pkgctl-db-update.md +++ b/pages/linux/pkgctl-db-update.md @@ -1,6 +1,6 @@ # pkgctl db update -> Update the `pacman` database as final release step for packages that have been transfered and staged on . +> Update the `pacman` database as final release step for packages that have been transferred and staged on . > More information: . - Update the binary repository as final release step: diff --git a/pages/linux/pmap.md b/pages/linux/pmap.md index 812f4569c..44579bf24 100644 --- a/pages/linux/pmap.md +++ b/pages/linux/pmap.md @@ -3,7 +3,7 @@ > Report memory map of a process or processes. > More information: . -- Print memory map for a specific process id (PID): +- Print memory map for a specific process ID (PID): `pmap {{pid}}` diff --git a/pages/linux/pngcheck.md b/pages/linux/pngcheck.md index 466b56989..e508d8b43 100644 --- a/pages/linux/pngcheck.md +++ b/pages/linux/pngcheck.md @@ -1,6 +1,6 @@ # pngcheck -> Forensics tool for validating the integrity of PNG based (`.png`, `.jng`, `.mng`) image files. +> Forensics tool for validating the integrity of PNG based (PNG, JNG, MNG) image files. > Can also extract embedded images and text from a file. > More information: . diff --git a/pages/linux/poweroff.md b/pages/linux/poweroff.md index 875e45498..c3135808a 100644 --- a/pages/linux/poweroff.md +++ b/pages/linux/poweroff.md @@ -1,7 +1,7 @@ # poweroff > Power off the system. -> More information: . +> More information: . - Power off the system: diff --git a/pages/linux/prime-run.md b/pages/linux/prime-run.md new file mode 100644 index 000000000..98e11a6e1 --- /dev/null +++ b/pages/linux/prime-run.md @@ -0,0 +1,12 @@ +# prime-run + +> Run a program using an alternative Nvidia graphics card. +> More information: . + +- Run a program using a dedicated Nvidia GPU: + +`prime-run {{command}}` + +- Validate whether the Nvidia card is being used: + +`prime-run glxinfo | grep "OpenGL renderer"` diff --git a/pages/linux/pvcreate.md b/pages/linux/pvcreate.md index 97cbf2856..bc9bf6af1 100644 --- a/pages/linux/pvcreate.md +++ b/pages/linux/pvcreate.md @@ -2,7 +2,7 @@ > Initialize a disk or partition for use as a physical volume. > See also: `lvm`. -> More information: . +> More information: . - Initialize the `/dev/sda1` volume for use by LVM: diff --git a/pages/linux/pvdisplay.md b/pages/linux/pvdisplay.md index 292ac5335..aedf3db03 100644 --- a/pages/linux/pvdisplay.md +++ b/pages/linux/pvdisplay.md @@ -2,7 +2,7 @@ > Display information about Logical Volume Manager (LVM) physical volumes. > See also: `lvm`. -> More information: . +> More information: . - Display information about all physical volumes: diff --git a/pages/linux/pvs.md b/pages/linux/pvs.md index 50663835a..5236b8b40 100644 --- a/pages/linux/pvs.md +++ b/pages/linux/pvs.md @@ -2,7 +2,7 @@ > Display information about physical volumes. > See also: `lvm`. -> More information: . +> More information: . - Display information about physical volumes: diff --git a/pages/linux/pw-cat.md b/pages/linux/pw-cat.md index 91a828736..f3261b093 100644 --- a/pages/linux/pw-cat.md +++ b/pages/linux/pw-cat.md @@ -1,6 +1,6 @@ # pw-cat -> Play and record audio files through pipewire. +> Play and record audio files through PipeWire. > More information: . - Play a WAV file over the default target: diff --git a/pages/linux/pw-cli.md b/pages/linux/pw-cli.md index d86cb9711..bb71fee17 100644 --- a/pages/linux/pw-cli.md +++ b/pages/linux/pw-cli.md @@ -1,7 +1,7 @@ # pw-cli > Manage a PipeWire instance's modules, objects, nodes, devices, links and much more. -> More information: . +> More information: . - Print all nodes (sinks and sources) along with their IDs: diff --git a/pages/linux/pw-config.md b/pages/linux/pw-config.md new file mode 100644 index 000000000..38e7bd463 --- /dev/null +++ b/pages/linux/pw-config.md @@ -0,0 +1,32 @@ +# pw-config + +> List configuration paths and sections that will be used by the PipeWire server and clients. +> More information: . + +- List all configuration files that will be used: + +`pw-config` + +- List all configuration files that will be used by the PipeWire PulseAudio server: + +`pw-config --name pipewire-pulse.conf` + +- List all configuration sections used by the PipeWire PulseAudio server: + +`pw-config --name pipewire-pulse.conf list` + +- List the `context.properties` fragments used by the JACK clients: + +`pw-config --name jack.conf list context.properties` + +- List the merged `context.properties` used by the JACK clients: + +`pw-config --name jack.conf merge context.properties` + +- List the merged `context.modules` used by the PipeWire server and [r]eformat: + +`pw-config --name pipewire.conf --recurse merge context.modules` + +- Display help: + +`pw-config --help` diff --git a/pages/linux/pw-dot.md b/pages/linux/pw-dot.md index 2dc55359b..def8ecea8 100644 --- a/pages/linux/pw-dot.md +++ b/pages/linux/pw-dot.md @@ -8,22 +8,30 @@ `pw-dot` -- Specify an output file, showing all object types: +- Read objects from `pw-dump` JSON file: -`pw-dot --output {{path/to/file.dot}} --all` +`pw-dot {{-j|--json}} {{path/to/file.json}}` + +- Specify an [o]utput file, showing all object types: + +`pw-dot --output {{path/to/file.dot}} {{-a|--all}}` - Print `.dot` graph to `stdout`, showing all object properties: -`pw-dot --output - --detail` +`pw-dot --output - {{-d|--detail}}` -- Generate a graph from a remote instance, showing only linked objects: +- Generate a graph from a [r]emote instance, showing only linked objects: -`pw-dot --remote {{remote_name}} --smart` +`pw-dot --remote {{remote_name}} {{-s|--smart}}` - Lay the graph from left to right, instead of dot's default top to bottom: -`pw-dot --lr` +`pw-dot {{-L|--lr}}` - Lay the graph using 90-degree angles in edges: -`pw-dot --90` +`pw-dot {{-9|--90}}` + +- Display help: + +`pw-dot --help` diff --git a/pages/linux/pw-metadata.md b/pages/linux/pw-metadata.md new file mode 100644 index 000000000..7aee0f8af --- /dev/null +++ b/pages/linux/pw-metadata.md @@ -0,0 +1,33 @@ +# pw-metadata + +> Monitor, set, and delete metadata on PipeWire objects. +> See also: `pipewire`, `pw-mon`, `pw-cli`. +> More information: . + +- Show metadata in `default` name: + +`pw-metadata` + +- Show metadata with ID 0 in `settings`: + +`pw-metadata {{-n|--name}} {{settings}} {{0}}` + +- List all available metadata objects: + +`pw-metadata {{-l|--list}}` + +- Keep running and log the changes to the metadata: + +`pw-metadata {{-m|--monitor}}` + +- Delete all metadata: + +`pw-metadata {{-d|--delete}}` + +- Set `log.level` to 1 in `settings`: + +`pw-metadata --name {{settings}} {{0}} {{log.level}} {{1}}` + +- Display help: + +`pw-metadata --help` diff --git a/pages/linux/pw-play.md b/pages/linux/pw-play.md index e16cb52b5..92f729e07 100644 --- a/pages/linux/pw-play.md +++ b/pages/linux/pw-play.md @@ -1,7 +1,8 @@ # pw-play -> Play audio files through `pipewire`. +> Play audio files through PipeWire. > Shorthand for `pw-cat --playback`. +> See also: `play`. > More information: . - Play a WAV sound file over the default target: diff --git a/pages/linux/pw-profiler.md b/pages/linux/pw-profiler.md index 0afd150ec..2b95230d4 100644 --- a/pages/linux/pw-profiler.md +++ b/pages/linux/pw-profiler.md @@ -3,7 +3,7 @@ > Profile a local or remote instance. > More information: . -- Profile the default instance, logging to `profile.log` (`gnuplot` files and a `.html` file for result visualizing are also generated): +- Profile the default instance, logging to `profile.log` (`gnuplot` files and a HTML file for result visualizing are also generated): `pw-profiler` diff --git a/pages/linux/pw-record.md b/pages/linux/pw-record.md index f553d7eb8..7be54d915 100644 --- a/pages/linux/pw-record.md +++ b/pages/linux/pw-record.md @@ -1,6 +1,6 @@ # pw-record -> Record audio files through pipewire. +> Record audio files through PipeWire. > Shorthand for pw-cat --record. > More information: . diff --git a/pages/linux/qm-suspend.md b/pages/linux/qm-suspend.md index 7d532817f..c4fd707d5 100644 --- a/pages/linux/qm-suspend.md +++ b/pages/linux/qm-suspend.md @@ -4,7 +4,7 @@ > Use `--skiplock` and `--skiplockstorage` flags with caution, as they may lead to data corruption in certain situations. > More information: . -- Suspend a virtual machine by id: +- Suspend a virtual machine by ID: `qm suspend {{vm_id}} {{integer}}` diff --git a/pages/linux/rcp.md b/pages/linux/rcp.md index 2f8da27c2..4cefe9f73 100644 --- a/pages/linux/rcp.md +++ b/pages/linux/rcp.md @@ -6,16 +6,16 @@ - Copy a file to a remote host: -`rcp {{path/to/local_file}} {{username}}@{{remotehost}}:{{/path/to/destination/}}` +`rcp {{path/to/local_file}} {{username}}@{{remote_host}}:{{/path/to/destination/}}` - Copy a directory recursively: -`rcp -r {{path/to/local_directory}} {{username}}@{{remotehost}}:{{/path/to/destination/}}` +`rcp -r {{path/to/local_directory}} {{username}}@{{remote_host}}:{{/path/to/destination/}}` - Preserve the file attributes: -`rcp -p {{path/to/local_file}} {{username}}@{{remotehost}}:{{/path/to/destination/}}` +`rcp -p {{path/to/local_file}} {{username}}@{{remote_host}}:{{/path/to/destination/}}` - Force copy without a confirmation: -`rcp -f {{path/to/local_file}} {{username}}@{{remotehost}}:{{/path/to/destination/}}` +`rcp -f {{path/to/local_file}} {{username}}@{{remote_host}}:{{/path/to/destination/}}` diff --git a/pages/linux/readelf.md b/pages/linux/readelf.md index 87234431f..510f9d450 100644 --- a/pages/linux/readelf.md +++ b/pages/linux/readelf.md @@ -1,7 +1,7 @@ # readelf -> Displays information about ELF files. -> More information: . +> Display information about ELF files. +> More information: . - Display all information about the ELF file: @@ -15,6 +15,10 @@ `readelf --symbols {{path/to/binary}}` -- Display the information contained in the ELF header at the start of the file: +- Display ELF header information: `readelf --file-header {{path/to/binary}}` + +- Display ELF section header information: + +`readelf --section-headers {{path/to/binary}}` diff --git a/pages/linux/readpe.md b/pages/linux/readpe.md index 5f4825347..578fa8986 100644 --- a/pages/linux/readpe.md +++ b/pages/linux/readpe.md @@ -1,6 +1,6 @@ # readpe -> Displays information about PE files. +> Display information about PE files. > More information: . - Display all information about a PE file: diff --git a/pages/linux/reset.md b/pages/linux/reset.md index f01957047..78fecd153 100644 --- a/pages/linux/reset.md +++ b/pages/linux/reset.md @@ -1,6 +1,6 @@ # reset -> Reinitializes the current terminal. Clears the entire terminal screen. +> Reinitialize the current terminal. Clears the entire terminal screen. > More information: . - Reinitialize the current terminal: diff --git a/pages/linux/rexec.md b/pages/linux/rexec.md index bbfbfb983..e7cc6b7f4 100644 --- a/pages/linux/rexec.md +++ b/pages/linux/rexec.md @@ -1,7 +1,7 @@ # rexec > Execute a command on a remote host. -> Note: Use `rexec` with caution, as it transmits data in plain text. Consider secure alternatives like `ssh` for encrypted communication. +> Note: Use `rexec` with caution, as it transmits data in plain text. Consider secure alternatives like SSH for encrypted communication. > More information: . - Execute a command on a remote [h]ost: diff --git a/pages/linux/rpcinfo.md b/pages/linux/rpcinfo.md index b540605c8..170d0f8c9 100644 --- a/pages/linux/rpcinfo.md +++ b/pages/linux/rpcinfo.md @@ -1,6 +1,6 @@ # rpcinfo -> Makes an RPC call to an RPC server and reports what it finds. +> Make an RPC call to an RPC server and reports what it finds. > More information: . - Show full table of all RPC services registered on localhost: diff --git a/pages/linux/rpi-otp-private-key.md b/pages/linux/rpi-otp-private-key.md new file mode 100644 index 000000000..5c5f2cb7a --- /dev/null +++ b/pages/linux/rpi-otp-private-key.md @@ -0,0 +1,8 @@ +# rpi-otp-private-key + +> Display the One-Time Programmable (OTP) private key of a Raspberry Pi. +> More information: . + +- Read the OTP private key: + +`rpi-otp-private-key` diff --git a/pages/linux/rpmbuild.md b/pages/linux/rpmbuild.md index c913254d4..b8f534469 100644 --- a/pages/linux/rpmbuild.md +++ b/pages/linux/rpmbuild.md @@ -1,7 +1,7 @@ # rpmbuild > RPM Package Build tool. -> More information: . +> More information: . - Build binary and source packages: diff --git a/pages/linux/runcon.md b/pages/linux/runcon.md index 7d4c474cd..1127fc73a 100644 --- a/pages/linux/runcon.md +++ b/pages/linux/runcon.md @@ -1,10 +1,10 @@ # runcon > Run a program in a different SELinux security context. -> With neither context nor command, print the current security context. +> See also: `secon`. > More information: . -- Determine the current domain: +- Print the security context of the current execution context: `runcon` diff --git a/pages/linux/sa.md b/pages/linux/sa.md index f03929ef5..d43a022d0 100644 --- a/pages/linux/sa.md +++ b/pages/linux/sa.md @@ -1,7 +1,7 @@ # sa -> Summarizes accounting information. Part of the acct package. -> Shows commands called by users, including basic info on CPU time spent processing and I/O rates. +> Summarize accounting information about commands called by users, including basic information on CPU time spent processing and I/O rates. +> Part of the `acct` package. > More information: . - Display executable invocations per user (username not displayed): diff --git a/pages/linux/sacct.md b/pages/linux/sacct.md index 15e4521ae..639da463e 100644 --- a/pages/linux/sacct.md +++ b/pages/linux/sacct.md @@ -3,11 +3,11 @@ > Display accounting data from the Slurm service. > More information: . -- Display job id, job name, partition, account, number of allocated cpus, job state, and job exit codes for recent jobs: +- Display job ID, job name, partition, account, number of allocated cpus, job state, and job exit codes for recent jobs: `sacct` -- Display job id, job state, job exit code for recent jobs: +- Display job ID, job state, job exit code for recent jobs: `sacct --brief` diff --git a/pages/linux/secon.md b/pages/linux/secon.md new file mode 100644 index 000000000..db979b826 --- /dev/null +++ b/pages/linux/secon.md @@ -0,0 +1,25 @@ +# secon + +> Get the SELinux security context of a file, pid, current execution context, or a context specification. +> See also: `semanage`, `runcon`, `chcon`. +> More information: . + +- Get the security context of the current execution context: + +`secon` + +- Get the current security context of a process: + +`secon --pid {{1}}` + +- Get the current security context of a file, resolving all intermediate symlinks: + +`secon --file {{path/to/file_or_directory}}` + +- Get the current security context of a symlink itself (i.e. do not resolve): + +`secon --link {{path/to/symlink}}` + +- Parse and explain a context specification: + +`secon {{system_u:system_r:container_t:s0:c899,c900}}` diff --git a/pages/linux/semanage-boolean.md b/pages/linux/semanage-boolean.md new file mode 100644 index 000000000..c04e6a94f --- /dev/null +++ b/pages/linux/semanage-boolean.md @@ -0,0 +1,17 @@ +# semanage boolean + +> Manage persistent SELinux boolean settings. +> See also: `semanage` for managing SELinux policies, `getsebool` for checking boolean values, and `setsebool` for applying non-persistent boolean settings. +> More information: . + +- List all booleans settings: + +`sudo semanage boolean {{-l|--list}}` + +- List all user-defined boolean settings without headings: + +`sudo semanage boolean {{-l|--list}} {{-C|--locallist}} {{-n|--noheading}}` + +- Set or unset a boolean persistently: + +`sudo semanage boolean {{-m|--modify}} {{-1|--on|-0|--off}} {{haproxy_connect_any}}` diff --git a/pages/linux/semanage-fcontext.md b/pages/linux/semanage-fcontext.md index 72647e1f1..c79570704 100644 --- a/pages/linux/semanage-fcontext.md +++ b/pages/linux/semanage-fcontext.md @@ -1,7 +1,7 @@ # semanage fcontext > Manage persistent SELinux security context rules on files/directories. -> See also: `semanage`, `restorecon`. +> See also: `semanage`, `matchpathcon`, `secon`, `chcon`, `restorecon`. > More information: . - List all file labelling rules: diff --git a/pages/linux/semanage-permissive.md b/pages/linux/semanage-permissive.md new file mode 100644 index 000000000..4c86c23de --- /dev/null +++ b/pages/linux/semanage-permissive.md @@ -0,0 +1,14 @@ +# semanage permissive + +> Manage persistent SELinux permissive domains. +> Note that this effectively makes the process unconfined. For long-term use, it is recommended to configure SELiunx properly. +> See also: `semanage`, `getenforce`, `setenforce`. +> More information: . + +- List all process types (a.k.a domains) that are in permissive mode: + +`sudo semanage permissive {{-l|--list}}` + +- Set or unset permissive mode for a domain: + +`sudo semanage permissive {{-a|--add|-d|--delete}} {{httpd_t}}` diff --git a/pages/linux/semanage-port.md b/pages/linux/semanage-port.md new file mode 100644 index 000000000..050e4c1e3 --- /dev/null +++ b/pages/linux/semanage-port.md @@ -0,0 +1,21 @@ +# semanage port + +> Manage persistent SELinux port definitions. +> See also: `semanage`. +> More information: . + +- List all port labeling rules: + +`sudo semanage port {{-l|--list}}` + +- List all user-defined port labeling rules without headings: + +`sudo semanage port {{-l|--list}} {{-C|--locallist}} {{-n|--noheading}}` + +- Add a user-defined rule that assigns a label to a protocol-port pair: + +`sudo semanage port {{-a|--add}} {{-t|--type}} {{ssh_port_t}} {{-p|--proto}} {{tcp}} {{22000}}` + +- Delete a user-defined rule using its protocol-port pair: + +`sudo semanage port {{-d|--delete}} {{-p|--proto}} {{udp}} {{11940}}` diff --git a/pages/linux/semanage.md b/pages/linux/semanage.md index e7c7cd267..3ce9cc95b 100644 --- a/pages/linux/semanage.md +++ b/pages/linux/semanage.md @@ -1,24 +1,29 @@ # semanage -> SELinux Policy Management tool. +> SELinux persistent policy management tool. +> Some subcommands such as `boolean`, `fcontext`, `port`, etc. have their own usage documentation. > More information: . -- Output local customizations: +- Set or unset a SELinux boolean. Booleans allow the administrator to customize how policy rules affect confined process types (a.k.a domains): -`semanage -S {{store}} -o {{path/to/output_file}}` +`sudo semanage boolean {{-m|--modify}} {{-1|--on|-0|--off}} {{haproxy_connect_any}}` -- Take a set of commands from a specified file and load them in a single transaction: +- Add a user-defined file context labeling rule. File contexts define what files confined domains are allowed to access: -`semanage -S {{store}} -i {{path/to/input_file}}` +`sudo semanage fcontext {{-a|--add}} {{-t|--type}} {{samba_share_t}} '/mnt/share(/.*)?'` -- Manage booleans. Booleans allow the administrator to modify the confinement of processes based on the current configuration: +- Add a user-defined port labeling rule. Port labels define what ports confined domains are allowed to listen on: -`semanage boolean -S {{store}} {{--delete|--modify|--list|--noheading|--deleteall}} {{-on|-off}} -F {{boolean|boolean_file}}` +`sudo semanage port {{-a|--add}} {{-t|--type}} {{ssh_port_t}} {{-p|--proto}} {{tcp}} {{22000}}` -- Manage policy modules: +- Set or unset permissive mode for a confined domain. Per-domain permissive mode allows more granular control compared to `setenforce`: -`semanage module -S {{store}} {{--add|--delete|--list|--modify}} {{--enable|--disable}} {{module_name}}` +`sudo semanage permissive {{-a|--add|-d|--delete}} {{httpd_t}}` -- Disable/Enable dontaudit rules in policy: +- Output local customizations in the default store: -`semanage dontaudit -S {{store}} {{on|off}}` +`sudo semanage export {{-f|--output_file}} {{path/to/file}}` + +- Import a file generated by `semanage export` into local customizations (CAREFUL: may remove current customizations!): + +`sudo semanage import {{-f|--input_file}} {{path/to/file}}` diff --git a/pages/linux/setcap.md b/pages/linux/setcap.md index 4c4f16673..5715018ff 100644 --- a/pages/linux/setcap.md +++ b/pages/linux/setcap.md @@ -1,7 +1,7 @@ # setcap > Set capabilities of specified file. -> See also: `tldr getcap`. +> See also: `getcap`. > More information: . - Set capability `cap_net_raw` (to use RAW and PACKET sockets) for a given file: diff --git a/pages/linux/setenforce.md b/pages/linux/setenforce.md new file mode 100644 index 000000000..fd551a33c --- /dev/null +++ b/pages/linux/setenforce.md @@ -0,0 +1,14 @@ +# setenforce + +> Toggle SELinux between enforcing and permissive modes. +> To enable or disable SELinux, edit `/etc/selinux/config` instead. +> See also: `getenforce`, `semanage-permissive`. +> More information: . + +- Put SELinux in enforcing mode: + +`setenforce {{1|Enforcing}}` + +- Put SELiunx in permissive mode: + +`setenforce {{0|Permissive}}` diff --git a/pages/linux/setsebool.md b/pages/linux/setsebool.md new file mode 100644 index 000000000..f73695454 --- /dev/null +++ b/pages/linux/setsebool.md @@ -0,0 +1,25 @@ +# setsebool + +> Set SELinux boolean value. +> See also: `semanage-boolean`, `getsebool`. +> More information: . + +- Show the current setting of [a]ll booleans: + +`getsebool -a` + +- Set or unset a boolean temporarily (non-persistent across reboot): + +`sudo setsebool {{httpd_can_network_connect}} {{1|true|on|0|false|off}}` + +- Set or unset a boolean [p]ersistently: + +`sudo setsebool -P {{container_use_devices}} {{1|true|on|0|false|off}}` + +- Set or unset multiple booleans [p]ersistently at once: + +`sudo setsebool -P {{ftpd_use_fusefs=1 mount_anyfile=0 ...}}` + +- Set or unset a boolean persistently (alternative method using `semanage-boolean`): + +`sudo semanage boolean {{-m|--modify}} {{-1|--on|-0|--off}} {{haproxy_connect_any}}` diff --git a/pages/linux/showkey.md b/pages/linux/showkey.md new file mode 100644 index 000000000..7d3ca5a27 --- /dev/null +++ b/pages/linux/showkey.md @@ -0,0 +1,24 @@ +# showkey + +> Display the keycode of pressed keys on the keyboard, helpful for debugging keyboard-related issues and key remapping. +> More information: . + +- View keycodes in decimal: + +`sudo showkey` + +- Display scancodes in hexadecimal: + +`sudo showkey {{-s|--scancodes}}` + +- Display keycodes in decimal (default): + +`sudo showkey {{-k|--keycodes}}` + +- Display keycodes in ASCII, decimal, and hexadecimal: + +`sudo showkey {{-a|--ascii}}` + +- Exit the program: + +`Ctrl + d` diff --git a/pages/linux/size.md b/pages/linux/size.md index 36061ed40..99ede4acf 100644 --- a/pages/linux/size.md +++ b/pages/linux/size.md @@ -1,6 +1,6 @@ # size -> Displays the sizes of sections inside binary files. +> Display the sizes of sections inside binary files. > More information: . - Display the size of sections in a given object or executable file: diff --git a/pages/linux/slurmdbd.md b/pages/linux/slurmdbd.md index 763b90902..bee70944c 100644 --- a/pages/linux/slurmdbd.md +++ b/pages/linux/slurmdbd.md @@ -1,6 +1,6 @@ # slurmdbd -> Provides a secure enterprise-wide interface to a database for Slurm. +> A secure enterprise-wide interface to a database for Slurm. > More information: . - Set the daemon's nice value to the specified value, typically a negative number: diff --git a/pages/linux/sm.md b/pages/linux/sm.md index e5c2a666e..192310d82 100644 --- a/pages/linux/sm.md +++ b/pages/linux/sm.md @@ -1,6 +1,6 @@ # sm -> Displays a short message fullscreen. +> Display a short message fullscreen. > More information: . - Display a message in full-screen: diff --git a/pages/linux/sqfstar.md b/pages/linux/sqfstar.md index da718ba29..2630c3714 100644 --- a/pages/linux/sqfstar.md +++ b/pages/linux/sqfstar.md @@ -3,22 +3,22 @@ > Create a squashfs filesystem from a tar archive. > More information: . -- Create a squashfs filesystem (compressed using `gzip` by default) from an uncompressed `tar` archive: +- Create a squashfs filesystem (compressed using `gzip` by default) from an uncompressed tar archive: `sqfstar {{filesystem.squashfs}} < {{archive.tar}}` -- Create a squashfs filesystem from a `tar` archive compressed with `gzip`, and [comp]ress the filesystem using a specific algorithm: +- Create a squashfs filesystem from a tar archive compressed with `gzip`, and [comp]ress the filesystem using a specific algorithm: `zcat {{archive.tar.gz}} | sqfstar -comp {{gzip|lzo|lz4|xz|zstd|lzma}} {{filesystem.squashfs}}` -- Create a squashfs filesystem from a `tar` archive compressed with `xz`, excluding some of the files: +- Create a squashfs filesystem from a tar archive compressed with `xz`, excluding some of the files: `xzcat {{archive.tar.xz}} | sqfstar {{filesystem.squashfs}} {{file1 file2 ...}}` -- Create a squashfs filesystem from a `tar` archive compressed with `zstd`, excluding files ending with `.gz`: +- Create a squashfs filesystem from a tar archive compressed with `zstd`, excluding files ending with `.gz`: `zstdcat {{archive.tar.zst}} | sqfstar {{filesystem.squashfs}} "{{*.gz}}"` -- Create a squashfs filesystem from a `tar` archive compressed with `lz4`, excluding files matching a regular expression: +- Create a squashfs filesystem from a tar archive compressed with `lz4`, excluding files matching a regular expression: `lz4cat {{archive.tar.lz4}} | sqfstar {{filesystem.squashfs}} -regex "{{regular_expression}}"` diff --git a/pages/linux/ss.md b/pages/linux/ss.md index 22f5d9bbf..fbd7d6106 100644 --- a/pages/linux/ss.md +++ b/pages/linux/ss.md @@ -19,7 +19,7 @@ `ss -lt src :{{8080}}` -- Show all TCP sockets along with processes connected to a remote ssh port: +- Show all TCP sockets along with processes connected to a remote SSH port: `ss -pt dst :{{ssh}}` diff --git a/pages/linux/sslstrip.md b/pages/linux/sslstrip.md new file mode 100644 index 000000000..79517ecf2 --- /dev/null +++ b/pages/linux/sslstrip.md @@ -0,0 +1,29 @@ +# sslstrip + +> Perform Moxie Marlinspike's Secure Sockets Layer (SSL) stripping attacks. +> Perform an ARP spoofing attack in conjunction. +> More information: . + +- Log only HTTPS POST traffic on port 10000 by default: + +`sslstrip` + +- Log only HTTPS POST traffic on port 8080: + +`sslstrip --listen={{8080}}` + +- Log all SSL traffic to and from the server on port 8080: + +`sslstrip --ssl --listen={{8080}}` + +- Log all SSL and HTTP traffic to and from the server on port 8080: + +`sslstrip --listen={{8080}} --all` + +- Specify the file path to store the logs: + +`sslstrip --listen={{8080}} --write={{path/to/file}}` + +- Display help: + +`sslstrip --help` diff --git a/pages/linux/swupd.md b/pages/linux/swupd.md index 7b6504a42..0a6733249 100644 --- a/pages/linux/swupd.md +++ b/pages/linux/swupd.md @@ -1,7 +1,7 @@ # swupd > Package management utility for Clear Linux. -> More information: . +> More information: . - Update to the latest version: diff --git a/pages/linux/systemctl.md b/pages/linux/systemctl.md index 297cf9cb6..304c33a80 100644 --- a/pages/linux/systemctl.md +++ b/pages/linux/systemctl.md @@ -11,26 +11,26 @@ `systemctl --failed` -- Start/Stop/Restart/Reload a service: +- Start/Stop/Restart/Reload/Show the status a service: -`systemctl {{start|stop|restart|reload}} {{unit}}` - -- Show the status of a unit: - -`systemctl status {{unit}}` +`systemctl {{start|stop|restart|reload|status}} {{unit}}` - Enable/Disable a unit to be started on bootup: `systemctl {{enable|disable}} {{unit}}` -- Mask/Unmask a unit to prevent enablement and manual activation: - -`systemctl {{mask|unmask}} {{unit}}` - -- Reload systemd, scanning for new or changed units: +- Reload systemd, scan for new or changed units: `systemctl daemon-reload` -- Check if a unit is enabled: +- Check if a unit is active/enabled/failed: -`systemctl is-enabled {{unit}}` +`systemctl {{is-active|is-enabled|is-failed}} {{unit}}` + +- List all service/socket/automount units filtering by running/failed state: + +`systemctl list-units --type={{service|socket|automount}} --state={{failed|running}}` + +- Show the contents & absolute path of a unit file: + +`systemctl cat {{unit}}` diff --git a/pages/linux/systool.md b/pages/linux/systool.md new file mode 100644 index 000000000..824f6fcdd --- /dev/null +++ b/pages/linux/systool.md @@ -0,0 +1,17 @@ +# systool + +> View system device information by bus, and classes. +> This command is part of the `sysfs` package. +> More information: . + +- List all attributes of devices of a bus (eg. `pci`, `usb`). View all buses using `ls /sys/bus`: + +`systool -b {{bus}} -v` + +- List all attributes of a class of devices (eg. `drm`, `block`). View all classes using `ls /sys/class`: + +`systool -c {{class}} -v` + +- Show only device drivers of a bus (eg. `pci`, `usb`): + +`systool -b {{bus}} -D` diff --git a/pages/linux/tcpkill.md b/pages/linux/tcpkill.md index 7ef95ef67..0d88d7a5d 100644 --- a/pages/linux/tcpkill.md +++ b/pages/linux/tcpkill.md @@ -1,6 +1,6 @@ # tcpkill -> Kills specified in-progress TCP connections. +> Kill specified in-progress TCP connections. > More information: . - Kill in-progress connections at a specified interface, host and port: diff --git a/pages/linux/termusic.md b/pages/linux/termusic.md index 8b8f00ca4..3c8a82629 100644 --- a/pages/linux/termusic.md +++ b/pages/linux/termusic.md @@ -1,6 +1,7 @@ # termusic > A terminal music player written in Rust that uses vim-like key bindings. +> See also: `cmus`, `ncmpcpp`, `audacious`. > More information: . - Open termusic to a specific directory. (It can be set permanently in `~/.config/termusic/config.toml`): diff --git a/pages/linux/tftp.md b/pages/linux/tftp.md index fedfc18fe..9deebfbed 100644 --- a/pages/linux/tftp.md +++ b/pages/linux/tftp.md @@ -15,7 +15,7 @@ `tftp {{server_ip}} -6 -R {{port}}:{{port}}` -- Set the transfer mode to binary or ascii through the tftp client: +- Set the transfer mode to binary or ASCIi through the tftp client: `mode {{binary|ascii}}` diff --git a/pages/linux/thunar.md b/pages/linux/thunar.md index 932202eba..0db1fcc75 100644 --- a/pages/linux/thunar.md +++ b/pages/linux/thunar.md @@ -1,6 +1,7 @@ # thunar > Graphical file manager for XFCE desktop environments. +> See also: `caja`, `dolphin`, `nautilus`, `mc`. > More information: . - Open a new window showing the current directory: diff --git a/pages/linux/tlp-stat.md b/pages/linux/tlp-stat.md index 3628dd9d7..e7180a10e 100644 --- a/pages/linux/tlp-stat.md +++ b/pages/linux/tlp-stat.md @@ -8,10 +8,30 @@ `sudo tlp-stat` -- Show battery information: +- Show information about various devices: -`sudo tlp-stat -b` +`sudo tlp-stat --{{battery|disk|processor|graphics|pcie|rfkill|usb}}` + +- Show verbose information about devices that support verbosity: + +`sudo tlp-stat --verbose --{{battery|processor|pcie|usb}}` - Show configuration: -`sudo tlp-stat -c` +`sudo tlp-stat {{-c|--config}}` + +- Monitor [p]ower supply `udev` [ev]ents: + +`sudo tlp-stat {{-P|--pev}}` + +- Show [p]ower [sup]ply diagonistics: + +`sudo tlp-stat --psup` + +- Show [temp]eratures and fan speed: + +`sudo tlp-stat {{-t|--temp}}` + +- Show general system information: + +`sudo tlp-stat {{-s|--system}}` diff --git a/pages/linux/togglesebool.md b/pages/linux/togglesebool.md new file mode 100644 index 000000000..3d356a9b7 --- /dev/null +++ b/pages/linux/togglesebool.md @@ -0,0 +1,9 @@ +# togglesebool + +> Flip the current (non-persistent) values of SELinux booleans. +> Note: This tool has been deprecated and often removed in favor of `setsebool`. +> More information: . + +- Flip the current (non-persistent) values of the specified booleans: + +`sudo togglesebool {{virt_use_samba virt_use_usb ...}}` diff --git a/pages/linux/toolbox-help.md b/pages/linux/toolbox-help.md index c09b99341..ae7b34f60 100644 --- a/pages/linux/toolbox-help.md +++ b/pages/linux/toolbox-help.md @@ -1,6 +1,6 @@ # toolbox help -> Displays help information about `toolbox`. +> Display help information about `toolbox`. > More information: . - Display the `toolbox` manual: diff --git a/pages/linux/tor.md b/pages/linux/tor.md new file mode 100644 index 000000000..853774db0 --- /dev/null +++ b/pages/linux/tor.md @@ -0,0 +1,32 @@ +# tor + +> Enable anonymous communication through the Tor network. +> More information: . + +- Connect to the Tor network: + +`tor` + +- View Tor configuration: + +`tor --config` + +- Check Tor status: + +`tor --status` + +- Run as client only: + +`tor --client` + +- Run as relay: + +`tor --relay` + +- Run as bridge: + +`tor --bridge` + +- Run as a hidden service: + +`tor --hidden-service` diff --git a/pages/linux/torify.md b/pages/linux/torify.md new file mode 100644 index 000000000..496742b7e --- /dev/null +++ b/pages/linux/torify.md @@ -0,0 +1,33 @@ +# torify + +> Route network traffic through the Tor network. +> Note: This command has been deprecated, and is now a backwards-compatible wrapper of `torsocks`. +> More information: . + +- Route traffic via Tor: + +`torify {{command}}` + +- Toggle Tor in shell: + +`torify {{on|off}}` + +- Spawn a Tor-enabled shell: + +`torify --shell` + +- Check for a Tor-enabled shell: + +`torify show` + +- Specify Tor configuration file: + +`torify -c {{config-file}} {{command}}` + +- Use a specific Tor SOCKS proxy: + +`torify -P {{proxy}} {{command}}` + +- Redirect output to a file: + +`torify {{command}} > {{path/to/output}}` diff --git a/pages/linux/torsocks.md b/pages/linux/torsocks.md new file mode 100644 index 000000000..ea45cc12f --- /dev/null +++ b/pages/linux/torsocks.md @@ -0,0 +1,29 @@ +# torsocks + +> Route the traffic of any application through the Tor network. +> Note: `torsocks` will assume that it should connect to the Tor SOCKS proxy running at 127.0.0.1:9050 being the defaults of the Tor daemon. +> More information: . + +- Run a command using Tor: + +`torsocks {{command}}` + +- Enable or disable Tor in this shell: + +`. torsocks {{on|off}}` + +- Spawn a new Tor enabled shell: + +`torsocks --shell` + +- Check if current shell is Tor enabled (`LD_PRELOAD` value will be empty if disabled): + +`torsocks show` + +- [i]solate traffic through a different Tor circuit, improving anonymity: + +`torsocks --isolate {{curl https://check.torproject.org/api/ip}}` + +- Connect to a Tor proxy running on a specific [a]ddress and [P]ort: + +`torsocks --address {{ip}} --port {{port}} {{command}}` diff --git a/pages/linux/tunelp.md b/pages/linux/tunelp.md new file mode 100644 index 000000000..76bf27560 --- /dev/null +++ b/pages/linux/tunelp.md @@ -0,0 +1,25 @@ +# tunelp + +> Set various parameters for parallel port devices for troubleshooting or for better performance. +> Part of `util-linux`. +> More information: . + +- Check the [s]tatus of a parallel port device: + +`tunelp --status {{/dev/lp0}}` + +- [r]eset a given parallel port: + +`tunelp --reset {{/dev/lp0}}` + +- Use a given [i]RQ for a device, each one representing an interrupt line: + +`tunelp -i 5 {{/dev/lp0}}` + +- Try a given number of times to output a [c]haracter to the printer before sleeping for a given [t]ime: + +`tunelp --chars {{times}} --time {{time_in_centiseconds}} {{/dev/lp0}}` + +- Enable or disable [a]borting on error (disabled by default): + +`tunelp --abort {{on|off}}` diff --git a/pages/linux/turbostat.md b/pages/linux/turbostat.md new file mode 100644 index 000000000..a9f31180b --- /dev/null +++ b/pages/linux/turbostat.md @@ -0,0 +1,24 @@ +# turbostat + +> Report processor topology, frequency, temperature, power, and idle statistics. +> More information: . + +- Display statistics every 5 seconds: + +`sudo turbostat` + +- Display statistics every specified amount of seconds: + +`sudo turbostat -i {{n_seconds}}` + +- Do not decode and print the system configuration header information: + +`sudo turbostat --quiet` + +- Display useful information about CPU every 1 second, without header information: + +`sudo turbostat --quiet --interval 1 --cpu 0-{{CPU_thread_count}} --show "PkgWatt","Busy%","Core","CoreTmp","Thermal"` + +- Display help: + +`turbostat --help` diff --git a/pages/linux/ul.md b/pages/linux/ul.md index 8fb48a903..f443a8aff 100644 --- a/pages/linux/ul.md +++ b/pages/linux/ul.md @@ -1,6 +1,6 @@ # ul -> Performs the underlining of a text. +> Underline a text. > Each character in a string must be underlined separately. > More information: . diff --git a/pages/linux/unzipsfx.md b/pages/linux/unzipsfx.md index 72b62558d..4cbd16671 100644 --- a/pages/linux/unzipsfx.md +++ b/pages/linux/unzipsfx.md @@ -1,9 +1,9 @@ # unzipsfx -> Create a self-extracting compressed binary file by prepending self-extracting stubs on a `zip` file. +> Create a self-extracting compressed binary file by prepending self-extracting stubs on a Zip file. > More information: . -- Create a self-extracting binary file of a `zip` archive: +- Create a self-extracting binary file of a Zip archive: `cat unzipsfx {{path/to/archive.zip}} > {{filename}} && chmod 755 {{filename}}` @@ -19,6 +19,6 @@ `{{./path/to/binary)}} -c {{path/to/filename}}` -- Print comments on `zip` archive in the self-extracting binary: +- Print comments on Zip archive in the self-extracting binary: `{{./path/to/binary)}} -z` diff --git a/pages/linux/uprecords.md b/pages/linux/uprecords.md index 8d776abbc..fec09a7f6 100644 --- a/pages/linux/uprecords.md +++ b/pages/linux/uprecords.md @@ -1,6 +1,6 @@ # uprecords -> Displays a summary of historical uptime records. +> Display a summary of historical uptime records. > More information: . - Display a summary of the top 10 historical uptime records: diff --git a/pages/linux/urpmi-addmedia.md b/pages/linux/urpmi.addmedia.md similarity index 100% rename from pages/linux/urpmi-addmedia.md rename to pages/linux/urpmi.addmedia.md diff --git a/pages/linux/urpmi-removemedia.md b/pages/linux/urpmi.removemedia.md similarity index 100% rename from pages/linux/urpmi-removemedia.md rename to pages/linux/urpmi.removemedia.md diff --git a/pages/linux/urpmi-update.md b/pages/linux/urpmi.update.md similarity index 100% rename from pages/linux/urpmi-update.md rename to pages/linux/urpmi.update.md diff --git a/pages/linux/useradd.md b/pages/linux/useradd.md index a3e917e8f..49cb7e459 100644 --- a/pages/linux/useradd.md +++ b/pages/linux/useradd.md @@ -8,7 +8,7 @@ `sudo useradd {{username}}` -- Create a new user with the specified user id: +- Create a new user with the specified user ID: `sudo useradd --uid {{id}} {{username}}` diff --git a/pages/linux/usermod.md b/pages/linux/usermod.md index a712fec29..94b4bec51 100644 --- a/pages/linux/usermod.md +++ b/pages/linux/usermod.md @@ -1,6 +1,6 @@ # usermod -> Modifies a user account. +> Modify a user account. > See also: `users`, `useradd`, `userdel`. > More information: . @@ -8,7 +8,7 @@ `sudo usermod --login {{new_username}} {{username}}` -- Change a user id: +- Change a user ID: `sudo usermod --uid {{id}} {{username}}` diff --git a/pages/linux/vgcreate.md b/pages/linux/vgcreate.md index 1092b619c..55a0387d3 100644 --- a/pages/linux/vgcreate.md +++ b/pages/linux/vgcreate.md @@ -2,7 +2,7 @@ > Create volume groups combining multiple mass-storage devices. > See also: `lvm`. -> More information: . +> More information: . - Create a new volume group called vg1 using the `/dev/sda1` device: diff --git a/pages/linux/vgdisplay.md b/pages/linux/vgdisplay.md index 3a29dac6e..51b7c7e7d 100644 --- a/pages/linux/vgdisplay.md +++ b/pages/linux/vgdisplay.md @@ -2,7 +2,7 @@ > Display information about Logical Volume Manager (LVM) volume groups. > See also: `lvm`. -> More information: . +> More information: . - Display information about all volume groups: diff --git a/pages/linux/vgs.md b/pages/linux/vgs.md index b7fcca2a1..b09921167 100644 --- a/pages/linux/vgs.md +++ b/pages/linux/vgs.md @@ -2,7 +2,7 @@ > Display information about volume groups. > See also: `lvm`. -> More information: . +> More information: . - Display information about volume groups: diff --git a/pages/linux/vncserver.md b/pages/linux/vncserver.md index aaae5725b..c1b6cc715 100644 --- a/pages/linux/vncserver.md +++ b/pages/linux/vncserver.md @@ -1,6 +1,6 @@ # vncserver -> Launches a VNC (Virtual Network Computing) desktop. +> Launch a VNC (Virtual Network Computing) desktop. > More information: . - Launch a VNC Server on next available display: diff --git a/pages/linux/vnstat.md b/pages/linux/vnstat.md index 661b4bc6d..230fddc45 100644 --- a/pages/linux/vnstat.md +++ b/pages/linux/vnstat.md @@ -9,11 +9,11 @@ - Display traffic summary for a specific network interface: -`vnstat -i {{eth0}}` +`vnstat -i {{network_interface}}` - Display live stats for a specific network interface: -`vnstat -l -i {{eth0}}` +`vnstat -l -i {{network_interface}}` - Show traffic statistics on an hourly basis for the last 24 hours using a bar graph: diff --git a/pages/linux/vnstati.md b/pages/linux/vnstati.md index e05481562..88e35b463 100644 --- a/pages/linux/vnstati.md +++ b/pages/linux/vnstati.md @@ -9,7 +9,7 @@ - Output the 10 most traffic-intensive days of all time: -`vnstati --top10 --iface {{network_interface}} --output {{path/to/output.png}}` +`vnstati --top 10 --iface {{network_interface}} --output {{path/to/output.png}}` - Output monthly traffic statistics from the last 12 months: diff --git a/pages/linux/vrms.md b/pages/linux/vrms.md index 16b37aede..196cc9da2 100644 --- a/pages/linux/vrms.md +++ b/pages/linux/vrms.md @@ -1,7 +1,7 @@ # vrms > Report non-free packages installed on Debian-based OSes. -> More information: . +> More information: . - List non-free and contrib packages (and their description): diff --git a/pages/linux/wal-telegram.md b/pages/linux/wal-telegram.md index 68f9becb3..db4e2846f 100644 --- a/pages/linux/wal-telegram.md +++ b/pages/linux/wal-telegram.md @@ -1,6 +1,6 @@ # wal-telegram -> Generates themes for Telegram based the colors generated by pywal/wal. +> Generate themes for Telegram based the colors generated by pywal/wal. > More information: . - Generate with wal's palette and the current wallpaper (feh only): diff --git a/pages/linux/warpd.md b/pages/linux/warpd.md index a27846431..89a9d8e02 100644 --- a/pages/linux/warpd.md +++ b/pages/linux/warpd.md @@ -1,7 +1,7 @@ # warpd > A modal keyboard driven pointer manipulation program. -> More information: . +> More information: . - Run warpd in normal mode: diff --git a/pages/linux/waydroid.md b/pages/linux/waydroid.md index 9c9382512..e049bd50a 100644 --- a/pages/linux/waydroid.md +++ b/pages/linux/waydroid.md @@ -26,3 +26,7 @@ - Manage the Waydroid container: `waydroid container {{start|stop|restart|freeze|unfreeze}}` + +- Adjust Waydroid window dimensions: + +`waydroid prop set persist.waydroid.{{width|height}} {{number}}` diff --git a/pages/linux/waypipe.md b/pages/linux/waypipe.md new file mode 100644 index 000000000..a93f01669 --- /dev/null +++ b/pages/linux/waypipe.md @@ -0,0 +1,12 @@ +# waypipe + +> Remotely run graphical applications under a Wayland compositor. +> More information: . + +- Run a graphical program remotely and display it locally: + +`waypipe ssh {{user}}@{{server}} {{program}}` + +- Open an SSH tunnel to run any program remotely and display it locally: + +`waypipe ssh {{user}}@{{server}}` diff --git a/pages/linux/wodim.md b/pages/linux/wodim.md index c6372403e..aef2d216d 100644 --- a/pages/linux/wodim.md +++ b/pages/linux/wodim.md @@ -10,12 +10,12 @@ - Record ("burn") an audio-only disc: -`wodim dev=/dev/{{optical_drive}} -audio {{track*.cdaudio}}` +`wodim dev={{/dev/optical_drive}} -audio {{track*.cdaudio}}` - Burn a file to a disc, ejecting the disc once done (some recorders require this): -`wodim -eject dev=/dev/{{optical_drive}} -data {{file.iso}}` +`wodim -eject dev={{/dev/optical_drive}} -data {{file.iso}}` - Burn a file to the disc in an optical drive, potentially writing to multiple discs in succession: -`wodim -tao dev=/dev/{{optical_drive}} -data {{file.iso}}` +`wodim -tao dev={{/dev/optical_drive}} -data {{file.iso}}` diff --git a/pages/linux/xdg-open.md b/pages/linux/xdg-open.md index 8be7c748c..2d3ae179e 100644 --- a/pages/linux/xdg-open.md +++ b/pages/linux/xdg-open.md @@ -1,6 +1,6 @@ # xdg-open -> Opens a file or URL in the user's preferred application. +> Open a file or URL in the user's preferred application. > More information: . - Open the current directory in the default file explorer: diff --git a/pages/linux/xmount.md b/pages/linux/xmount.md index daa1e1122..cf930afe8 100644 --- a/pages/linux/xmount.md +++ b/pages/linux/xmount.md @@ -1,7 +1,7 @@ # xmount > Convert on-the-fly between multiple input and output hard disk image types with optional write cache support. -> Creates a virtual file system using FUSE (Filesystem in Userspace) that contains a virtual representation of the input image. +> Create a virtual file system using FUSE (Filesystem in Userspace) that contains a virtual representation of the input image. > More information: . - Mount a `.raw` image file into a DMG container file: diff --git a/pages/linux/xrandr.md b/pages/linux/xrandr.md index cd14c4f89..c917a21b1 100644 --- a/pages/linux/xrandr.md +++ b/pages/linux/xrandr.md @@ -26,3 +26,7 @@ - Set the brightness for LVDS1 to 50%: `xrandr --output {{LVDS1}} --brightness {{0.5}}` + +- Display the current state of any X server: + +`xrandr --display :{{0}} --query` diff --git a/pages/linux/xset.md b/pages/linux/xset.md index bbd87888d..22df01bf1 100644 --- a/pages/linux/xset.md +++ b/pages/linux/xset.md @@ -22,3 +22,7 @@ - Enable DPMS (Energy Star) features: `xset +dpms` + +- Query information on any X server: + +`xset -display :{{0}} q` diff --git a/pages/linux/ydotool.md b/pages/linux/ydotool.md new file mode 100644 index 000000000..b292e739d --- /dev/null +++ b/pages/linux/ydotool.md @@ -0,0 +1,20 @@ +# ydotool + +> Control keyboard and mouse inputs via commands in a way that is display server agnostic. +> More information: . + +- Start the ydotool daemon in the background: + +`ydotoold` + +- Perform a left click input: + +`ydotool click 0xC0` + +- Perform a right click input: + +`ydotool click 0xC1` + +- Input Alt+F4: + +`ydotool key 56:1 62:1 62:0 56:0` diff --git a/pages/linux/ytfzf.md b/pages/linux/ytfzf.md index 2b799d30e..6fc0e2899 100644 --- a/pages/linux/ytfzf.md +++ b/pages/linux/ytfzf.md @@ -1,6 +1,7 @@ # ytfzf -> A POSIX script that helps you find and download videos and music. +> Find and download videos and music. Written in POSIX shell. +> See also: `youtube-dl`, `yt-dlp`, `instaloader`. > More information: . - Search for videos on YouTube with thumbnail previews: diff --git a/pages/linux/zbarcam.md b/pages/linux/zbarcam.md index 1021328b6..133a7a4e9 100644 --- a/pages/linux/zbarcam.md +++ b/pages/linux/zbarcam.md @@ -17,4 +17,4 @@ - Define capture device: -`zbarcam /dev/{{video_device}}` +`zbarcam {{/dev/video_device}}` diff --git a/pages/linux/zip.md b/pages/linux/zip.md index b26eadd88..b98e28c64 100644 --- a/pages/linux/zip.md +++ b/pages/linux/zip.md @@ -1,6 +1,6 @@ # zip -> Package and compress (archive) files into `zip` archive. +> Package and compress (archive) files into a Zip archive. > See also: `unzip`. > More information: . @@ -24,7 +24,7 @@ `zip -r --encrypt {{path/to/compressed.zip}} {{path/to/file_or_directory1 path/to/file_or_directory2 ...}}` -- Archive files/directories to a multi-part [s]plit `zip` archive (e.g. 3 GB parts): +- Archive files/directories to a multi-part [s]plit Zip archive (e.g. 3 GB parts): `zip -r -s {{3g}} {{path/to/compressed.zip}} {{path/to/file_or_directory1 path/to/file_or_directory2 ...}}` diff --git a/pages/linux/zipsplit.md b/pages/linux/zipsplit.md index e2c1fec83..ecc6fe45f 100644 --- a/pages/linux/zipsplit.md +++ b/pages/linux/zipsplit.md @@ -1,16 +1,20 @@ # zipsplit -> Read a zipfile and split it into smaller zipfiles. +> Split a Zip archive into smaller Zip archives. > More information: . -- Split zipfile into pieces that are no larger than a particular size [n]: +- Split Zip archive into parts that are no larger than 36000 bytes (36 MB): + +`zipsplit {{path/to/archive.zip}}` + +- Use a given [n]umber of bytes as the part limit: `zipsplit -n {{size}} {{path/to/archive.zip}}` -- [p]ause between the creation of each split zipfile: +- [p]ause between the creation of each part: `zipsplit -p -n {{size}} {{path/to/archive.zip}}` -- Output the split zipfiles into the `archive` directory: +- Output the smaller Zip archives into a given directory: -`zipsplit -b {{archive}} -n {{size}} {{path/to/archive.zip}}` +`zipsplit -b {{path/to/output_directory}} -n {{size}} {{path/to/archive.zip}}` diff --git a/pages/osx/airportd.md b/pages/osx/airportd.md index d92296633..07ba5685d 100644 --- a/pages/osx/airportd.md +++ b/pages/osx/airportd.md @@ -1,6 +1,6 @@ # airportd -> Manages wireless interfaces. +> Manage wireless interfaces. > It should not be invoked manually. > More information: . diff --git a/pages/osx/appsleepd.md b/pages/osx/appsleepd.md index 3c4fec25d..1513f11c7 100644 --- a/pages/osx/appsleepd.md +++ b/pages/osx/appsleepd.md @@ -1,6 +1,6 @@ # appsleepd -> Provides app sleep services. +> Start app sleep services. > It should not be invoked manually. > More information: . diff --git a/pages/osx/autofsd.md b/pages/osx/autofsd.md index c99963345..1a5975e27 100644 --- a/pages/osx/autofsd.md +++ b/pages/osx/autofsd.md @@ -1,6 +1,6 @@ # autofsd -> Runs `automount` on startup and network configuration change events. +> Run `automount` on startup and network configuration change events. > It should not be invoked manually. > More information: . diff --git a/pages/osx/backupd.md b/pages/osx/backupd.md index dace3b931..cf6867c4a 100644 --- a/pages/osx/backupd.md +++ b/pages/osx/backupd.md @@ -1,6 +1,6 @@ # backupd -> Creates Time Machine backups and manages its backup history. +> Create Time Machine backups and manages its backup history. > It should not be invoked manually. > More information: . diff --git a/pages/osx/biometrickitd.md b/pages/osx/biometrickitd.md index 14c36cb1d..8e3224a10 100644 --- a/pages/osx/biometrickitd.md +++ b/pages/osx/biometrickitd.md @@ -1,6 +1,6 @@ # biometrickitd -> Provides support for biometric operations. +> Get support for biometric operations. > It should not be invoked manually. > More information: . diff --git a/pages/osx/cal.md b/pages/osx/cal.md index 6d2424fd6..1693171d7 100644 --- a/pages/osx/cal.md +++ b/pages/osx/cal.md @@ -1,6 +1,6 @@ # cal -> Prints calendar information. +> Print calendar information. > More information: . - Display a calendar for the current month: diff --git a/pages/osx/cfprefsd.md b/pages/osx/cfprefsd.md index 8ddd921b9..456bfd3f7 100644 --- a/pages/osx/cfprefsd.md +++ b/pages/osx/cfprefsd.md @@ -1,6 +1,6 @@ # cfprefsd -> Provides preferences services (`CFPreferences`, `NSUserDefaults`). +> Start preferences services (`CFPreferences`, `NSUserDefaults`). > It should not be invoked manually. > More information: . diff --git a/pages/osx/corebrightnessd.md b/pages/osx/corebrightnessd.md index 8bd94bccb..07bb29790 100644 --- a/pages/osx/corebrightnessd.md +++ b/pages/osx/corebrightnessd.md @@ -1,6 +1,6 @@ # corebrightnessd -> Manages Night Shift. +> Manage Night Shift. > It should not be invoked manually. > More information: . diff --git a/pages/osx/date.md b/pages/osx/date.md index f57a35a38..66d9f0142 100644 --- a/pages/osx/date.md +++ b/pages/osx/date.md @@ -17,4 +17,4 @@ - Display a specific date (represented as a Unix timestamp) using the default format: -`date -r 1473305798` +`date -r {{1473305798}}` diff --git a/pages/osx/dd.md b/pages/osx/dd.md index 6e6501fd0..7668725d9 100644 --- a/pages/osx/dd.md +++ b/pages/osx/dd.md @@ -5,28 +5,24 @@ - Make a bootable USB drive from an isohybrid file (such like `archlinux-xxx.iso`) and show the progress: -`dd if={{path/to/file.iso}} of={{/dev/usb_device}} status=progress` +`dd if={{path/to/file.iso}} of={{/dev/usb_drive}} status=progress` - Clone a drive to another drive with 4 MB block, ignore error and show the progress: -`dd if={{/dev/source_device}} of={{/dev/dest_device}} bs={{4m}} conv={{noerror}} status=progress` +`dd bs=4m conv=noerror if={{/dev/source_drive}} of={{/dev/dest_drive}} status=progress` -- Generate a file of 100 random bytes by using kernel random driver: +- Generate a file with a specific number of random bytes by using kernel random driver: -`dd if=/dev/urandom of={{path/to/random_file}} bs={{100}} count={{1}}` +`dd bs={{100}} count={{1}} if=/dev/urandom of={{path/to/random_file}}` - Benchmark the write performance of a disk: -`dd if=/dev/zero of={{path/to/1GB_file}} bs={{1024}} count={{1000000}}` +`dd bs={{1024}} count={{1000000}} if=/dev/zero of={{path/to/1GB_file}}` -- Generate a system backup into an IMG file and show the progress: +- Create a system backup, save it into an IMG file (can be restored later by swapping `if` and `of`), and show the progress: -`dd if=/dev/{{drive_device}} of={{path/to/file.img}} status=progress` +`dd if={{/dev/drive_device}} of={{path/to/file.img}} status=progress` -- Restore a drive from an IMG file and show the progress: - -`dd if={{path/to/file.img}} of={{/dev/drive_device}} status=progress` - -- Check the progress of an ongoing dd operation (run this command from another shell): +- Check the progress of an ongoing `dd` operation (run this command from another shell): `kill -USR1 $(pgrep ^dd)` diff --git a/pages/osx/distnoted.md b/pages/osx/distnoted.md index 689ed3a0b..8ff419031 100644 --- a/pages/osx/distnoted.md +++ b/pages/osx/distnoted.md @@ -1,6 +1,6 @@ # distnoted -> Provides distributed notification services. +> Start distributed notification services. > It should not be invoked manually. > More information: . diff --git a/pages/osx/fontd.md b/pages/osx/fontd.md index a55f40aa6..aa61c3df3 100644 --- a/pages/osx/fontd.md +++ b/pages/osx/fontd.md @@ -1,6 +1,6 @@ # fontd -> Makes fonts available to the system. +> Make fonts available to the system. > It should not be invoked manually. > More information: . diff --git a/pages/osx/internetsharing.md b/pages/osx/internetsharing.md index bb56b64c5..8ca89d55c 100644 --- a/pages/osx/internetsharing.md +++ b/pages/osx/internetsharing.md @@ -1,6 +1,6 @@ # InternetSharing -> Sets up Internet Sharing. +> Set up Internet Sharing. > It should not be invoked manually. > More information: . diff --git a/pages/osx/look.md b/pages/osx/look.md index 68ccf72af..80994687a 100644 --- a/pages/osx/look.md +++ b/pages/osx/look.md @@ -10,11 +10,11 @@ - Case-insensitively search only on alphanumeric characters: -`look -{{f|-ignore-case}} -{{d|-alphanum}} {{prefix}} {{path/to/file}}` +`look {{-f|--ignore-case}} {{-d|--alphanum}} {{prefix}} {{path/to/file}}` -- Specify a string [t]ermination character (space by default): +- Specify a string termination character (space by default): -`look -{{t|-terminate}} {{,}}` +`look {{-t|--terminate}} {{,}}` - Search in `/usr/share/dict/words` (`--ignore-case` and `--alphanum` are assumed): diff --git a/pages/osx/mist.md b/pages/osx/mist.md new file mode 100644 index 000000000..1ad4f6be8 --- /dev/null +++ b/pages/osx/mist.md @@ -0,0 +1,37 @@ +# mist + +> MIST - macOS Installer Super Tool. +> Automatically download macOS Firmwares/Installers. +> More information: . + +- List all available macOS Firmwares for Apple Silicon Macs: + +`mist list firmware` + +- List all available macOS Installers for Intel Macs, including Universal Installers for macOS Big Sur and later: + +`mist list installer` + +- List all macOS Installers that are compatible with this Mac, including Universal Installers for macOS Big Sur and later: + +`mist list installer --compatible` + +- List all available macOS Installers for Intel Macs, including betas, also including Universal Installers for macOS Big Sur and later: + +`mist list installer --include-betas` + +- List only the latest macOS Sonoma Installer for Intel Macs, including Universal Installers for macOS Big Sur and later: + +`mist list installer --latest "macOS Sonoma"` + +- List and export macOS Installers to a CSV file: + +`mist list installer --export "{{/path/to/export.csv}}"` + +- Download the latest macOS Sonoma Firmware for Apple Silicon Macs, with a custom name: + +`mist download firmware "macOS Sonoma" --firmware-name "{{Install %NAME% %VERSION%-%BUILD%.ipsw}}"` + +- Download a specific macOS Installer version for Intel Macs, including Universal Installers for macOS Big Sur and later: + +`mist download installer "{{13.5.2}}" application` diff --git a/pages/osx/netstat.md b/pages/osx/netstat.md new file mode 100644 index 000000000..9888b1cf7 --- /dev/null +++ b/pages/osx/netstat.md @@ -0,0 +1,16 @@ +# netstat + +> Display network-related information such as open connections, open socket ports, etc. +> More information: . + +- Display the PID and program name listening on a specific protocol: + +`netstat -p {{protocol}}` + +- Print the routing table and do not resolve IP addresses to hostnames: + +`netstat -nr` + +- Print the routing table of IPv4 addresses: + +`netstat -nr -f inet` diff --git a/pages/osx/open.md b/pages/osx/open.md index 6ecd4ee19..82052d9f7 100644 --- a/pages/osx/open.md +++ b/pages/osx/open.md @@ -1,6 +1,6 @@ # open -> Opens files, directories and applications. +> Open files, directories and applications. > More information: . - Open a file with the associated application: diff --git a/pages/osx/ping.md b/pages/osx/ping.md index 28e2f7e48..b3be5b38b 100644 --- a/pages/osx/ping.md +++ b/pages/osx/ping.md @@ -11,18 +11,18 @@ `ping -c {{count}} "{{host}}"` -- Ping `host`, specifying the interval in `seconds` between requests (default is 1 second): +- Ping a host, specifying the interval in seconds between requests (default is 1 second): `ping -i {{seconds}} "{{host}}"` -- Ping `host` without trying to lookup symbolic names for addresses: +- Ping a host without trying to lookup symbolic names for addresses: `ping -n "{{host}}"` -- Ping `host` and ring the bell when a packet is received (if your terminal supports it): +- Ping a host and ring the bell when a packet is received (if your terminal supports it): `ping -a "{{host}}"` -- Ping `host` and prints the time a packet was received (this option is an Apple addition): +- Ping a host and prints the time a packet was received (this option is an Apple addition): `ping --apple-time "{{host}}"` diff --git a/pages/osx/route.md b/pages/osx/route.md index fc9ba5da6..229c6f31a 100644 --- a/pages/osx/route.md +++ b/pages/osx/route.md @@ -1,7 +1,7 @@ # route > Manually manipulate the routing tables. -> Necessitates to be root. +> Requires root privileges. > More information: . - Add a route to a destination through a gateway: diff --git a/pages/osx/say.md b/pages/osx/say.md index 822949d21..860e9d17a 100644 --- a/pages/osx/say.md +++ b/pages/osx/say.md @@ -1,6 +1,6 @@ # say -> Converts text to speech. +> Convert text to speech. > More information: . - Say a phrase aloud: diff --git a/pages/osx/scutil.md b/pages/osx/scutil.md index 5d616df34..01caec47b 100644 --- a/pages/osx/scutil.md +++ b/pages/osx/scutil.md @@ -1,7 +1,7 @@ # scutil > Manage system configuration parameters. -> Necessitates to be root when setting configuration. +> Require root privileges when setting configuration. > More information: . - Display DNS Configuration: diff --git a/pages/osx/setfile.md b/pages/osx/setfile.md index d3663140e..59203cecb 100644 --- a/pages/osx/setfile.md +++ b/pages/osx/setfile.md @@ -1,6 +1,6 @@ # setfile -> Sets file attributes on files in an HFS+ directory. +> Set file attributes on files in an HFS+ directory. > More information: . - Set creation date for specific files: diff --git a/pages/osx/shuf.md b/pages/osx/shuf.md index 011f92043..896da1971 100644 --- a/pages/osx/shuf.md +++ b/pages/osx/shuf.md @@ -5,16 +5,16 @@ - Randomize the order of lines in a file and output the result: -`shuf {{filename}}` +`shuf {{path/to/file}}` - Only output the first 5 entries of the result: -`shuf --head-count={{5}} {{filename}}` +`shuf --head-count=5 {{path/to/file}}` - Write output to another file: -`shuf {{filename}} --output={{output_filename}}` +`shuf {{path/to/input_file}} --output={{ath/to/output_file}}` - Generate random numbers in the range 1 to 10: -`shuf --input-range={{1-10}}` +`shuf --input-range=1-10` diff --git a/pages/osx/sntpd.md b/pages/osx/sntpd.md index eb8dc7aa8..c65e25606 100644 --- a/pages/osx/sntpd.md +++ b/pages/osx/sntpd.md @@ -2,7 +2,7 @@ > An SNTP server. > It should not be invoked manually. -> More information: . +> More information: . - Start the daemon: diff --git a/pages/osx/split.md b/pages/osx/split.md index 243da717a..17b91647f 100644 --- a/pages/osx/split.md +++ b/pages/osx/split.md @@ -5,16 +5,16 @@ - Split a file, each split having 10 lines (except the last split): -`split -l {{10}} {{filename}}` +`split -l 10 {{path/to/file}}` - Split a file by a regular expression. The matching line will be the first line of the next output file: -`split -p {{cat|^[dh]og}} {{filename}}` +`split -p {{cat|^[dh]og}} {{path/to/file}}` - Split a file with 512 bytes in each split (except the last split; use 512k for kilobytes and 512m for megabytes): -`split -b {{512}} {{filename}}` +`split -b 512 {{path/to/file}}` - Split a file into 5 files. File is split such that each split has same size (except the last split): -`split -n {{5}} {{filename}}` +`split -n 5 {{path/to/file}}` diff --git a/pages/osx/universalaccessd.md b/pages/osx/universalaccessd.md index 29b15bf48..ac2f14c85 100644 --- a/pages/osx/universalaccessd.md +++ b/pages/osx/universalaccessd.md @@ -1,6 +1,6 @@ # universalaccessd -> Provides universal access services. +> Get universal access services. > It should not be invoked manually. > More information: . diff --git a/pages/osx/watchlistd.md b/pages/osx/watchlistd.md index 4f83ec2fb..ae88ebda8 100644 --- a/pages/osx/watchlistd.md +++ b/pages/osx/watchlistd.md @@ -1,6 +1,6 @@ # watchlistd -> Manages the Apple TV app's watch list. +> Manage the Apple TV app's watch list. > It should not be invoked manually. > More information: . diff --git a/pages/osx/whence.md b/pages/osx/whence.md index 885ed64c8..1c3676b33 100644 --- a/pages/osx/whence.md +++ b/pages/osx/whence.md @@ -1,6 +1,6 @@ # whence -> A zsh builtin to indicate how a command would be interpreted. +> A Zsh builtin to indicate how a command would be interpreted. > More information: . - Interpret `command`, with expansion if defined as an `alias` (similar to the `command -v` builtin): diff --git a/pages/osx/yaa.md b/pages/osx/yaa.md index eab7c0f1f..37b5b7077 100644 --- a/pages/osx/yaa.md +++ b/pages/osx/yaa.md @@ -25,4 +25,4 @@ - Create an archive with an 8 MB block size: -`yaa archive -b {{8m}} -d {{path/to/directory}} -o {{path/to/output_file.yaa}}` +`yaa archive -b 8m -d {{path/to/directory}} -o {{path/to/output_file.yaa}}` diff --git a/pages/sunos/prstat.md b/pages/sunos/prstat.md index 3f481821a..1ceab064f 100644 --- a/pages/sunos/prstat.md +++ b/pages/sunos/prstat.md @@ -21,4 +21,4 @@ - Print out a list of top 5 CPU using processes every second: -`prstat -c -n {{5}} -s cpu {{1}}` +`prstat -c -n 5 -s cpu 1` diff --git a/pages/windows/clear-host.md b/pages/windows/clear-host.md index 910cd9786..cf2cd66d7 100644 --- a/pages/windows/clear-host.md +++ b/pages/windows/clear-host.md @@ -1,7 +1,7 @@ # Clear-Host > Clears the screen. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Clear the screen: diff --git a/pages/windows/date.md b/pages/windows/date.md index 4be38a167..9d7246d6b 100644 --- a/pages/windows/date.md +++ b/pages/windows/date.md @@ -1,6 +1,6 @@ # date -> Displays or sets the system date. +> Display or set the system date. > More information: . - Display the current system date and prompt to enter a new date (leave empty to keep unchanged): diff --git a/pages/windows/enable-pnpdevice.md b/pages/windows/enable-pnpdevice.md new file mode 100644 index 000000000..f4d55687a --- /dev/null +++ b/pages/windows/enable-pnpdevice.md @@ -0,0 +1,21 @@ +# Enable-PnpDevice + +> The Enable-PnpDevice cmdlet enables a Plug and Play (PnP) device. You must use an Administrator account to enable a device. +> Note: This command can only be used through PowerShell. +> More information: . + +- Enable a device: + +`Enable-PnpDevice -InstanceId 'RETRIEVED USING Get-PnpDevice COMMAND'` + +- Enable all disabled PnP devices: + +`Get-PnpDevice | Where-Object {$_.Problem -eq 22} | Enable-PnpDevice` + +- Enable a device without confirmation: + +`Enable-PnpDevice -InstanceId 'RETRIEVED USING Get-PnpDevice COMMAND' -Confirm:$False` + +- Dry run of what would happen if the cmdlet runs: + +`Enable-PnpDevice -InstanceId 'USB\VID_5986&;PID_0266&;MI_00\7&;1E5D3568&;0&;0000' -WhatIf:$True` diff --git a/pages/windows/fsutil.md b/pages/windows/fsutil.md index 6ac745186..41e966988 100644 --- a/pages/windows/fsutil.md +++ b/pages/windows/fsutil.md @@ -1,6 +1,6 @@ # fsutil -> Displays information about file system volumes. +> Display information about file system volumes. > More information: . - Display a list of volumes: diff --git a/pages/windows/get-acl.md b/pages/windows/get-acl.md index 1f1cb3a77..41d4ee4a9 100644 --- a/pages/windows/get-acl.md +++ b/pages/windows/get-acl.md @@ -1,7 +1,7 @@ # Get-Acl -> Gets the security descriptor for a resource, such as a file or registry key. -> This command can only be used through PowerShell. +> Get the security descriptor for a resource, such as a file or registry key. +> Note: This command can only be used through PowerShell. > More information: . - Display the ACL for a specific directory: diff --git a/pages/windows/get-childitem.md b/pages/windows/get-childitem.md index 008ed35c7..d0f265caa 100644 --- a/pages/windows/get-childitem.md +++ b/pages/windows/get-childitem.md @@ -1,7 +1,7 @@ # Get-ChildItem > List items in a directory. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - List all non-hidden items in the current directory: diff --git a/pages/windows/get-content.md b/pages/windows/get-content.md index 81aed6161..da5f0ce9b 100644 --- a/pages/windows/get-content.md +++ b/pages/windows/get-content.md @@ -1,7 +1,7 @@ # Get-Content > Get the content of the item at the specified location. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Display the content of a file: diff --git a/pages/windows/get-date.md b/pages/windows/get-date.md index 76f633580..25a6534fd 100644 --- a/pages/windows/get-date.md +++ b/pages/windows/get-date.md @@ -1,7 +1,7 @@ # Get-Date -> Gets the current date and time. -> This command can only be used through PowerShell. +> Get the current date and time. +> Note: This command can only be used through PowerShell. > More information: . - Display the current date and time: diff --git a/pages/windows/get-dedupproperties.md b/pages/windows/get-dedupproperties.md new file mode 100644 index 000000000..63aa73a16 --- /dev/null +++ b/pages/windows/get-dedupproperties.md @@ -0,0 +1,17 @@ +# Get-DedupProperties + +> Gets Data Deduplication information. +> Note: This command can only be used through PowerShell. +> More information: . + +- Get Data Deduplication information of the drive: + +`Get-DedupProperties -DriveLetter 'C'` + +- Get Data Deduplication information of the drive using the drive label: + +`Get-DedupProperties -FileSystemLabel 'Label'` + +- Get Data Dedpulication information of the drive using the input object: + +`Get-DedupProperties -InputObject $(Get-Volume -DriveLetter 'E')` diff --git a/pages/windows/get-filehash.md b/pages/windows/get-filehash.md index cf2f5941b..851963ee0 100644 --- a/pages/windows/get-filehash.md +++ b/pages/windows/get-filehash.md @@ -1,7 +1,7 @@ # Get-FileHash > Calculate a hash for a file. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Calculate a hash for a specified file using the SHA256 algorithm: diff --git a/pages/windows/get-history.md b/pages/windows/get-history.md index 5522df3ea..39a94d714 100644 --- a/pages/windows/get-history.md +++ b/pages/windows/get-history.md @@ -1,7 +1,7 @@ # Get-History > Display PowerShell command history. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Display the commands history list with ID: diff --git a/pages/windows/invoke-item.md b/pages/windows/invoke-item.md index c6201bce6..287e772c2 100644 --- a/pages/windows/invoke-item.md +++ b/pages/windows/invoke-item.md @@ -1,7 +1,7 @@ # Invoke-Item > Open files in their respective default programs. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Open a file in its default program: diff --git a/pages/windows/invoke-webrequest.md b/pages/windows/invoke-webrequest.md index f747e8cef..734489de2 100644 --- a/pages/windows/invoke-webrequest.md +++ b/pages/windows/invoke-webrequest.md @@ -1,7 +1,7 @@ # Invoke-WebRequest > Performs a HTTP/HTTPS request to the Web. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Download the contents of a URL to a file: diff --git a/pages/windows/logoff.md b/pages/windows/logoff.md index 3bff46728..267971cbd 100644 --- a/pages/windows/logoff.md +++ b/pages/windows/logoff.md @@ -7,7 +7,7 @@ `logoff` -- Terminate a session by its name or id: +- Terminate a session by its name or ID: `logoff {{session_name|session_id}}` diff --git a/pages/windows/measure-command.md b/pages/windows/measure-command.md index 03bfd5277..623745781 100644 --- a/pages/windows/measure-command.md +++ b/pages/windows/measure-command.md @@ -1,7 +1,7 @@ # Measure-Command > Measures the time it takes to run script blocks and cmdlets. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Measure the time it takes to run a command: diff --git a/pages/windows/measure-object.md b/pages/windows/measure-object.md index e3e4715d6..cbd88ac33 100644 --- a/pages/windows/measure-object.md +++ b/pages/windows/measure-object.md @@ -1,7 +1,7 @@ # Measure-Object > Calculates the numeric properties of objects, and the characters, words, and lines in string objects, such as files of text. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Count the files and folders in a directory: diff --git a/pages/windows/mkdir.md b/pages/windows/mkdir.md index aa4933206..8a7847e61 100644 --- a/pages/windows/mkdir.md +++ b/pages/windows/mkdir.md @@ -1,6 +1,6 @@ # mkdir -> Creates a directory. +> Create a directory. > More information: . - Create a directory: diff --git a/pages/windows/netstat.md b/pages/windows/netstat.md index e3d265cb1..3db2a4be3 100644 --- a/pages/windows/netstat.md +++ b/pages/windows/netstat.md @@ -1,6 +1,6 @@ # netstat -> Displays active TCP connections, ports on which the computer is listening, network adapter statistics, the IP routing table, IPv4 statistics and IPv6 statistics. +> Display active TCP connections, ports on which the computer is listening, network adapter statistics, the IP routing table, IPv4 statistics and IPv6 statistics. > More information: . - Display active TCP connections: diff --git a/pages/windows/new-item.md b/pages/windows/new-item.md index 5bf4d9f07..d6f63f789 100644 --- a/pages/windows/new-item.md +++ b/pages/windows/new-item.md @@ -1,7 +1,7 @@ # New-Item > Create a new file, directory, symbolic link, or a registry entry. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Create a new blank file (equivalent to `touch`): diff --git a/pages/windows/ospp.vbs.md b/pages/windows/ospp.vbs.md new file mode 100644 index 000000000..dac165de6 --- /dev/null +++ b/pages/windows/ospp.vbs.md @@ -0,0 +1,29 @@ +# ospp.vbs + +> Install, activate, and manage volume licensed versions of Microsoft Office products. +> Note: this command may override, deactivate, and/or remove your current volume of licensed Office product versions, so please proceed cautiously. +> More information: . + +- Install a product key (Note: it replaces the existing key): + +`cscript ospp.vbs /inpkey:{{product_key}}` + +- Uninstall an installed product key with the last five digits of the product key: + +`cscript ospp.vbs /unpkey:{{product_key_digits}}` + +- Set a KMS host name: + +`cscript ospp.vbs /sethst:{{ip|hostname}}` + +- Set a KMS port: + +`cscript ospp.vbs /setprt:{{port}}` + +- Activate installed Office product keys: + +`cscript ospp.vbs /act` + +- Display license information for installed product keys: + +`cscript ospp.vbs /dstatus` diff --git a/pages/windows/out-string.md b/pages/windows/out-string.md index 2a946af9c..4dcda8b22 100644 --- a/pages/windows/out-string.md +++ b/pages/windows/out-string.md @@ -1,7 +1,7 @@ # Out-String > Outputs input objects as a string. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Print host information as string: diff --git a/pages/windows/query.md b/pages/windows/query.md index 981cc016d..ae4406436 100644 --- a/pages/windows/query.md +++ b/pages/windows/query.md @@ -1,6 +1,6 @@ # query -> Displays information about user sessions and process. +> Display information about user sessions and process. > More information: . - Display all user sessions: diff --git a/pages/windows/reg-query.md b/pages/windows/reg-query.md index 110ce3d0f..76b7a471c 100644 --- a/pages/windows/reg-query.md +++ b/pages/windows/reg-query.md @@ -29,7 +29,7 @@ - Only search in [k]ey names: -`reg query {{key_name}} /f /k` +`reg query {{key_name}} /f "{{query_pattern}}" /k` - [c]ase-sensitively search for an [e]xact match: diff --git a/pages/windows/resolve-path.md b/pages/windows/resolve-path.md index 99d62e9f0..636dc8680 100644 --- a/pages/windows/resolve-path.md +++ b/pages/windows/resolve-path.md @@ -1,7 +1,7 @@ # Resolve-Path > Resolves the wildcard characters in a path, and displays the path contents. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Resolve the home folder path: diff --git a/pages/windows/select-string.md b/pages/windows/select-string.md index 788925527..106ca0e11 100644 --- a/pages/windows/select-string.md +++ b/pages/windows/select-string.md @@ -1,7 +1,7 @@ # Select-String > Finds text in strings and files in PowerShell. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > You can use `Select-String` similar to `grep` in UNIX or `findstr.exe` in Windows. > More information: . diff --git a/pages/windows/set-acl.md b/pages/windows/set-acl.md index f9f9a3f4c..3934f6b53 100644 --- a/pages/windows/set-acl.md +++ b/pages/windows/set-acl.md @@ -1,7 +1,7 @@ # Set-Acl > Changes the security descriptor of a specified item, such as a file or a registry key. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Copy a security descriptor from one file to another: diff --git a/pages/windows/set-date.md b/pages/windows/set-date.md index 787dfe779..bedd2cd27 100644 --- a/pages/windows/set-date.md +++ b/pages/windows/set-date.md @@ -1,7 +1,7 @@ # Set-Date > Changes the system time on the computer to a time that you specify. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Add three days to the system date: diff --git a/pages/windows/set-location.md b/pages/windows/set-location.md index 320c5ddb6..c8a8207f9 100644 --- a/pages/windows/set-location.md +++ b/pages/windows/set-location.md @@ -1,7 +1,7 @@ # Set-Location > Display the current working directory or move to a different directory. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Go to the specified directory: diff --git a/pages/windows/set-service.md b/pages/windows/set-service.md index 1b594b45b..5aaca33a4 100644 --- a/pages/windows/set-service.md +++ b/pages/windows/set-service.md @@ -1,7 +1,7 @@ # Set-Service > Starts, stops, and suspends a service, and changes its properties. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Change a display name: diff --git a/pages/windows/set-volume.md b/pages/windows/set-volume.md new file mode 100644 index 000000000..85152c433 --- /dev/null +++ b/pages/windows/set-volume.md @@ -0,0 +1,21 @@ +# Set-Volume + +> Sets or changes the file system label of an existing volume. +> Note: This command can only be used through PowerShell. +> More information: . + +- Change the file system label of a volume identified by drive letter: + +`Set-Volume -DriveLetter "D" -NewFileSystemLabel "DataVolume"` + +- Change the file system label of a volume identified by the system label: + +`Set-Volume -FileSystemLabel "OldLabel" -NewFileSystemLabel "NewLabel"` + +- Modify the properties of a volume using a volume object: + +`Set-Volume -InputObject $(Get-Volume -DriveLetter "E") -NewFileSystemLabel "Backup"` + +- Specify the Data Deduplication mode for the volume: + +`Set-Volume -DriveLetter "D" -DedupMode Backup` diff --git a/pages/windows/setx.md b/pages/windows/setx.md index eeb806194..4e432997b 100644 --- a/pages/windows/setx.md +++ b/pages/windows/setx.md @@ -1,6 +1,6 @@ # setx -> Sets persistent environment variables. +> Set persistent environment variables. > More information: . - Set an environment variable for the current user: diff --git a/pages/windows/show-markdown.md b/pages/windows/show-markdown.md index b7503b340..76dcbc820 100644 --- a/pages/windows/show-markdown.md +++ b/pages/windows/show-markdown.md @@ -1,7 +1,7 @@ # Show-Markdown > Shows a Markdown file or string in the console in a friendly way using VT100 escape sequences or in a browser using HTML. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Render markdown to console from a file: diff --git a/pages/windows/sort-object.md b/pages/windows/sort-object.md index 1b0d617ff..b3394d1b9 100644 --- a/pages/windows/sort-object.md +++ b/pages/windows/sort-object.md @@ -1,7 +1,7 @@ # Sort-Object > Sorts objects by property values. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Sort the current directory by name: diff --git a/pages/windows/start-service.md b/pages/windows/start-service.md index 7d817a2df..370bc0657 100644 --- a/pages/windows/start-service.md +++ b/pages/windows/start-service.md @@ -1,7 +1,7 @@ # Start-Service > Starts stopped services. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Start a service by using its name: diff --git a/pages/windows/stop-service.md b/pages/windows/stop-service.md index c84c11cf9..36448212e 100644 --- a/pages/windows/stop-service.md +++ b/pages/windows/stop-service.md @@ -1,7 +1,7 @@ # Stop-Service > Stops running services. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Stop a service on the local computer: diff --git a/pages/windows/tee-object.md b/pages/windows/tee-object.md index 9bf9d5d44..bf7b4148b 100644 --- a/pages/windows/tee-object.md +++ b/pages/windows/tee-object.md @@ -1,7 +1,7 @@ # Tee-Object > Saves command output in a file or variable and also sends it down the pipeline. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Output processes to a file and to the console: diff --git a/pages/windows/test-json.md b/pages/windows/test-json.md index 4b25ba736..c13e869f4 100644 --- a/pages/windows/test-json.md +++ b/pages/windows/test-json.md @@ -1,7 +1,7 @@ # Test-Json > Test whether a string is a valid JSON document. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Test if a string from `stdin` is in JSON format: diff --git a/pages/windows/test-netconnection.md b/pages/windows/test-netconnection.md new file mode 100644 index 000000000..025513df8 --- /dev/null +++ b/pages/windows/test-netconnection.md @@ -0,0 +1,13 @@ +# Test-NetConnection + +> Display diagnostic information for a connection. +> Note: This command can only be used through PowerShell. +> More information: . + +- Test a connection and display detailed results: + +`Test-NetConnection -InformationLevel Detailed` + +- Test a connection to a remote host using the specified port number: + +`Test-NetConnection -ComputerName {{ip_or_hostname}} -Port {{port_number}}` diff --git a/pages/windows/wait-process.md b/pages/windows/wait-process.md index 93e3cad43..7e1f4033d 100644 --- a/pages/windows/wait-process.md +++ b/pages/windows/wait-process.md @@ -1,7 +1,7 @@ # Wait-Process > Waits for the processes to be stopped before accepting more input. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Stop a process and wait: diff --git a/pages/windows/where-object.md b/pages/windows/where-object.md index 74465aa1b..8d95a3133 100644 --- a/pages/windows/where-object.md +++ b/pages/windows/where-object.md @@ -1,7 +1,7 @@ # Where-Object > Selects objects from a collection based on their property values. -> This command can only be used through PowerShell. +> Note: This command can only be used through PowerShell. > More information: . - Filter aliases by its name: diff --git a/requirements.txt b/requirements.txt index 032d2faca..bf5a52f4a 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,3 +1,3 @@ -black==24.2.0 +black==24.4.2 flake8==7.0.0 -requests==2.31.0 +requests==2.32.3 diff --git a/scripts/README.md b/scripts/README.md index b585127ac..a2c2b6790 100644 --- a/scripts/README.md +++ b/scripts/README.md @@ -2,6 +2,9 @@ The current directory contains useful scripts used/to use with `tldr` pages. +> [!NOTE] +> [Git](https://git-scm.com/) and [Python](https://www.python.org/) must be installed in your system to run/test the scripts locally. + ## Summary This section contains a summary of the scripts available in this directory. For more information about each script, please refer to the header of each script. @@ -9,25 +12,27 @@ This section contains a summary of the scripts available in this directory. For - [pdf](pdf/README.md) directory contains the `render.py` and `build-pdf.sh` script and related resources to generate a PDF document of tldr-pages for a specific language or platform (or both). - [build.sh](build.sh) script builds the ZIP archives of the `pages` directory. - [build-index.sh](build-index.sh) script builds the index of available pages. -- [check-pr.sh](check-pr.sh) script checks the pages syntax and performs various checks on the PR. +- [check-pr.sh](check-pr.sh) script checks the page's syntax and performs various checks on the PR. - [deploy.sh](deploy.sh) script deploys the ZIP and PDF archives to the static website repository. -- [send-to-bot.py](send-to-bot.py) is a Python script that send the build or tests output to tldr-bot. +- [send-to-bot.py](send-to-bot.py) is a Python script that sends the build or test output to tldr-bot. - [set-alias-page.py](set-alias-page.py) is a Python script to generate or update alias pages. - [set-more-info-link.py](set-more-info-link.py) is a Python script to generate or update more information links across pages. -- [test.sh](test.sh) script runs some basic tests on every PR/commit to make sure that the pages are valid and that the code is formatted correctly. +- [set-page-title.py](set-page-title.py) is a Python script to update the title across pages. +- [test.sh](test.sh) script runs some basic tests on every PR/commit to ensure the pages are valid and the code is formatted correctly. - [wrong-filename.sh](wrong-filename.sh) script checks the consistency between the filenames and the page title. - [update-command.py](update-command.py) is a Python script to update the common contents of a command example across all languages. ## Compatibility -The below table shows the compatibility of user-executable scripts with different platforms. +The table below shows the compatibility of user-executable scripts with different platforms: | Script | Linux | macOS (`osx`) | Windows | | ------ | ----- | ----- | ------- | | [render.py](pdf/render.py) | ✅ | ✅ | ✅ | -| [build-pdf.sh](pdf/build-pdf.sh) | ✅ | ✅ | ❌ | -| [build.sh](build.sh) | ✅ | ✅ | ❌ | +| [build-pdf.sh](pdf/build-pdf.sh) | ✅ | ✅ | ❌ (WSL ✅)| +| [build.sh](build.sh) | ✅ | ✅ | ❌ (WSL ✅)| | [set-alias-pages.py](set-alias-pages.py) | ✅ | ✅ | ✅ | | [set-more-info-link.py](set-more-info-link.py) | ✅ | ✅ | ✅ | -| [wrong-filename.sh](wrong-filename.sh) | ✅ | ❌ | ❌ | +| [set-page-title.py](set-page-title.py) | ✅ | ✅ | ✅ | +| [wrong-filename.sh](wrong-filename.sh) | ✅ | ❌ | ❌ (WSL ✅)| | [update-command.py](update-command.py) | ✅ | ✅ | ✅ | diff --git a/scripts/_common.py b/scripts/_common.py new file mode 100644 index 000000000..4d6847748 --- /dev/null +++ b/scripts/_common.py @@ -0,0 +1,393 @@ +#!/usr/bin/env python3 +# SPDX-License-Identifier: MIT + +""" +A Python file that makes some commonly used functions available for other scripts to use. +""" + +from enum import Enum +from pathlib import Path +from unittest.mock import patch +import shutil +import os +import argparse +import subprocess + +IGNORE_FILES = (".DS_Store",) + + +class Colors(str, Enum): + def __str__(self): + return str( + self.value + ) # make str(Colors.COLOR) return the ANSI code instead of an Enum object + + RED = "\x1b[31m" + GREEN = "\x1b[32m" + BLUE = "\x1b[34m" + CYAN = "\x1b[36m" + RESET = "\x1b[0m" + + +def test_ignore_files(): + assert IGNORE_FILES == (".DS_Store",) + assert ".DS_Store" in IGNORE_FILES + assert "tldr.md" not in IGNORE_FILES + + +def get_tldr_root(lookup_path: Path = None) -> Path: + """ + Get the path of the local tldr repository, looking for it in each part of the given path. If it is not found, the path in the environment variable TLDR_ROOT is returned. + + Parameters: + lookup_path (Path): the path to search for the tldr root. By default, the path of the script. + + Returns: + Path: the local tldr repository. + """ + + if lookup_path is None: + absolute_lookup_path = Path(__file__).resolve() + else: + absolute_lookup_path = Path(lookup_path).resolve() + if ( + tldr_root := next( + (path for path in absolute_lookup_path.parents if path.name == "tldr"), None + ) + ) is not None: + return tldr_root + elif "TLDR_ROOT" in os.environ: + return Path(os.environ["TLDR_ROOT"]) + raise SystemExit( + f"{Colors.RED}Please set the environment variable TLDR_ROOT to the location of a clone of https://github.com/tldr-pages/tldr{Colors.RESET}" + ) + + +def test_get_tldr_root(): + tldr_root = get_tldr_root("/path/to/tldr/scripts/test_script.py") + assert tldr_root == Path("/path/to/tldr") + + # Set TLDR_ROOT in the environment + os.environ["TLDR_ROOT"] = "/path/to/tldr_clone" + + tldr_root = get_tldr_root("/tmp") + assert tldr_root == Path("/path/to/tldr_clone") + + del os.environ["TLDR_ROOT"] + + # Remove TLDR_ROOT from the environment + original_env = os.environ.pop("TLDR_ROOT", None) + + # Check if SystemExit is raised + raised = False + try: + get_tldr_root("/tmp") + except SystemExit: + raised = True + assert raised + + # Restore the original values + if original_env is not None: + os.environ["TLDR_ROOT"] = original_env + + +def get_pages_dir(root: Path) -> list[Path]: + """ + Get all pages directories. + + Parameters: + root (Path): the path to search for the pages directories. + + Returns: + list (list of Path's): Path's of page entry and platform, e.g. "page.fr/common". + """ + + return [d for d in root.iterdir() if d.name.startswith("pages")] + + +def test_get_pages_dir(): + # Create temporary directories with names starting with "pages" + + root = Path("test_root") + + shutil.rmtree(root, True) + + root.mkdir(exist_ok=True) + + # Create temporary directories with names that do not start with "pages" + (root / "other_dir_1").mkdir(exist_ok=True) + (root / "other_dir_2").mkdir(exist_ok=True) + + # Call the function and verify that it returns an empty list + result = get_pages_dir(root) + assert result == [] + + (root / "pages").mkdir(exist_ok=True) + (root / "pages.fr").mkdir(exist_ok=True) + (root / "other_dir").mkdir(exist_ok=True) + + # Call the function and verify the result + result = get_pages_dir(root) + expected = [root / "pages", root / "pages.fr"] + assert result.sort() == expected.sort() # the order differs on Unix / macOS + + shutil.rmtree(root, True) + + +def get_target_paths(page: Path, pages_dirs: Path) -> list[Path]: + """ + Get all paths in all languages that match the page. + + Parameters: + page (Path): the page to search for. + + Returns: + list (list of Path's): A list of Path's. + """ + + target_paths = [] + + if not page.lower().endswith(".md"): + page = f"{page}.md" + arg_platform, arg_page = page.split("/") + + for pages_dir in pages_dirs: + page_path = pages_dir / arg_platform / arg_page + + if not page_path.exists(): + continue + target_paths.append(page_path) + + target_paths.sort() + + return target_paths + + +def test_get_target_paths(): + root = Path("test_root") + + shutil.rmtree(root, True) + + root.mkdir(exist_ok=True) + + shutil.os.makedirs(root / "pages" / "common") + shutil.os.makedirs(root / "pages.fr" / "common") + + file_path = root / "pages" / "common" / "tldr.md" + with open(file_path, "w"): + pass + + file_path = root / "pages.fr" / "common" / "tldr.md" + with open(file_path, "w"): + pass + + target_paths = get_target_paths("common/tldr", get_pages_dir(root)) + for path in target_paths: + rel_path = "/".join(path.parts[-3:]) + print(rel_path) + + shutil.rmtree(root, True) + + +def get_locale(path: Path) -> str: + """ + Get the locale from the path. + + Parameters: + path (Path): the path to extract the locale. + + Returns: + str: a POSIX Locale Name in the form of "ll" or "ll_CC" (e.g. "fr" or "pt_BR"). + """ + + # compute locale + pages_dirname = path.parents[1].name + if "." in pages_dirname: + _, locale = pages_dirname.split(".") + else: + locale = "en" + + return locale + + +def test_get_locale(): + assert get_locale(Path("path/to/pages.fr/common/tldr.md")) == "fr" + + assert get_locale(Path("path/to/pages/common/tldr.md")) == "en" + + assert get_locale(Path("path/to/other/common/tldr.md")) == "en" + + +def get_status(action: str, dry_run: bool, type: str) -> str: + """ + Get a colored status line. + + Parameters: + action (str): The action to perform. + dry_run (bool): Whether to perform a dry-run. + type (str): The kind of object to modify (alias, link). + + Returns: + str: A colored line + """ + + match action: + case "added": + start_color = Colors.CYAN + case "updated": + start_color = Colors.BLUE + case _: + start_color = Colors.RED + + if dry_run: + status = f"{type} would be {action}" + else: + status = f"{type} {action}" + + return create_colored_line(start_color, status) + + +def test_get_status(): + # Test dry run status + assert ( + get_status("added", True, "alias") + == f"{Colors.CYAN}alias would be added{Colors.RESET}" + ) + assert ( + get_status("updated", True, "link") + == f"{Colors.BLUE}link would be updated{Colors.RESET}" + ) + + # Test non-dry run status + assert ( + get_status("added", False, "alias") == f"{Colors.CYAN}alias added{Colors.RESET}" + ) + assert ( + get_status("updated", False, "link") + == f"{Colors.BLUE}link updated{Colors.RESET}" + ) + + # Test default color for unknown action + assert ( + get_status("unknown", True, "alias") + == f"{Colors.RED}alias would be unknown{Colors.RESET}" + ) + + +def create_colored_line(start_color: str, text: str) -> str: + """ + Create a colored line. + + Parameters: + start_color (str): The color for the line. + text (str): The text to display. + + Returns: + str: A colored line + """ + + return f"{start_color}{text}{Colors.RESET}" + + +def test_create_colored_line(): + assert ( + create_colored_line(Colors.CYAN, "TLDR") == f"{Colors.CYAN}TLDR{Colors.RESET}" + ) + assert create_colored_line("Hello", "TLDR") == f"HelloTLDR{Colors.RESET}" + + +def create_argument_parser(description: str) -> argparse.ArgumentParser: + """ + Create an argument parser that can be extended. + + Parameters: + description (str): The description for the argument parser + + Returns: + ArgumentParser: an argument parser. + """ + + parser = argparse.ArgumentParser(description=description) + parser.add_argument( + "-p", + "--page", + type=str, + default="", + help='page name in the format "platform/alias_command.md"', + ) + parser.add_argument( + "-S", + "--sync", + action="store_true", + default=False, + help="synchronize each translation's alias page (if exists) with that of English page", + ) + parser.add_argument( + "-l", + "--language", + type=str, + default="", + help='language in the format "ll" or "ll_CC" (e.g. "fr" or "pt_BR")', + ) + parser.add_argument( + "-s", + "--stage", + action="store_true", + default=False, + help="stage modified pages (requires `git` to be on $PATH and TLDR_ROOT to be a Git repository)", + ) + parser.add_argument( + "-n", + "--dry-run", + action="store_true", + default=False, + help="show what changes would be made without actually modifying the pages", + ) + + return parser + + +def test_create_argument_parser(): + description = "Test argument parser" + parser = create_argument_parser(description) + + assert isinstance(parser, argparse.ArgumentParser) + assert parser.description == description + + # Check if each expected argument is added with the correct configurations + arguments = [ + ("-p", "--page", str, ""), + ("-l", "--language", str, ""), + ("-s", "--stage", None, False), + ("-S", "--sync", None, False), + ("-n", "--dry-run", None, False), + ] + for short_flag, long_flag, arg_type, default_value in arguments: + action = parser._option_string_actions[short_flag] # Get action for short flag + assert action.dest.replace("_", "-") == long_flag.lstrip( + "-" + ) # Check destination name + assert action.type == arg_type # Check argument type + assert action.default == default_value # Check default value + + +def stage(paths: list[Path]): + """ + Stage the given paths using Git. + + Parameters: + paths (list of Paths): the list of Path's to stage using Git. + + """ + subprocess.call(["git", "add", *(path.resolve() for path in paths)]) + + +@patch("subprocess.call") +def test_stage(mock_subprocess_call): + paths = [Path("/path/to/file1"), Path("/path/to/file2")] + + # Call the stage function + stage(paths) + + # Verify that subprocess.call was called with the correct arguments + mock_subprocess_call.assert_called_once_with(["git", "add", *paths]) diff --git a/scripts/deploy.sh b/scripts/deploy.sh index bb49a9557..f582c8dc1 100755 --- a/scripts/deploy.sh +++ b/scripts/deploy.sh @@ -49,12 +49,15 @@ function upload_assets { git push -q echo "Assets (pages archive, index and checksums) deployed to the static site." + # Suppress errors from unmatched patterns if some files don't exist. + shopt -s nullglob gh release --repo tldr-pages/tldr upload --clobber "$RELEASE_TAG" -- \ tldr.sha256sums \ "$TLDR_ARCHIVE" \ "$INDEX" \ "$LANG_ARCHIVES/"*.zip \ "$PDFS/"*.pdf + shopt -u nullglob echo "Assets deployed to GitHub releases." } diff --git a/scripts/set-alias-page.py b/scripts/set-alias-page.py index 697792242..2b830a608 100755 --- a/scripts/set-alias-page.py +++ b/scripts/set-alias-page.py @@ -4,81 +4,93 @@ """ A Python script to generate or update alias pages. -Disclaimer: This script generates a lot of false positives so it -isn't suggested to use the sync option. If used, only stage changes -and commit verified changes for your language. +Disclaimer: This script generates a lot of false positives so it isn't suggested to use the sync option. If used, only stage changes and commit verified changes for your language by using -l LANGUAGE. -Note: If there is a symlink error when using the stage flag remove the `pages.en` -directory temporarily and try executing it again. +Note: If the current directory or one of its parents is called "tldr", the script will assume it is the tldr root, i.e., the directory that contains a clone of https://github.com/tldr-pages/tldr +If you aren't, the script will use TLDR_ROOT as the tldr root. Also, ensure 'git' is available. Usage: - python3 scripts/set-alias-page.py [-p PAGE] [-s] [-S] [-n] [COMMAND] + python3 scripts/set-alias-page.py [-p PAGE] [-S] [-l LANGUAGE] [-s] [-n] [COMMAND] Options: -p, --page PAGE Specify the alias page in the format "platform/alias_command.md". - -s, --stage - Stage modified pages (requires 'git' on $PATH and TLDR_ROOT to be a Git repository). -S, --sync Synchronize each translation's alias page (if exists) with that of the English page. + -l, --language LANGUAGE + Specify the language, a POSIX Locale Name in the form of "ll" or "ll_CC" (e.g. "fr" or "pt_BR"). + -s, --stage + Stage modified pages (requires 'git' on $PATH and TLDR_ROOT to be a Git repository). -n, --dry-run Show what changes would be made without actually modifying the page. +Positional Argument: + COMMAND The command to be set as the alias command. Examples: 1. Add 'vi' as an alias page of 'vim': python3 scripts/set-alias-page.py -p common/vi vim + python3 scripts/set-alias-page.py --page common/vi vim 2. Read English alias pages and synchronize them into all translations: python3 scripts/set-alias-page.py -S + python3 scripts/set-alias-page.py --sync - 3. Read English alias pages and show what changes would be made: + 3. Read English alias pages and synchronize them for Brazilian Portuguese pages only: + python3 scripts/set-alias-page.py -S -l pt_BR + python3 scripts/set-alias-page.py --sync --language pt_BR + + 4. Read English alias pages, synchronize them into all translations and stage modified pages for commit: + python3 scripts/set-alias-page.py -Ss + python3 scripts/set-alias-page.py --sync --stage + + 5. Read English alias pages and show what changes would be made: python3 scripts/set-alias-page.py -Sn python3 scripts/set-alias-page.py --sync --dry-run """ -import argparse -import os import re -import subprocess +from pathlib import Path +from _common import ( + IGNORE_FILES, + Colors, + get_tldr_root, + get_pages_dir, + get_target_paths, + get_locale, + get_status, + stage, + create_colored_line, + create_argument_parser, +) -IGNORE_FILES = (".DS_Store", "tldr.md", "aria2.md") +IGNORE_FILES += ("tldr.md", "aria2.md") -def get_tldr_root(): - """ - Get the path of local tldr repository for environment variable TLDR_ROOT. - """ - - # If this script is running from tldr/scripts, the parent's parent is the root - f = os.path.normpath(__file__) - if f.endswith("tldr/scripts/set-alias-page.py"): - return os.path.dirname(os.path.dirname(f)) - - if "TLDR_ROOT" in os.environ: - return os.environ["TLDR_ROOT"] - else: - raise SystemExit( - "\x1b[31mPlease set TLDR_ROOT to the location of a clone of https://github.com/tldr-pages/tldr.\x1b[0m" - ) +def test_ignore_files(): + assert IGNORE_FILES == ( + ".DS_Store", + "tldr.md", + "aria2.md", + ) + assert ".DS_Store" in IGNORE_FILES + assert "tldr.md" in IGNORE_FILES -def get_templates(root): +def get_templates(root: Path): """ Get all alias page translation templates from TLDR_ROOT/contributing-guides/translation-templates/alias-pages.md. Parameters: - root (string): The path of local tldr repository, i.e., TLDR_ROOT. + root (Path): The path of local tldr repository, i.e., TLDR_ROOT. Returns: dict of (str, str): Language labels map to alias page templates. """ - template_file = os.path.join( - root, "contributing-guides/translation-templates/alias-pages.md" - ) - with open(template_file) as f: + template_file = root / "contributing-guides/translation-templates/alias-pages.md" + with template_file.open(encoding="utf-8") as f: lines = f.readlines() # Parse alias-pages.md @@ -109,142 +121,115 @@ def get_templates(root): return templates -def get_alias_page(file): - """ - Determine whether the given file is an alias page. - - Parameters: - file (string): Path to a page - - Returns: - str: "" If the file doesn't exit or is not an alias page, - otherwise return what command the alias stands for. - """ - - if not os.path.isfile(file): - return "" - with open(file) as f: - for line in f: - if match := re.search(r"^`tldr (.+)`", line): - return match[1] - return "" - - -def set_alias_page(file, command, dry_run=False): +def set_alias_page( + path: Path, command: str, dry_run: bool = False, language_to_update: str = "" +) -> str: """ Write an alias page to disk. Parameters: - file (string): Path to an alias page + path (string): Path to an alias page command (string): The command that the alias stands for. - dry_run (bool): Whether to perform a dry-run. + dry_run (bool): Whether to perform a dry-run, i.e. only show the changes that would be made. + language_to_update (string): Optionally, the language of the translation to be updated. Returns: str: Execution status - "" if the alias page standing for the same command already exists. - "\x1b[36mpage added" if it's a new alias page. - "\x1b[34mpage updated" if the command updates. + "" if the alias page standing for the same command already exists or if the locale does not match language_to_update. + "\x1b[36mpage added" + "\x1b[34mpage updated" + "\x1b[36mpage would be added" + "\x1b[34mpage would updated" """ - # compute locale - pages_dir = os.path.basename(os.path.dirname(os.path.dirname(file))) - if "." in pages_dir: - _, locale = pages_dir.split(".") - else: - locale = "en" - if locale not in templates: + locale = get_locale(path) + if locale not in templates or ( + language_to_update != "" and locale != language_to_update + ): + # return empty status to indicate that no changes were made return "" # Test if the alias page already exists - orig_command = get_alias_page(file) - if orig_command == command: + original_command = get_alias_page(path) + if original_command == command: return "" - if orig_command == "": - status_prefix = "\x1b[36m" - action = "added" - else: - status_prefix = "\x1b[34m" - action = "updated" + status = get_status( + "added" if original_command == "" else "updated", dry_run, "page" + ) - if dry_run: - status = f"page will be {action}" - else: - status = f"page {action}" - - status = f"{status_prefix}{status}\x1b[0m" - - if not dry_run: # Only write to the file during a non-dry-run - alias_name, _ = os.path.splitext(os.path.basename(file)) + if not dry_run: # Only write to the path during a non-dry-run + alias_name = path.stem text = ( templates[locale] .replace("example", alias_name, 1) .replace("example", command) ) - os.makedirs(os.path.dirname(file), exist_ok=True) - with open(file, "w") as f: + path.parent.mkdir(parents=True, exist_ok=True) + with path.open("w", encoding="utf-8") as f: f.write(text) return status -def sync(root, pages_dirs, alias_name, orig_command, dry_run=False): +def get_alias_page(path: Path) -> str: + """ + Determine whether the given path is an alias page. + + Parameters: + path (Path): Path to a page + + Returns: + str: "" If the path doesn't exit or is not an alias page, + otherwise return what command the alias stands for. + """ + + if not path.exists(): + return "" + with path.open(encoding="utf-8") as f: + for line in f: + # match alias (`tldr `) + if match := re.search(r"^`tldr (.+)`", line): + return match[1] + return "" + + +def sync( + root: Path, + pages_dirs: list[Path], + alias_name: str, + original_command: str, + dry_run: bool = False, + language_to_update: str = "", +) -> list[Path]: """ Synchronize an alias page into all translations. Parameters: - root (str): TLDR_ROOT - pages_dirs (list of str): Strings of page entry and platform, e.g. "page.fr/common". + root (Path): TLDR_ROOT + pages_dirs (list of Path's): Path's of page entry and platform, e.g. "page.fr/common". alias_name (str): An alias command with .md extension like "vi.md". - orig_command (string): An Original command like "vim". - dry_run (bool): Whether to perform a dry-run. + original_command (str): An Original command like "vim". + dry_run (bool): Whether to perform a dry-run, i.e. only show the changes that would be made. + language_to_update (str): Optionally, the language of the translation to be updated. Returns: - list: A list of paths to be staged into git, using by --stage option. + list (list of Path's): A list of Path's to be staged into git, using by --stage option. """ - rel_paths = [] + paths = [] for page_dir in pages_dirs: - path = os.path.join(root, page_dir, alias_name) - status = set_alias_page(path, orig_command, dry_run) + path = root / page_dir / alias_name + status = set_alias_page(path, original_command, dry_run, language_to_update) if status != "": - rel_path = path.replace(f"{root}/", "") - rel_paths.append(rel_path) - print(f"\x1b[32m{rel_path} {status}\x1b[0m") - return rel_paths + rel_path = "/".join(path.parts[-3:]) + paths.append(rel_path) + print(create_colored_line(Colors.GREEN, f"{rel_path} {status}")) + return paths def main(): - parser = argparse.ArgumentParser( - description="Sets the alias page for all translations of a page" - ) - parser.add_argument( - "-p", - "--page", - type=str, - required=False, - default="", - help='page name in the format "platform/alias_command.md"', - ) - parser.add_argument( - "-s", - "--stage", - action="store_true", - default=False, - help="stage modified pages (requires `git` to be on $PATH and TLDR_ROOT to be a Git repository)", - ) - parser.add_argument( - "-S", - "--sync", - action="store_true", - default=False, - help="synchronize each translation's alias page (if exists) with that of English page", - ) - parser.add_argument( - "-n", - "--dry-run", - action="store_true", - default=False, - help="show what changes would be made without actually modifying the pages", + parser = create_argument_parser( + "Sets the alias page for all translations of a page" ) parser.add_argument("command", type=str, nargs="?", default="") args = parser.parse_args() @@ -254,46 +239,47 @@ def main(): # A dictionary of all alias page translations global templates templates = get_templates(root) - pages_dirs = [d for d in os.listdir(root) if d.startswith("pages")] - rel_paths = [] + pages_dirs = get_pages_dir(root) + + target_paths = [] # Use '--page' option if args.page != "": - if not args.page.lower().endswith(".md"): - args.page = f"{args.page}.md" - - target_paths = [os.path.join(root, p, args.page) for p in pages_dirs] - target_paths.sort() + target_paths += get_target_paths(args.page, pages_dirs) for path in target_paths: - rel_path = path.replace(f"{root}/", "") - rel_paths.append(rel_path) - status = set_alias_page(path, args.command) + rel_path = "/".join(path.parts[-3:]) + status = set_alias_page(path, args.command, args.dry_run, args.language) if status != "": - print(f"\x1b[32m{rel_path} {status}\x1b[0m") + print(create_colored_line(Colors.GREEN, f"{rel_path} {status}")) # Use '--sync' option elif args.sync: - pages_dirs.remove("pages") - en_page = os.path.join(root, "pages") - platforms = [i for i in os.listdir(en_page) if i not in IGNORE_FILES] + pages_dirs.remove(root / "pages") + en_path = root / "pages" + platforms = [i.name for i in en_path.iterdir() if i.name not in IGNORE_FILES] for platform in platforms: - platform_path = os.path.join(en_page, platform) + platform_path = en_path / platform commands = [ - f"{platform}/{p}" - for p in os.listdir(platform_path) - if p not in IGNORE_FILES + f"{platform}/{page.name}" + for page in platform_path.iterdir() + if page.name not in IGNORE_FILES ] for command in commands: - orig_command = get_alias_page(os.path.join(root, "pages", command)) - if orig_command != "": - rel_paths += sync( - root, pages_dirs, command, orig_command, args.dry_run + original_command = get_alias_page(root / "pages" / command) + if original_command != "": + target_paths += sync( + root, + pages_dirs, + command, + original_command, + args.dry_run, + args.language, ) # Use '--stage' option - if args.stage and not args.dry_run: - subprocess.call(["git", "add", *rel_paths], cwd=root) + if args.stage and not args.dry_run and len(target_paths) > 0: + stage(target_paths) if __name__ == "__main__": diff --git a/scripts/set-more-info-link.py b/scripts/set-more-info-link.py index 44b8aca95..f2b4cf8c3 100755 --- a/scripts/set-more-info-link.py +++ b/scripts/set-more-info-link.py @@ -2,50 +2,65 @@ # SPDX-License-Identifier: MIT """ -This script sets the "More information" link for all translations of a page. -It can be used to add or update the links in translations. +A Python script to add or update the "More information" link for all translations of a page. -Note: Before running this script, ensure that TLDR_ROOT is set to the location -of a clone of https://github.com/tldr-pages/tldr, and 'git' is available. -If there is a symlink error when using the stage flag remove the `pages.en` -directory temporarily and try executing it again. +Note: If the current directory or one of its parents is called "tldr", the script will assume it is the tldr root, i.e., the directory that contains a clone of https://github.com/tldr-pages/tldr +If the script doesn't find it in the current path, the environment variable TLDR_ROOT will be used as the tldr root. Also, ensure 'git' is available. -Usage: python3 scripts/set-more-info-link.py [-p PAGE] [-s] [-S] [-n] [LINK] +Usage: + python3 scripts/set-more-info-link.py [-p PAGE] [-S] [-l LANGUAGE] [-s] [-n] [LINK] -Supported Arguments: - -p, --page Specify the page name in the format "platform/command.md". - This option allows setting the link for a specific page. - -s, --stage Stage modified pages for commit. This option requires 'git' - to be on the $PATH and TLDR_ROOT to be a Git repository. - -S, --sync Synchronize each translation's more information link (if - exists) with that of the English page. This is useful to - ensure consistency across translations. - -n, --dry-run Show what changes would be made without actually modifying the page. +Options: + -p, --page PAGE + Specify the page in the format "platform/command". This option allows setting the link for a specific page. + -S, --sync + Synchronize each translation's "More information" link (if exists) with that of the English page. + -l, --language LANGUAGE + Specify the language, a POSIX Locale Name in the form of "ll" or "ll_CC" (e.g. "fr" or "pt_BR"). + -s, --stage + Stage modified pages (requires 'git' on $PATH and TLDR_ROOT to be a Git repository). + -n, --dry-run + Show what changes would be made without actually modifying the page. Positional Argument: LINK The link to be set as the "More information" link. Examples: 1. Set the link for a specific page: - python3 scripts/set-more-info-link.py -p common/tar.md https://example.com + python3 scripts/set-more-info-link.py -p common/tar https://example.com + python3 scripts/set-more-info-link.py --page common/tar https://example.com - 2. Synchronize more information links across translations: + 2. Read English pages and synchronize the "More information" link across translations: python3 scripts/set-more-info-link.py -S + python3 scripts/set-more-info-link.py --sync - 3. Synchronize more information links across translations and stage modified pages for commit: + 3. Read English pages and synchronize the "More information" link for Brazilian Portuguese pages only: + python3 scripts/set-more-info-link.py -S -l pt_BR + python3 scripts/set-more-info-link.py --sync --language pt_BR + + 4. Read English pages, synchronize the "More information" link across translations and stage modified pages for commit: python3 scripts/set-more-info-link.py -Ss python3 scripts/set-more-info-link.py --sync --stage - 4. Show what changes would be made across translations: + 5. Show what changes would be made across translations: python3 scripts/set-more-info-link.py -Sn python3 scripts/set-more-info-link.py --sync --dry-run """ -import argparse -import os import re -import subprocess from pathlib import Path +from _common import ( + IGNORE_FILES, + Colors, + get_tldr_root, + get_pages_dir, + get_target_paths, + get_locale, + get_status, + stage, + create_colored_line, + create_argument_parser, +) labels = { "en": "More information:", @@ -87,21 +102,33 @@ labels = { "zh": "更多信息：", } -IGNORE_FILES = (".DS_Store",) +def set_link( + path: Path, link: str, dry_run: bool = False, language_to_update: str = "" +) -> str: + """ + Write a "More information" link in a page to disk. -def get_tldr_root() -> Path: - f = Path(__file__).resolve() - return next(path for path in f.parents if path.name == "tldr") + Parameters: + path (string): Path to a page + link (string): The "More information" link to insert. + dry_run (bool): Whether to perform a dry-run, i.e. only show the changes that would be made. + language_to_update (string): Optionally, the language of the translation to be updated. - if "TLDR_ROOT" in os.environ: - return Path(os.environ["TLDR_ROOT"]) - raise SystemError( - "\x1b[31mPlease set TLDR_ROOT to the location of a clone of https://github.com/tldr-pages/tldr." - ) + Returns: + str: Execution status + "" if the page does not need an update or if the locale does not match language_to_update. + "\x1b[36mlink added" + "\x1b[34mlink updated" + "\x1b[36mlink would be added" + "\x1b[34mlink would updated" + """ + locale = get_locale(path) + if language_to_update != "" and locale != language_to_update: + # return empty status to indicate that no changes were made + return "" -def set_link(path: Path, link: str, dry_run=False) -> str: with path.open(encoding="utf-8") as f: lines = f.readlines() @@ -116,13 +143,6 @@ def set_link(path: Path, link: str, dry_run=False) -> str: desc_end = i break - # compute locale - pages_dirname = path.parents[1].name - if "." in pages_dirname: - _, locale = pages_dirname.split(".") - else: - locale = "en" - # build new line if locale in ["bn", "hi", "ne"]: new_line = f"> {labels[locale]} <{link}>।\n" @@ -137,27 +157,18 @@ def set_link(path: Path, link: str, dry_run=False) -> str: # return empty status to indicate that no changes were made return "" - status_prefix = "\x1b[36m" # Color code for pages - if re.search(r"^>.*<.+>", lines[desc_end]): # overwrite last line lines[desc_end] = new_line - status_prefix = "\x1b[34m" action = "updated" else: # add new line lines.insert(desc_end + 1, new_line) - status_prefix = "\x1b[36m" action = "added" - if dry_run: - status = f"link will be {action}" - else: - status = f"link {action}" + status = get_status(action, dry_run, "link") - status = f"{status_prefix}{status}\x1b[0m" - - if not dry_run: + if not dry_run: # Only write to the path during a non-dry-run with path.open("w", encoding="utf-8") as f: f.writelines(lines) @@ -165,6 +176,19 @@ def set_link(path: Path, link: str, dry_run=False) -> str: def get_link(path: Path) -> str: + """ + Determine whether the given path has a "More information" link. + + Parameters: + path (Path): Path to a page + + Returns: + str: "" If the path doesn't exit or does not have a link, + otherwise return the "More information" link. + """ + + if not path.exists(): + return "" with path.open(encoding="utf-8") as f: lines = f.readlines() @@ -187,80 +211,60 @@ def get_link(path: Path) -> str: def sync( - root: Path, pages_dirs: list[str], command: str, link: str, dry_run=False -) -> list[str]: + root: Path, + pages_dirs: list[Path], + command: str, + link: str, + dry_run: bool = False, + language_to_update: str = "", +) -> list[Path]: + """ + Synchronize a "More information" link into all translations. + + Parameters: + root (Path): TLDR_ROOT + pages_dirs (list of Path's): Path's of page entry and platform, e.g. "page.fr/common". + command (str): A command like "tar". + link (str): A link like "https://example.com". + dry_run (bool): Whether to perform a dry-run, i.e. only show the changes that would be made. + language_to_update (str): Optionally, the language of the translation to be updated. + + Returns: + list (list of Path's): A list of Path's to be staged into git, using by --stage option. + """ paths = [] for page_dir in pages_dirs: path = root / page_dir / command if path.exists(): - rel_path = "/".join(path.parts[-3:]) - status = set_link(path, link, dry_run) + status = set_link(path, link, dry_run, language_to_update) if status != "": - paths.append(path) - print(f"\x1b[32m{rel_path} {status}\x1b[0m") + rel_path = "/".join(path.parts[-3:]) + paths.append(rel_path) + print(create_colored_line(Colors.GREEN, f"{rel_path} {status}")) return paths def main(): - parser = argparse.ArgumentParser( - description='Sets the "More information" link for all translations of a page' - ) - parser.add_argument( - "-p", - "--page", - type=str, - required=False, - default="", - help='page name in the format "platform/command.md"', - ) - parser.add_argument( - "-s", - "--stage", - action="store_true", - default=False, - help="stage modified pages (requires `git` to be on $PATH and TLDR_ROOT to be a Git repository)", - ) - parser.add_argument( - "-S", - "--sync", - action="store_true", - default=False, - help="synchronize each translation's more information link (if exists) with that of English page", - ) - parser.add_argument( - "-n", - "--dry-run", - action="store_true", - default=False, - help="show what changes would be made without actually modifying the pages", + parser = create_argument_parser( + 'Sets the "More information" link for all translations of a page' ) parser.add_argument("link", type=str, nargs="?", default="") args = parser.parse_args() root = get_tldr_root() - pages_dirs = [d for d in root.iterdir() if d.name.startswith("pages")] + pages_dirs = get_pages_dir(root) target_paths = [] # Use '--page' option if args.page != "": - if not args.page.lower().endswith(".md"): - args.page = f"{args.page}.md" - arg_platform, arg_page = args.page.split("/") - - for pages_dir in pages_dirs: - page_path = pages_dir / arg_platform / arg_page - if not page_path.exists(): - continue - target_paths.append(page_path) - - target_paths.sort() + target_paths += get_target_paths(args.page, pages_dirs) for path in target_paths: rel_path = "/".join(path.parts[-3:]) - status = set_link(path, args.link) + status = set_link(path, args.link, args.dry_run, args.language) if status != "": - print(f"\x1b[32m{rel_path} {status}\x1b[0m") + print(create_colored_line(Colors.GREEN, f"{rel_path} {status}")) # Use '--sync' option elif args.sync: @@ -272,15 +276,18 @@ def main(): commands = [ f"{platform}/{page.name}" for page in platform_path.iterdir() - if page not in IGNORE_FILES + if page.name not in IGNORE_FILES ] for command in commands: link = get_link(root / "pages" / command) if link != "": - target_paths += sync(root, pages_dirs, command, link, args.dry_run) + target_paths += sync( + root, pages_dirs, command, link, args.dry_run, args.language + ) + # Use '--stage' option if args.stage and not args.dry_run and len(target_paths) > 0: - subprocess.call(["git", "add", *target_paths], cwd=root) + stage(target_paths) if __name__ == "__main__": diff --git a/scripts/set-page-title.py b/scripts/set-page-title.py new file mode 100755 index 000000000..3476a2ed3 --- /dev/null +++ b/scripts/set-page-title.py @@ -0,0 +1,210 @@ +#!/usr/bin/env python3 +# SPDX-License-Identifier: MIT + +""" +A Python script to add or update the page title for all translations of a page. + +Note: If the current directory or one of its parents is called "tldr", the script will assume it is the tldr root, i.e., the directory that contains a clone of https://github.com/tldr-pages/tldr +If the script doesn't find it in the current path, the environment variable TLDR_ROOT will be used as the tldr root. Also, ensure 'git' is available. + +Usage: + python3 scripts/set-page-title.py [-p PAGE] [-S] [-l LANGUAGE] [-s] [-n] [TITLE] + +Options: + -p, --page PAGE + Specify the page in the format "platform/command". This option allows setting the title for a specific page. + -S, --sync + Synchronize each translation's title (if exists) with that of the English page. + -l, --language LANGUAGE + Specify the language, a POSIX Locale Name in the form of "ll" or "ll_CC" (e.g. "fr" or "pt_BR"). + -s, --stage + Stage modified pages (requires 'git' on $PATH and TLDR_ROOT to be a Git repository). + -n, --dry-run + Show what changes would be made without actually modifying the page. + +Positional Argument: + TITLE The title to be set as the title. + +Examples: + 1. Set the title for a specific page: + python3 scripts/set-page-title.py -p common/tar tar + python3 scripts/set-page-title.py --page common/tar tar + + 2. Synchronize titles across translations: + python3 scripts/set-page-title.py -S + python3 scripts/set-page-title.py --sync + + 3. Read English pages and synchronize the title for Brazilian Portuguese pages only: + python3 scripts/set-page-title.py -S -l pt_BR + python3 scripts/set-page-title.py --sync --language pt_BR + + 4. Synchronize titles across translations and stage modified pages for commit: + python3 scripts/set-page-title.py -Ss + python3 scripts/set-page-title.py --sync --stage + + 5. Show what changes would be made across translations: + python3 scripts/set-page-title.py -Sn + python3 scripts/set-page-title.py --sync --dry-run +""" + +from pathlib import Path +from _common import ( + IGNORE_FILES, + Colors, + get_tldr_root, + get_pages_dir, + get_target_paths, + get_locale, + get_status, + stage, + create_colored_line, + create_argument_parser, +) + + +def set_page_title( + path: Path, title: str, dry_run: bool = False, language_to_update: str = "" +) -> str: + """ + Write a title in a page to disk. + + Parameters: + path (string): Path to a page + title (string): The title to insert. + dry_run (bool): Whether to perform a dry-run, i.e. only show the changes that would be made. + language_to_update (string): Optionally, the language of the translation to be updated. + + Returns: + str: Execution status + "" if the page does not need an update or if the locale does not match language_to_update. + "\x1b[36mtitle added" + "\x1b[34mtitle updated" + "\x1b[36mtitle would be added" + "\x1b[34mtitle would updated" + """ + + locale = get_locale(path) + if language_to_update != "" and locale != language_to_update: + # return empty status to indicate that no changes were made + return "" + + new_line = f"# {title}\n" + + # Read the content of the Markdown file + with path.open(encoding="utf-8") as f: + lines = f.readlines() + + if lines[0] == new_line: + # return empty status to indicate that no changes were made + return "" + + status = get_status("updated", dry_run, "title") + + if not dry_run: # Only write to the path during a non-dry-run + lines[0] = new_line + with path.open("w", encoding="utf-8") as f: + f.writelines(lines) + + return status + + +def get_page_title(path: Path) -> str: + """ + Determine whether the given path has a title. + + Parameters: + path (Path): Path to a page + + Returns: + str: "" If the path doesn't exit or does not have a title, + otherwise return the page title. + """ + + if not path.exists(): + return "" + with path.open(encoding="utf-8") as f: + first_line = f.readline().strip() + + return first_line.split("#", 1)[-1].strip() + + +def sync( + root: Path, + pages_dirs: list[Path], + command: str, + title: str, + dry_run: bool = False, + language_to_update: str = "", +) -> list[str]: + """ + Synchronize a page title into all translations. + + Parameters: + root (Path): TLDR_ROOT + pages_dirs (list of Path's): Path's of page entry and platform, e.g. "page.fr/common". + command (str): A command like "tar". + title (str): A title like "tar". + dry_run (bool): Whether to perform a dry-run, i.e. only show the changes that would be made. + language_to_update (str): Optionally, the language of the translation to be updated. + + Returns: + list (list of Path's): A list of Path's to be staged into git, using by --stage option. + """ + paths = [] + for page_dir in pages_dirs: + path = root / page_dir / command + if path.exists(): + status = set_page_title(path, title, dry_run, language_to_update) + if status != "": + rel_path = "/".join(path.parts[-3:]) + paths.append(rel_path) + print(create_colored_line(Colors.GREEN, f"{rel_path} {status}")) + return paths + + +def main(): + parser = create_argument_parser("Sets the title for all translations of a page") + parser.add_argument("title", type=str, nargs="?", default="") + args = parser.parse_args() + + root = get_tldr_root() + pages_dirs = get_pages_dir(root) + + target_paths = [] + + # Use '--page' option + if args.page != "": + target_paths += get_target_paths(args.page, pages_dirs) + + for path in target_paths: + rel_path = "/".join(path.parts[-3:]) + status = set_page_title(path, args.title) + if status != "": + print(create_colored_line(Colors.GREEN, f"{rel_path} {status}")) + + # Use '--sync' option + elif args.sync: + pages_dirs.remove(root / "pages") + en_path = root / "pages" + platforms = [i.name for i in en_path.iterdir() if i.name not in IGNORE_FILES] + for platform in platforms: + platform_path = en_path / platform + commands = [ + f"{platform}/{page.name}" + for page in platform_path.iterdir() + if page.name not in IGNORE_FILES + ] + for command in commands: + title = get_page_title(root / "pages" / command) + if title != "": + target_paths += sync( + root, pages_dirs, command, title, args.dry_run, args.language + ) + + # Use '--stage' option + if args.stage and not args.dry_run and len(target_paths) > 0: + stage(target_paths) + + +if __name__ == "__main__": + main() diff --git a/scripts/test-requirements.txt b/scripts/test-requirements.txt new file mode 100644 index 000000000..e079f8a60 --- /dev/null +++ b/scripts/test-requirements.txt @@ -0,0 +1 @@ +pytest diff --git a/scripts/test.sh b/scripts/test.sh index ecfba227f..cbb27d8c7 100755 --- a/scripts/test.sh +++ b/scripts/test.sh @@ -57,21 +57,38 @@ function run_flake8 { flake8 scripts } +function run_pytest { + # skip pytest check if the command is not available in the system. + if [[ $CI != true ]] && ! exists pytest; then + echo "Skipping pytest check, command not available." + return 0 + fi + + errs=$(pytest scripts/*.py 2>&1 || true) + if [[ ${errs} == *"failed"* ]]; then + echo -e "${errs}" >&2 + return 1 + fi +} + # Default test function, run by `npm test`. function run_tests { find pages* -name '*.md' -exec markdownlint {} + tldr-lint ./pages for f in ./pages.*; do - checks="TLDR003,TLDR004,TLDR015,TLDR104" + checks="TLDR104" if [[ -L $f ]]; then continue + elif [[ $f == *ar* || $f == *bn* || $f == *fa* || $f == *hi* || $f == *ja* || $f == *ko* || $f == *lo* || $f == *ml* || $f == *ne* || $f == *ta* || $f == *th* || $f == *tr* ]]; then + checks+=",TLDR003,TLDR004,TLDR015" elif [[ $f == *zh* || $f == *zh_TW* ]]; then - checks+=",TLDR005" + checks+=",TLDR003,TLDR004,TLDR005,TLDR015" fi tldr-lint --ignore $checks "${f}" done run_black run_flake8 + run_pytest } # Special test function for GitHub Actions pull request builds. diff --git a/scripts/wrong-filename.sh b/scripts/wrong-filename.sh index 11bbd088b..2ab47dd5d 100755 --- a/scripts/wrong-filename.sh +++ b/scripts/wrong-filename.sh @@ -1,4 +1,4 @@ -#!/bin/sh +#!/usr/bin/env bash # SPDX-License-Identifier: MIT # This script checks consistency between the filenames and the page title. @@ -8,19 +8,22 @@ OUTPUT_FILE="inconsistent-filenames.txt" # Remove existing output file (if any) rm -f "$OUTPUT_FILE" +touch "$OUTPUT_FILE" + +IGNORE_LIST=("exclamation mark" "caret" "history expansion" "qm move disk" "umount" "rename") set -e # Iterate through all Markdown files in the 'pages' directories find pages* -name '*.md' -type f | while read -r path; do # Extract the expected command name from the filename - COMMAND_NAME_FILE=$(basename "$path" | head -c-4 | tr '-' ' ' | tr '[:upper:]' '[:lower:]') + COMMAND_NAME_FILE=$(basename "$path" | head -c-4 | sed 's/nix3/nix/' | sed 's/\.fish//' | sed 's/\.js//' | sed 's/\.1//' | tr '-' ' ' | tr '[:upper:]' '[:lower:]') # Extract the command name from the first line of the Markdown file - COMMAND_NAME_PAGE=$(head -n1 "$path" | tail -c+3 | tr '-' ' ' | tr '[:upper:]' '[:lower:]') + COMMAND_NAME_PAGE=$(head -n1 "$path" | tail -c+3 | sed 's/--//' | tr '-' ' ' | tr '[:upper:]' '[:lower:]') # Check if there is a mismatch between filename and content command names - if [ "$COMMAND_NAME_FILE" != "$COMMAND_NAME_PAGE" ]; then + if [[ "$COMMAND_NAME_FILE" != "$COMMAND_NAME_PAGE" && ! ${IGNORE_LIST[*]} =~ $COMMAND_NAME_PAGE ]]; then echo "Inconsistency found in file: $path: $COMMAND_NAME_PAGE should be $COMMAND_NAME_FILE" >> "$OUTPUT_FILE" fi done