mirror of
https://github.com/KevinMidboe/linguist.git
synced 2025-10-29 17:50:22 +00:00
Merge remote-tracking branch 'origin/master' into rewrite-readme
* origin/master: (97 commits) Modifying some modeline fixtures to test case InSeNsItivitY Making modelines case-insensitive Missing whitespace Vim and Emacs modelines Update README.md Update URL for AutoHotkey grammar Remove grammar for AutoHotkey Bumping version to v4.3.1 Grammar update 'Text' doesn't qualify as a valid modeline language. Add .4TH Forth extension. Grammar for eC from TextMate bundle Sample for eC Grammar for Ox from Sublime Text package Grammar for Grace from TextMate bundle Grammar for G-Code from Sublime Text package Grammar for TXL from Sublime Text package Grammar for J from Sublime Text package Sample for J Grammar for Golo from Sublime Text package ... Conflicts: README.md
This commit is contained in:
19
README.md
19
README.md
@@ -22,9 +22,11 @@ The Language stats bar is built by aggregating the languages of each file in tha
|
||||
|
||||
## Overrides
|
||||
|
||||
Linguist supports custom overrides for language definitions and vendored paths. Please note that the overrides currently only affect the language statistics for a repository and not the syntax-highlighting of files.
|
||||
Linguist supports a number of different custom overrides strategies for language definitions and vendored paths.
|
||||
|
||||
Commit a `.gitattributes` file to your project and use standard git-style path matchers for the files you want to override to set `linguist-language` and `linguist-vendored`.
|
||||
### Using gitattributes
|
||||
|
||||
Add a `.gitattributes` file to your project and use standard git-style path matchers for the files you want to override to set `linguist-language` and `linguist-vendored`.
|
||||
|
||||
```
|
||||
$ cat .gitattributes
|
||||
@@ -40,3 +42,16 @@ $ cat .gitattributes
|
||||
special-vendored-path/* linguist-vendored
|
||||
jquery.js linguist-vendored=false
|
||||
```
|
||||
|
||||
### Using Emacs and Vim modelines
|
||||
|
||||
Alternatively, you can use Vim and Emacs style modelines to set the language for a single file. Modelines can be placed anywhere within a file and are respected when determining how to syntax-highlight a file on GitHub.com
|
||||
|
||||
```
|
||||
Vim
|
||||
vim: set filetype=prolog:
|
||||
vim: set ft=cpp:
|
||||
|
||||
Emacs
|
||||
-*- mode: php;-*-
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user