Explorar o código

chore: readme & changelog

Sv443 %!s(int64=2) %!d(string=hai) anos
pai
achega
3c6491f9e0
Modificáronse 3 ficheiros con 11 adicións e 26 borrados
  1. 0 17
      .editorconfig
  2. 10 9
      README.md
  3. 1 0
      changelog.md

+ 0 - 17
.editorconfig

@@ -1,17 +0,0 @@
-# root = true
-
-# [*]
-# indent_style = space
-# tab_width = 4
-# indent_size = 4
-# charset = utf-8
-# trim_trailing_whitespace = false
-# insert_final_newline = true
-# curly_bracket_next_line = true
-# spaces_around_operators = true
-
-# # 2-space indentation
-# [{package.json,package-lock.json,**.yml}]
-# indent_style = space
-# indent_size = 2
-# tab_width = 2

+ 10 - 9
README.md

@@ -2,6 +2,8 @@
 Simple JSON and XML REST API to search for song metadata, the lyrics URL and lyrics translations on [genius.com](https://genius.com/)  
 Authorization is not required and geniURL implements a fuzzy search that will greatly improve search results over the genius.com API.  
 Obtaining actual lyrics sadly isn't possible.  
+  
+Like geniURL? Please consider [supporting the development ❤️](https://github.com/sponsors/Sv443)
 
 <br><br>
 
@@ -18,8 +20,7 @@ https://api.sv443.net/geniurl/
 ```
 
 <sub>
-Note that this instance is rate limited to 5 requests within 10 seconds.<br>
-If you want to host your own and increase the values, look at the top of `src/server.ts`
+Note that this instance is rate limited to 10 requests within 30 seconds per unique client.
 </sub>
 
 <br><br>
@@ -45,13 +46,13 @@ All routes support gzip and deflate compression.
 > `?q=search%20query`  
 > This parameter should contain both the song and artist name. For best result artist name should come first, separate with a whitespace or hyphen.  
 > Sometimes the song name alone might be enough but the results vary greatly.  
-> Using this parameter instead of `?artist` and `?song` means you will get slightly less accurate results.  
+> If you want to search for a remix (like `?q=Artist - Song (Artist2 Remix)`), this parameter will yield better results.  
 > Make sure the search query is [percent/URL-encoded.](https://en.wikipedia.org/wiki/Percent-encoding)  
 > 
 > **OR**
 > 
 > `?artist=name` and `?song=name`  
-> Instead of `?q`, you can use `?artist` and `?song` to help geniURL filter the search results a little better.  
+> Instead of `?q`, you can also use `?artist` and `?song`.  
 > Make sure these parameters are [percent/URL-encoded.](https://en.wikipedia.org/wiki/Percent-encoding)
 > 
 > <br>
@@ -60,7 +61,7 @@ All routes support gzip and deflate compression.
 > `?preferLang=en`  
 > Sometimes the genius API and geniURL's filtering will rank song translations or remixes higher than the original song. This optional parameter can help with that.  
 > Specify a [two-character ISO 639-1 language code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) here to tell geniURL to prefer results of that language.  
-> Note that this only changes the ranking. Results of other languages will still be returned.
+> Note that this only changes the ranking. Filtering will stay the same and results of other languages will still be returned.
 >   
 > `?format=json/xml`  
 > Use this optional parameter to change the response format from the default (`json`) to `xml`  
@@ -166,13 +167,13 @@ All routes support gzip and deflate compression.
 > `?q=search%20query`  
 > This parameter should contain both the song and artist name. For best result artist name should come first, separate with a whitespace or hyphen.  
 > Sometimes the song name alone might be enough but the results vary greatly.  
-> Using this parameter instead of `?artist` and `?song` means you will get slightly less accurate results.  
+> If you want to search for a remix (like `?q=Artist - Song (Artist2 Remix)`), this parameter will yield better results.  
 > Make sure the search query is [percent/URL-encoded.](https://en.wikipedia.org/wiki/Percent-encoding)  
 > 
 > **OR**
 > 
 > `?artist=name` and `?song=name`  
-> Instead of `?q`, you can use `?artist` and `?song` to help geniURL filter the search results a little better.  
+> Instead of `?q`, you can also use `?artist` and `?song`.  
 > Make sure these parameters are [percent/URL-encoded.](https://en.wikipedia.org/wiki/Percent-encoding)
 > 
 > <br><br>
@@ -181,7 +182,7 @@ All routes support gzip and deflate compression.
 > `?preferLang=en`  
 > Sometimes the genius API and geniURL's filtering will rank song translations or remixes higher than the original song. This optional parameter can help with that.  
 > Specify a [two-character ISO 639-1 language code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) here to tell geniURL to prefer results of that language.  
-> Note that this only changes the ranking. Results of other languages will still be returned.
+> Note that this only changes the ranking. Filtering will stay the same and results of other languages will still be returned.
 >   
 > `?format=json/xml`  
 > Use this optional parameter to change the response format from the default (`json`) to `xml`  
@@ -281,7 +282,7 @@ All routes support gzip and deflate compression.
 > `?preferLang=en`  
 > The filtering done by the genius API and geniURL will sometimes produce results that are ranked inconsistently. This optional parameter can help with that.  
 > Specify a [two-character ISO 639-1 language code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) here to tell geniURL to prefer results of that language.  
-> Note that this only changes the ranking. Results of other languages will still be returned.
+> Note that this only changes the ranking. Filtering will stay the same and results of other languages will still be returned.
 >   
 > `?format=json/xml`  
 > Use this optional parameter to change the response format from the default (`json`) to `xml`  

+ 1 - 0
changelog.md

@@ -13,6 +13,7 @@
 - Added route `/translations/:songId` to receive info about a song's translation pages
 - Added route `/album/:songId` to get info about the album that the provided song is in
 - Added parameter `?preferLang=en` to always rank results of a certain language higher than the rest
+- geniURL will now replace inconsistent unicode characters with ASCII ones ([#15](https://github.com/Sv443/geniURL/issues/15))
 
 <br>