Merge branch 'master' into master

translation-badges
Starbeamrainbowlabs 2020-12-30 13:30:47 +00:00 committed by GitHub
commit deb1d81da3
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
54 changed files with 382 additions and 53 deletions

View File

@ -93,7 +93,7 @@ using one of the template messages below as a base.
```
Hi, @username! You seem to be enjoying contributing to the tldr-pages project.
You now have had five distinct pull requests merged ([LINKS TO THE RELEVANT PRs])!
You now have had five distinct pull requests merged (<!-- REPLACE THIS WITH LINKS TO THE RELEVANT PRs -->)!
That qualifies you to become a collaborator in this repository, as explained in our [community roles documentation](https://github.com/tldr-pages/tldr/blob/master/COMMUNITY-ROLES.md).
As a collaborator, you will have commit access to the repository.
@ -121,13 +121,15 @@ using one of the template messages below as a base.
1. Open an issue with the following message template (edit it as appropriate):
```
Hi, @username! After joining as a collaborator in the repository, you have been regularly performing maintenance tasks.
Hi, @username! After joining as a collaborator in the repository, you have been regularly performing maintenance tasks (<!-- REPLACE THIS WITH LINKS TO THE RELEVANT ISSUES AND/OR PRs -->).
Thank you for that!
According to [COMMUNITY-ROLES.md](https://github.com/tldr-pages/tldr/blob/master/COMMUNITY-ROLES.md), you've now met the thresholds to be effectively considered an active maintainer of the project ([LINKS TO THE RELEVANT PRs]).
According to our [community roles documentation](https://github.com/tldr-pages/tldr/blob/master/COMMUNITY-ROLES.md), you've now met the thresholds to be effectively considered an active maintainer of the project.
To publicly acknowledge that fact, we'd like to add you to the tldr-pages organization.
If you accept the invitation, we ask you to make your membership public, and (in case you don't already) start hanging out in our Gitter chat room.
You'll now be one of the public faces of the tldr-pages project.
Additionally, consider subscribing to the notifications from the various repositories under the [tldr-pages organization](https://github.com/tldr-pages).
As one of the public faces of the tldr-pages project, it's also especially important that you follow and encourage the [project
governance principles](https://github.com/tldr-pages/tldr/blob/master/COMMUNITY-ROLES.md).
How does that sound? Are you up for it?
```
@ -148,10 +150,10 @@ using one of the template messages below as a base.
```
Hi, @username! You've been an active tldr-pages organization member for over 6 months.
Thanks for sticking around this far and helping out!
According to [COMMUNITY-ROLES.md](https://github.com/tldr-pages/tldr/blob/master/COMMUNITY-ROLES.md), you're now eligible for becoming an owner in the organization.
According to our [community roles documentation](https://github.com/tldr-pages/tldr/blob/master/COMMUNITY-ROLES.md), you're now eligible for becoming an owner in the organization.
That means you will, from now on, be part of the team responsible for performing role changes (like this one!) in the community.
Before performing such role transitions, make sure to review the [COMMUNITY-ROLES.md](https://github.com/tldr-pages/tldr/blob/master/COMMUNITY-ROLES.md) document.
When performing such role transitions, make sure to follow the process described in the [COMMUNITY-ROLES.md](https://github.com/tldr-pages/tldr/blob/master/COMMUNITY-ROLES.md) document.
Is that OK with you? Let us know!

View File

@ -149,7 +149,7 @@ There is also a comprehensive
- Your favourite command isn't covered?
- You can think of more examples for an existing command?
All `tldr` pages are kept as markdown files right here in this repository,
All `tldr` pages are kept as Markdown files right here in this repository,
so you can edit them directly and submit your changes as pull requests.
All contributions are welcome!

6
package-lock.json generated
View File

@ -290,9 +290,9 @@
"integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="
},
"ini": {
"version": "1.3.5",
"resolved": "https://registry.npmjs.org/ini/-/ini-1.3.5.tgz",
"integrity": "sha512-RZY5huIKCMRWDUqZlEi72f/lmXKMvuszcMBduliQ3nnWbx9X/ZBQO7DijMEYS9EhHBb2qacRUMtC7svLwe0lcw=="
"version": "1.3.8",
"resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz",
"integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew=="
},
"is-arrayish": {
"version": "0.2.1",

19
pages.fr/common/base32.md Normal file
View File

@ -0,0 +1,19 @@
# base32
> Encode ou décode un fichier ou l'entrée standard vers ou depuis la base 32, et retourne le résultat à la sortie standard.
- Encode un fichier :
`base32 {{fichier}}`
- Décode un fichier :
`base32 -d {{fichier}}`
- Encode depuis `stdin` :
`{{commande}} | base32`
- Décode depuis `stdin` :
`{{commande}} | base32 -d`

20
pages.fr/common/deluge.md Normal file
View File

@ -0,0 +1,20 @@
# deluge
> Client BitTorrent à base de ligne de commande.
> Plus d'informations : <https://deluge-torrent.org>.
- Télécharge un torrent :
`deluge {{url|magnet|chemin/vers/fichier}}`
- Télécharge un torrent à l'aide d'un fichier de configuration particulier :
`deluge -c {{chemin/vers/fichier_configuration}} {{url|magnet|chemin/vers/fichier}}`
- Télécharge un torrent et lance un interface usager particulier :
`deluge -u {{gtk|web|console}} {{url|magnet|chemin/vers/fichier}}`
- Télécharge un torrent et enregistre les journaux dans un ficher :
`deluge -l {{chemin/vers/fichier_journalisation}} {{url|magnet|chemin/vers/fichier}}`

View File

@ -0,0 +1,20 @@
# deluged
> Un processus démon pour le client BitTorrent Deluge.
> Plus d'informations : <https://deluge-torrent.org>.
- Lance le démon Deluge :
`deluged`
- Lance le démon Deluge sur un port spécifique :
`deluged -p {{port}}`
- Lance le démon Deluge à l'aide d'un fichier de configuration spécifique :
`deluged -c {{chemin/vers/fichier_configuration}}`
- Lance le démon Deluge et enregistre les journaux dans un fichier :
`deluged -l {{chemin/vers/fichier_journalisation}}`

View File

@ -16,6 +16,6 @@
`alex {{textfile.md}}`
- `example.md`를 제외한 모든 markdown 파일 분석:
- `example.md`를 제외한 모든 Markdown 파일 분석:
`alex *.md !{{example.md}}`

View File

@ -16,6 +16,6 @@
`alex {{textfile.md}}`
- Analyze all markdown files except `example.md`:
- Analyze all Markdown files except `example.md`:
`alex *.md !{{example.md}}`

View File

@ -1,7 +1,7 @@
# arc
> Arcanist: A CLI for Phabricator.
> More information <https://secure.phabricator.com/book/phabricator/article/arcanist/>.
> More information: <https://secure.phabricator.com/book/phabricator/article/arcanist/>.
- Send the changes to Differential for review:

29
pages/common/clj.md Normal file
View File

@ -0,0 +1,29 @@
# clj
> Clojure tool to start a REPL or invoke a specific function with data.
> All options can be defined in a `deps.edn` file.
> More information: <https://clojure.org/guides/deps_and_cli>.
- Start a REPL:
`clj`
- Execute a function:
`clj -X {{namespace/function_name}}`
- Run the main function of a specified namespace:
`clj -M -m {{namespace}} {{args}}`
- Prepare a project by resolving dependencies, downloading libraries, and making / caching classpaths:
`clj -P`
- Start an nREPL server with the CIDER middleware:
`clj -Sdeps '{:deps {nrepl {:mvn/version "0.7.0"} cider/cider-nrepl {:mvn/version "0.25.2"}}}' -m nrepl.cmdline --middleware '["cider.nrepl/cider-middleware"]' --interactive`
- Start a REPL for ClojureScript and open a web browser:
`clj -Sdeps '{:deps {org.clojure/clojurescript {:mvn/version "1.10.758"}}}' --main cljs.main --repl`

View File

@ -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 an UI using the API.
> More Information: <https://deemix.app>.
> More information: <https://deemix.app>.
- Download a track or playlist:

View File

@ -13,7 +13,7 @@
- Edit the `.envrc` file in the default text editor and reload the environment on exit:
`direnv allow`
`direnv edit .`
- Trigger a reload of the environment:

View File

@ -1,7 +1,7 @@
# eva
> Simple calculator REPL, similar to `bc`, with syntax highlighting and persistent history.
> More information <https://github.com/NerdyPepper/eva>.
> More information: <https://github.com/NerdyPepper/eva>.
- Run the calculator in interactive mode:

20
pages/common/fastlane.md Normal file
View File

@ -0,0 +1,20 @@
# fastlane
> Build and release mobile applications from the command-line.
> More information: <https://docs.fastlane.tools/actions/>.
- Build and sign the iOS application in the current directory:
`fastlane run build_app`
- Run `pod install` for the project in the current directory:
`fastlane run cocoapods`
- Delete the derived data from Xcode:
`fastlane run clear_derived_data`
- Remove the cache for pods:
`fastlane run clean_cocoapods_cache`

View File

@ -2,7 +2,7 @@
> Fast Node.js version manager.
> Install, uninstall or switch between Node.js versions.
> More info: <https://github.com/Schniz/fnm>.
> More information: <https://github.com/Schniz/fnm>.
- Install a specific version of Node.js:

View File

@ -19,6 +19,6 @@
`gh gist list --limit {{int}}`
- View a Gist in the default browser without rendering markdown:
- View a Gist in the default browser without rendering Markdown:
`gh gist view {{id_or_url}} --web --raw`

View File

@ -1,17 +1,17 @@
# glow
> Render Markdown in the terminal.
> More infomration: <https://github.com/charmbracelet/glow>.
> More information: <https://github.com/charmbracelet/glow>.
- Run glow and select a file to view:
`glow`
- Render a markdown file to the terminal:
- Render a Markdown file to the terminal:
`glow {{path/to/file}}`
- View a markdown file using a paginator:
- View a Markdown file using a paginator:
`glow -p {{path/to/file}}`

View File

@ -1,7 +1,7 @@
# IPython
> A Python shell with automatic history, dynamic object introspection, easier configuration, command completion, access to the system shell and more.
> More information: https://ipython.org/documentation.html.
> More information: <https://ipython.org/documentation.html>.
- Start an interactive IPython session:

View File

@ -1,7 +1,7 @@
# kotlin
> Kotlin Application Launcher.
> More information <https://kotlinlang.org>.
> More information: <https://kotlinlang.org>.
- Run a jar file:

View File

@ -1,9 +1,10 @@
# kubectl
> Command line interface for running commands against Kubernetes clusters.
> See also `kubectl describe` and other pages for additional information.
> More information: <https://kubernetes.io/docs/reference/kubectl/>.
- List all information about a resource with more details:
- List information about a resource with more details:
`kubectl get {{pod|service|deployment|ingress|...}} -o wide`

View File

@ -1,9 +1,9 @@
# mdp
> A command-line based tool to make presentations from markdown files.
> A command-line based tool to make presentations from Markdown files.
> More information: <https://github.com/visit1985/mdp>.
- Launch a presentation in the terminal from a markdown file:
- Launch a presentation in the terminal from a Markdown file:
`mdp {{presentation.md}}`

28
pages/common/mixxx.md Normal file
View File

@ -0,0 +1,28 @@
# mixxx
> Free and open source cross-platform DJ software.
> More information: <https://mixxx.org/manual/latest/chapters/appendix.html#command-line-options>.
- Start the Mixxx GUI in fullscreen:
`mixxx --fullScreen`
- Start in safe developer mode to debug a crash:
`mixxx --developer --safeMode`
- Debug a malfunction:
`mixxx --debugAssertBreak --developer --loglevel trace`
- Start mixxx using the specified settings file:
`mixxx --resourcePath {{mixxx/res/controllers}} --settingsPath {{path/to/settings-file}}`
- Debug a custom controller mapping:
`mixxx --controllerDebug --resourcePath {{path/to/mapping-directory}}`
- Show command line help:
`mixxx --help`

View File

@ -1,7 +1,7 @@
# nativefier
> Command-line tool to create a desktop app for any web site with minimal configuration.
> More information <https://github.com/jiahaog/nativefier>.
> More information: <https://github.com/jiahaog/nativefier>.
- Make a desktop app for a website:

View File

@ -1,7 +1,7 @@
# notmuch
> Command-line based program for indexing, searching, reading, and tagging large collections of email messages.
> More Information: <https://notmuchmail.org/manpages/>.
> More information: <https://notmuchmail.org/manpages/>.
- Configure for first use:

View File

@ -7,6 +7,6 @@
`openssl req -new -sha256 -key {{filename.key}} -out {{filename.csr}}`
- Generate a selfsigned certificate and a corresponding keypair, storing both in a file:
- Generate a self-signed certificate and a corresponding keypair, storing both in a file:
`openssl req -new -x509 -newkey {{rsa}}:{{4096}} -keyout {{filename.key}} -out {{filename.cert}} -subj "{{/C=XX/CN=foobar}}" -days {{365}}`

View File

@ -0,0 +1,20 @@
# pip install
> Install Python packages.
> More information: <https://pip.pypa.io>.
- Install a package:
`pip install {{package_name}}`
- Install a specific version of a package:
`pip install {{package_name}}=={{package_version}}`
- Install packages listed in a file:
`pip install -r {{requirements.txt}}`
- Install the local package in the current directory in develop (editable) mode:
`pip install -e .`

View File

@ -3,14 +3,10 @@
> Python package manager.
> More information: <https://pip.pypa.io>.
- Install a package:
- Install a package (see `pip install` for more install examples):
`pip install {{package_name}}`
- Install a specific version of a package:
`pip install {{package_name}}=={{package_version}}`
- Upgrade a package:
`pip install -U {{package_name}}`
@ -23,10 +19,6 @@
`pip freeze > {{requirements.txt}}`
- Install packages from file:
`pip install -r {{requirements.txt}}`
- Show installed package info:
`pip show {{package_name}}`

View File

@ -15,6 +15,6 @@
`roave-backward-compatibility-check --to={{git_reference}}`
- Check for breaking changes and output to markdown:
- Check for breaking changes and output to Markdown:
`roave-backward-compatibility-check --format=markdown > {{results.md}}`

View File

@ -10,6 +10,14 @@
`sha1sum {{filename1}} {{filename2}}`
- Calculate and save the list of SHA1 checksums to a file:
`sha1sum {{filename1}} {{filename2}} > {{filename.sha1}}`
- Read a file of SHA1 sums and verify all files have matching checksums:
`sha1sum -c {{filename.sha1}}`
`sha1sum --check {{filename.sha1}}`
- Only show a message for files for which verification fails:
`sha1sum --check --quiet {{filename.sha1}}`

View File

@ -10,6 +10,14 @@
`sha224sum {{filename1}} {{filename2}}`
- Calculate and save the list of SHA224 checksums to a file:
`sha224sum {{filename1}} {{filename2}} > {{filename.sha224}}`
- Read a file of SHA224 sums and verify all files have matching checksums:
`sha224sum -c {{filename.sha224}}`
`sha224sum --check {{filename.sha224}}`
- Only show a message for files for which verification fails:
`sha224sum --check --quiet {{filename.sha224}}`

View File

@ -10,6 +10,14 @@
`sha256sum {{filename1}} {{filename2}}`
- Calculate and save the list of SHA256 checksums to a file:
`sha256sum {{filename1}} {{filename2}} > {{filename.sha256}}`
- Read a file of SHA256 sums and verify all files have matching checksums:
`sha256sum -c {{filename.sha256}}`
`sha256sum --check {{filename.sha256}}`
- Only show a message for files for which verification fails:
`sha256sum --check --quiet {{filename.sha256}}`

View File

@ -10,6 +10,14 @@
`sha384sum {{filename1}} {{filename2}}`
- Calculate and save the list of SHA384 checksums to a file:
`sha384sum {{filename1}} {{filename2}} > {{filename.sha384}}`
- Read a file of SHA384 sums and verify all files have matching checksums:
`sha384sum -c {{filename.sha384}}`
`sha384sum --check {{filename.sha384}}`
- Only show a message for files for which verification fails:
`sha384sum --check --quiet {{filename.sha384}}`

View File

@ -10,6 +10,14 @@
`sha512sum {{filename1}} {{filename2}}`
- Calculate and save the list of SHA512 checksums to a file:
`sha512sum {{filename1}} {{filename2}} > {{filename.sha512}}`
- Read a file of SHA512 sums and verify all files have matching checksums:
`sha512sum -c {{filename.sha512}}`
`sha512sum --check {{filename.sha512}}`
- Only show a message for files for which verification fails:
`sha512sum --check --quiet {{filename.sha512}}`

View File

@ -14,10 +14,18 @@
`shasum --algorithm 512 {{filename1}} {{filename2}}`
- Calculate and save the list of SHA256 checksums to a file:
`shasum --algorithm 256 {{filename1}} {{filename2}} > {{filename.sha256}}`
- Check a file with a list of sums against the directory's files:
`shasum --check {{list_file}}`
- Check a list of sums and only show a message for files for which verification fails:
`shasum --check --quiet {{list_file}}`
- Calculate the SHA1 checksum from `stdin`:
`{{somecommand}} | shasum`

View File

@ -1,6 +1,7 @@
# thunderbird
> Email client and RSS reader.
> More information: <https://thunderbird.net>.
- Open thunderbird:

28
pages/common/topydo.md Normal file
View File

@ -0,0 +1,28 @@
# topydo
> A todo list application that uses the todo.txt format.
> More information: <https://github.com/topydo/topydo>.
- Add a todo to a specific project with a given context:
`topydo add "{{todo_message}} +{{project_name}} @{{context_name}}"`
- Add a todo with a due date of tomorrow with a priority of `A`:
`topydo add "(A) {{todo _message}} due:{{1d}}"`
- Add a todo with a due date of friday:
`topydo add "{{todo_message}} due:{{fri}}"`
- Add a non-strict repeating todo (next due = now + rec):
`topydo add "water flowers due:{{mon}} rec:{{1w}}"`
- Add a strict repeating todo (next due = currentdue + rec):
`topydo add "{{todo_message}} due:{{2020-01-01}} rec:{{+1m}}"`
- Revert the last `topydo` command executed:
`topydo revert`

25
pages/common/tuir.md Normal file
View File

@ -0,0 +1,25 @@
# tuir
> A text user-interface (TUI) to view and interact with Reddit from your terminal.
> Navigate with the Vim keys.
> More information: <https://gitlab.com/ajak/tuir>.
- Launch tuir:
`tuir`
- Open a subreddit:
`/{{subreddit_name}}`
- Open a link:
`o`
- Open a specific subreddit on launch:
`tuir -s {{subreddit_name}}`
- Open external links using programs defined in the mailcap config:
`tuir --enable-media`

View File

@ -1,8 +1,8 @@
# virsh
> Manage virsh guest domains.
> More information: <https://libvirt.org/virshcmdref.html>.
> NOTE: 'guest_id' can be the id, name or UUID of the guest.
> More information: <https://libvirt.org/virshcmdref.html>.
- Connect to a hypervisor session:

View File

@ -1,7 +1,7 @@
# efibootmgr
> Manipulate the UEFI Boot Manager (the Bootoptions).
> More information: https://linux.die.net/man/8/efibootmgr.
> More information: <https://linux.die.net/man/8/efibootmgr>.
- List the current settings / bootnums:

View File

@ -1,7 +1,7 @@
# Homeshick
# homeshick
> Synchronize Git dotfiles.
> More information <https://github.com/andsens/homeshick/wiki>.
> More information: <https://github.com/andsens/homeshick/wiki>.
- Create a new castle:

View File

@ -0,0 +1,15 @@
# kde-inhibit
> Inhibit various desktop functions while a command runs.
- Inhibit power management:
`kde-inhibit --power {{command}} {{command_arguments}}`
- Inhibit screen saver:
`kde-inhibit --screenSaver {{command}} {{command_arguments}}`
- Launch vlc, and inhibit colour correction (night mode) while it's running:
`kde-inhibit --colorCorrect {{vlc}}`

View File

@ -29,3 +29,7 @@
- Exclude the devices specified by the comma-separated list of major device numbers:
`lsblk -e {{1,7}}`
- Display a customized summary using a comma-separated list of columns:
`lsblk --output {{NAME}},{{SERIAL}},{{MODEL}},{{TRAN}},{{TYPE}},{{SIZE}},{{FSTYPE}},{{MOUNTPOINT}}`

View File

@ -19,6 +19,6 @@
`mdbook serve`
- Watch a set of markdown files and automatically build when a file is changed:
- Watch a set of Markdown files and automatically build when a file is changed:
`mdbook watch`

View File

@ -1,6 +1,7 @@
# nethogs
> Monitor bandwidth usage per process.
> More information: <https://github.com/raboof/nethogs>.
- Start nethogs as root (default device is eth0):

View File

@ -1,7 +1,7 @@
# rofi
> An application launcher and window switcher.
> More Information: <https://github.com/davatorium/rofi>.
> More information: <https://github.com/davatorium/rofi>.
- Show the list of apps:

View File

@ -1,6 +1,7 @@
# thunar
> Graphical file manager for XFCE desktop environments.
> More information: <https://docs.xfce.org/xfce/thunar/start>.
- Open a new window showing the current directory:

View File

@ -1,7 +1,7 @@
# vgs
> Display information about LVM volume groups.
> More information: https://man7.org/linux/man-pages/man8/vgs.8.html .
> More information: <https://man7.org/linux/man-pages/man8/vgs.8.html>.
- Display information about volume groups:

16
pages/osx/security.md Normal file
View File

@ -0,0 +1,16 @@
# security
> Administer Keychains, keys, certificates and the Security framework.
> More information: <https://ss64.com/osx/security.html>.
- List the available keychains:
`security list-keychains`
- Delete a specific keychain:
`security delete-keychain {{path}}`
- Create a keychain:
`security create-keychain -p {{password}} {{name.keychain}}`

36
pages/osx/tmutil.md Normal file
View File

@ -0,0 +1,36 @@
# tmutil
> Utility for managing Time Machine backups. Most verbs require root privileges.
> More information: <https://ss64.com/osx/tmutil.html>.
- Set a HFS+ drive as the backup destination:
`sudo tmutil setdestination {{path/to/disk_mount_point}}`
- Set a APF share or SMB share as the backup destination:
`sudo tmutil setdestination {{protocol://user[:password]@host/share}}`
- Append the given destination to the list of destinations:
`sudo tmutil setdestination -a {{destination}}`
- Enable automatic backups:
`sudo tmutil enable`
- Disable automatic backups:
`sudo tmutil disable`
- Start a backup, if one is not running already, and release control of the shell:
`sudo tmutil startbackup`
- Start a backup and block until the backup is finished:
`sudo tmutil startbackup -b`
- Stop a backup:
`sudo tmutil stopbackup`

View File

@ -2,7 +2,7 @@
> Prompts the user to select one item from a list of single-character choices in a batch program, and then returns the index of the selected choice.
> If used without parameters, choice displays the default choices Y and N.
> More Information: <https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/choice>.
> More information: <https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/choice>.
- A,B and C as list of choices to be used:

View File

@ -1,6 +1,7 @@
# cipher
> Encrypt or decrypt files on NTFS drives.
> More information: <https://docs.microsoft.com/windows-server/administration/windows-commands/cipher>.
- Encrypt a file or directory:

View File

@ -1,6 +1,7 @@
# ftp
> Interactively transfer files between a local and remote FTP server.
> More information: <https://docs.microsoft.com/windows-server/administration/windows-commands/ftp>.
- Connect to a remote FTP server interactively:

View File

@ -1,6 +1,7 @@
# xcopy
> Copy files and directory trees.
> More information: <https://docs.microsoft.com/windows-server/administration/windows-commands/xcopy>.
- Copy the file(s) to the specified destination: