home

my firefox custom homepage
Log | Files | Refs | README | git clone https://git.ne02ptzero.me/git/home

README.md (2100B)


      1 # Firefox Home Page
      2 ![Image](https://i.imgur.com/vMecc7g.png)
      3 ## Install
      4 Clone
      5 ```
      6 git clone https://github.com/Ne02ptzero/home
      7 ```
      8 
      9 Install:
     10 ```
     11 sudo npm install html-minifier -g
     12 ```
     13 
     14 ## Compile & Launch
     15 ```
     16 make && sudo make serve
     17 ```
     18 Since the site is statically compiled, one must re-do ```make``` on any changes.
     19 
     20 Go to [the home page](127.0.0.1)
     21 
     22 ## Integration with firefox
     23 Install the [New tabs Override addon](https://addons.mozilla.org/en-US/firefox/addon/new-tab-override/)
     24 Choose the option ```custom URL``` and put the server URL below.
     25 Do not forget to check the ```Focus``` option.
     26 
     27 If you're like me and do not like the default addressbar, add an entry in your
     28 ```/etc/hosts``` file like: ```127.0.0.1 home.com``` and change the url to ```home.com```
     29 in the New Tabs Override configuration.
     30 
     31 ## Bangs
     32 You can search directly on specific websites with bangs.
     33 For example, if one types
     34 ```
     35 yt lorenzo
     36 ```
     37 in the search bar, he will be redirected to a youtube search of the keyword 'lorenzo'. See the on-site help for all the avalailable bangs.
     38 
     39 ## Shortcuts
     40 There are some shortcuts available in order to gain some time. For example, if one types
     41 ```
     42 fb
     43 ```
     44 in the progress bar, he will be redirected to facebook.
     45 See all shortcuts in the main.js file, ```shortcuts``` array
     46 
     47 ## Adding a custom bang
     48 One must edit the ```bangs/bangs_custom.json``` file, and add an entry in it:
     49 ```
     50 "bang": {
     51   "url": "https://site.com/search/%s",
     52   "help": "Something short about this site"
     53 }
     54 ```
     55 With this entry, if one types ```bang test``` in his input, he will be redirected to ```https://site.com/search/test```.
     56 
     57 ## Adding a custom shortcuts
     58 One must edit the ```shortcuts/bangs_shortcuts.json``` file, and add an entry in it:
     59 ```
     60 "sh": "https://shortcuts.com"
     61 ```
     62 With this entry, if one types ```sh``` in his input, he will be redirected to ```https://shortcuts.com```
     63 
     64 ## Editing the links
     65 All the home page links can be edited in the index.html file.
     66 
     67 ## Editing style
     68 All CSS style is in the main.css file.
     69 
     70 ## Contributing
     71 If you have new cool shortcuts / bangs, please share-them with us!