Merge pull request #246 from SuperSandro2000/patch-1

Fix heading levels, remove quote sections
This commit is contained in:
Anthony Scopatz 2019-09-13 14:34:25 -04:00 committed by GitHub
commit d8fcf5fd0f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -2,11 +2,11 @@
This repository holds ``{lang}.nanorc`` files that have improved definitions of syntax highlighting for various languages. This repository holds ``{lang}.nanorc`` files that have improved definitions of syntax highlighting for various languages.
# Installation ## Installation
There are three ways to install this repo. There are three ways to install this repo.
## 1. Automatic installer ### 1. Automatic installer
Copy the following code to download and run the installer script: Copy the following code to download and run the installer script:
@ -20,28 +20,29 @@ If your machine doesn't have `curl` command, use this code:
wget https://raw.githubusercontent.com/scopatz/nanorc/master/install.sh -O- | sh wget https://raw.githubusercontent.com/scopatz/nanorc/master/install.sh -O- | sh
``` ```
### Note: #### Note
Some syntax definitions which exist in Nano upstream may be preferable to the ones provided by this package. Some syntax definitions which exist in Nano upstream may be preferable to the ones provided by this package.
The ` install.sh` script may be run with `-l` or `--lite` to insert the included syntax definitions from this package with *lower* precedence than the ones provided by the standard package. The ` install.sh` script may be run with `-l` or `--lite` to insert the included syntax definitions from this package with *lower* precedence than the ones provided by the standard package.
## 2. Package managers ### 2. Package managers
The follow table lists all systems with this package published. The follow table lists all systems with this package published.
Fell free to add your official package manager. Fell free to add your official package manager.
> Systems that are based in others' package managers or repositories are compatible. For example: `pacman/aur` based systems are compatible with `Arch Linux`. > Systems that are based in others' package managers or repositories are compatible. For example: `pacman/aur` based systems are compatible with `Arch Linux`.
| System | Command | | System | Command |
| --- | --- | | ---------- | ---------------------------------------- |
| Arch Linux | `aurman -S nano-syntax-highlighting-git` or `aurman -Ss nano-syntax-highlight` | | Arch Linux | `aurman -Ss nano-syntax-highlight` |
| | `aurman -S nano-syntax-highlighting-git` |
## 3. Clone repo (copy the files) ### 3. Clone repo (copy the files)
The files should be placed inside of the `~/.nano/` directory. The files should be placed inside of the `~/.nano/` directory.
> You can put the files in another directory inside the correct `.nano` folder. You can put the files in another directory inside the correct `.nano` folder.
> For example: `~/.nano/nanorc/`. For example: `~/.nano/nanorc/`.
> For readability will use `$install_path` for the path of your choose (in *system wide* the path is always `/usr/share/nano-syntax-highlighting/`). For readability will use `$install_path` for the path of your choose (in *system wide* the path is always `/usr/share/nano-syntax-highlighting/`).
For user, only run: For user, only run:
@ -52,29 +53,29 @@ For system wide, run:
`sudo git clone https://github.com/scopatz/nanorc.git $install_path` `sudo git clone https://github.com/scopatz/nanorc.git $install_path`
# Configuration ## Configuration
After installation, you need to inform `nano` to used the new highlight files. After installation, you need to inform `nano` to used the new highlight files.
The configuration file is located at `~/.nanorc`, for users, and at `/etc/nanorc`, for system wide. The configuration file is located at `~/.nanorc`, for users, and at `/etc/nanorc`, for system wide.
> If this file doesn't exist, create a new one. If this file doesn't exist, create a new one.
Again there are three ways: Again there are three ways:
## 1. Include all ### 1. Include all
Append the content of the folder in one line, with wildcard:: Append the content of the folder in one line, with wildcard::
`echo "include $install_path/*.nanorc" >> ~/.nanorc` or `echo "include $install_path/*.nanorc" >> ~/.nanorc` or
`echo "include $install_path/*.nanorc" >> /etc/nanorc` `echo "include $install_path/*.nanorc" >> /etc/nanorc`
## 2. Include/append our `nanorc` file ### 2. Include/append our `nanorc` file
Simply run: Simply run:
`cat $install_path/nanorc >> ~/.nanorc` or `cat $install_path/nanorc >> ~/.nanorc` or
`cat $install_path/nanorc >> /etc/nanorc` `cat $install_path/nanorc >> /etc/nanorc`
## 3. One by one ### 3. One by one
Add your preferable languages one by onento the file. For example: Add your preferable languages one by onento the file. For example:
@ -83,15 +84,15 @@ Add your preferable languages one by onento the file. For example:
include "~/.nano/c.nanorc" include "~/.nano/c.nanorc"
``` ```
# Tricks & Tweaks ## Tricks & Tweaks
## MacOS ### MacOS
`\<` and `\>` are regular character escapes on MacOS. `\<` and `\>` are regular character escapes on MacOS.
The bug is fixed in Nano, but this might be a problem if you are using an older version The bug is fixed in Nano, but this might be a problem if you are using an older version
If this is the case, replace them respectively with `[[:<:]]` and `[[:>:]]`. If this is the case, replace them respectively with `[[:<:]]` and `[[:>:]]`.
This is reported in [Issue 52](https://github.com/scopatz/nanorc/issues/52). This is reported in [Issue 52](https://github.com/scopatz/nanorc/issues/52).
# Acknowledgements ## Acknowledgements
Some of these files are derived from the original [Nano](https://www.nano-editor.org) editor [repo](https://git.savannah.gnu.org/cgit/nano.git) Some of these files are derived from the original [Nano](https://www.nano-editor.org) editor [repo](https://git.savannah.gnu.org/cgit/nano.git)