Marown/hosts
1
0
Fork 0
mirror of https://github.com/StevenBlack/hosts.git synced 2024-06-28 16:45:46 +02:00
Code Issues Packages Projects Releases Wiki Activity

Issue #118: document the whitelist.

Browse Source
This commit is contained in:
Steven Black 2016-04-02 11:23:29 -04:00
parent af5d554b7c
commit 1f3c243d22
1 changed files with 14 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
readme_template.md
View File

@ -79,11 +79,24 @@ Add one or more *additional* sources, each in a subfolder of the `data/` folder
Add one or more *optional* extensions, which originate from subfolders of the `extensions/` folder. Again the url in
`update.info` controls where this extension finds its updates.
## How do I incorporate my own hosts?
### How do I include my own custom domain mappings?
If you have custom hosts records, place them in file `myhosts`. The contents of this file are prepended to the
unified hosts file during the update process.
The `myhosts` file is not tracked by git, so any changes you make won't be overridden when you `git pull` this repo from `origin` in the future.
### How do I prevent domains from being included?
The domains you list in the `whitelist` file are excluded from the final hosts file.
The `whitelist` uses partial matching. Therefore if you whitelist `google-analytics.com`, that domain and all its
subdomains won't be merged into the final hosts file.
The `whitelist` is not tracked by git, so any changes you make won't be overridden when you `git pull` this repo
from `origin` in the future.
## What is a hosts file?
A hosts file, named `hosts` (with no file extension), is a plain-text file used by all operating