mirror of
https://github.com/scopatz/nanorc
synced 2024-11-27 12:25:53 +01:00
New Readme file, with more organised information.
This commit is contained in:
Tiago Almeida
parent
5873ea106f
commit
d34d3661e3
83
Readme.rst
83
Readme.rst
|
|
@ -1,83 +0,0 @@
|
||||||
***************************************
|
|
||||||
Improved Nano Syntax Highlighting Files
|
|
||||||
***************************************
|
|
||||||
|
|
||||||
This repository holds ``{lang}.nanorc`` files that have improved
|
|
||||||
definitions of syntax highlighting for various languages.
|
|
||||||
|
|
||||||
|
|
||||||
1. Copy files
|
|
||||||
~~~~~~
|
|
||||||
|
|
||||||
These should be placed inside of the ``~/.nano/`` directory.
|
|
||||||
Or for system-wide installation ``/usr/share/nano-syntax-highlighting/``.
|
|
||||||
In other words::
|
|
||||||
|
|
||||||
git clone git@github.com:scopatz/nanorc.git ~/.nano
|
|
||||||
|
|
||||||
*Note - if you have any issues (ssh was not properly configured), alternatively use::
|
|
||||||
|
|
||||||
git clone https://github.com/scopatz/nanorc.git ~/.nano
|
|
||||||
|
|
||||||
*System wide will look like so*::
|
|
||||||
|
|
||||||
sudo git clone https://github.com/scopatz/nanorc.git /usr/share/nano-syntax-highlighting/
|
|
||||||
|
|
||||||
**NOTE**: \< and \> are regular character escapes on macOS. The bug's 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 [[:>:]].
|
|
||||||
This is reported in `issue 52 <https://github.com/scopatz/nanorc/issues/52>`_
|
|
||||||
|
|
||||||
2. Configure ``nano``
|
|
||||||
~~~~~~~~~
|
|
||||||
|
|
||||||
Once there you should add the languages you want to your
|
|
||||||
nano configuration file ``~/.nanorc``. For example::
|
|
||||||
|
|
||||||
## C/C++
|
|
||||||
include "~/.nano/c.nanorc"
|
|
||||||
|
|
||||||
You can also append the contents of ``~/.nano/nanorc`` into your
|
|
||||||
``~/.nanorc`` to include all languages::
|
|
||||||
|
|
||||||
cat ~/.nano/nanorc >> ~/.nanorc
|
|
||||||
|
|
||||||
Or to be less verbose, append content of the folder in one line with wildcard::
|
|
||||||
|
|
||||||
## For all users
|
|
||||||
$ echo "include $install_path/*.nanorc" >> /etc/nanorc
|
|
||||||
## For current user
|
|
||||||
$ echo "include $install_path/*.nanorc" >> ~/.nanorc
|
|
||||||
|
|
||||||
where ``$install_path`` is ``/usr/share/nano-syntax-highlighting`` or ``~/.nano/`` or ...
|
|
||||||
|
|
||||||
1a. Automatic installer
|
|
||||||
~~~~~~~~~~~~~~~~~~~~~~
|
|
||||||
Finally, you can run an automatic installer using the following code::
|
|
||||||
|
|
||||||
$ curl https://raw.githubusercontent.com/scopatz/nanorc/master/install.sh | sh
|
|
||||||
|
|
||||||
or alternatively::
|
|
||||||
|
|
||||||
$ wget https://raw.githubusercontent.com/scopatz/nanorc/master/install.sh -O- | sh
|
|
||||||
|
|
||||||
*Note -
|
|
||||||
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.
|
|
||||||
|
|
||||||
|
|
||||||
1b. Distributive specific installation via package managers
|
|
||||||
~~~~~~~~~~
|
|
||||||
On **Arch Linux** and other *pacman/aur* based systems it is possible to::
|
|
||||||
|
|
||||||
$ aurman -S nano-syntax-highlighting-git
|
|
||||||
|
|
||||||
or search package::
|
|
||||||
|
|
||||||
$ aurman -Ss nano-syntax-highlight
|
|
||||||
|
|
||||||
Then you need to mannually add ``.nanorc``-s to user's ``~/.nanorc`` or system ``/etc/nanorc``. See **$2**
|
|
||||||
|
|
||||||
Acknowledgement
|
|
||||||
~~~~~~~~~~~~~~~
|
|
||||||
Some of these files are derived from the original nano release [`Project <https://www.nano-editor.org/>`_] [`Repository <https://git.savannah.gnu.org/cgit/nano.git>`_]
|
|
||||||
97
readme.md
Normal file
97
readme.md
Normal file
|
|
@ -0,0 +1,97 @@
|
||||||
|
# Improved Nano Syntax Highlighting Files
|
||||||
|
|
||||||
|
This repository holds ``{lang}.nanorc`` files that have improved definitions of syntax highlighting for various languages.
|
||||||
|
|
||||||
|
# Installation
|
||||||
|
|
||||||
|
There are three ways to install this repo.
|
||||||
|
|
||||||
|
## 1. Automatic installer
|
||||||
|
|
||||||
|
Copy the following code to download and run the installer script:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
curl https://raw.githubusercontent.com/scopatz/nanorc/master/install.sh | sh
|
||||||
|
```
|
||||||
|
|
||||||
|
If your machine doesn't have `curl` command, use this code:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
wget https://raw.githubusercontent.com/scopatz/nanorc/master/install.sh -O- | sh
|
||||||
|
```
|
||||||
|
|
||||||
|
### Note:
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
## 2. Package managers
|
||||||
|
|
||||||
|
The follow table lists all systems with this package published.
|
||||||
|
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`.
|
||||||
|
|
||||||
|
| System | Command |
|
||||||
|
| --- | --- |
|
||||||
|
| Arch Linux | `aurman -S nano-syntax-highlighting-git` or `aurman -Ss nano-syntax-highlight` |
|
||||||
|
|
||||||
|
## 3. Clone repo (copy the files)
|
||||||
|
|
||||||
|
The files should be placed inside of the `~/.nano/` directory.
|
||||||
|
|
||||||
|
> You can put the files in another directory inside the correct `.nano` folder.
|
||||||
|
> 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 user, only run:
|
||||||
|
|
||||||
|
`git clone git@github.com:scopatz/nanorc.git $install_path` or
|
||||||
|
`git clone https://github.com/scopatz/nanorc.git $install_path`
|
||||||
|
|
||||||
|
For system wide, run:
|
||||||
|
|
||||||
|
`sudo git clone https://github.com/scopatz/nanorc.git $install_path`
|
||||||
|
|
||||||
|
# Configuration
|
||||||
|
|
||||||
|
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.
|
||||||
|
> If this file doesn't exist, create a new one.
|
||||||
|
|
||||||
|
Again there are three ways:
|
||||||
|
|
||||||
|
# 1. Include all
|
||||||
|
|
||||||
|
Append the content of the folder in one line, with wildcard::
|
||||||
|
|
||||||
|
`echo "include $install_path/*.nanorc" >> ~/.nanorc` or
|
||||||
|
`echo "include $install_path/*.nanorc" >> /etc/nanorc`
|
||||||
|
|
||||||
|
## 2. Include/append our `nanorc` file
|
||||||
|
|
||||||
|
Simply run:
|
||||||
|
|
||||||
|
`cat $install_path/nanorc >> ~/.nanorc` or
|
||||||
|
`cat $install_path/nanorc >> /etc/nanorc`
|
||||||
|
|
||||||
|
## 3. One by one
|
||||||
|
|
||||||
|
Add your preferable languages one by onento the file. For example:
|
||||||
|
|
||||||
|
```
|
||||||
|
## C/C++
|
||||||
|
include "~/.nano/c.nanorc"
|
||||||
|
```
|
||||||
|
|
||||||
|
# Tricks & Tweaks
|
||||||
|
|
||||||
|
## 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
|
||||||
|
If this is the case, replace them respectively with `[[:<:]]` and `[[:>:]]`.
|
||||||
|
This is reported in [Issue 52](https://github.com/scopatz/nanorc/issues/52).
|
||||||
|
|
||||||
|
# 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)
|
||||||
Loading…
Reference in New Issue
Block a user