Upload files to "pages"

2025-03-08 00:54:54 +00:00 · 2025-03-08 00:54:54 +00:00 · 78993bf593
commit 78993bf593
parent 0db2b972ad
2 changed files with 138 additions and 0 deletions
--- a/pages/about.md
+++ b/pages/about.md
--- a/pages/search-syntax.md
+++ b/pages/search-syntax.md
@ -0,0 +1,95 @@
+# Search Syntax
+
+monowi.re boasts a dynamic search syntax, allowing you to modify categories, engines, languages, and more. Check out the [preferences](https://monowi.re/preferences) for a complete list of engines, categories, and languages.
+
+## `!` Select Engine and Category
+
+Customize your search by using a `!` prefix to specify category and/or engine names. For example:
+
+- Search Wikipedia for **Night City**:
+  - [!wp Night City](https://monowi.re/search?q=%21wp%20Night%20City)
+  - [!wikipedia Night City](https://monowi.re/search?q=%21wikipedia%20Night%20City)
+
+- Search in category **map** for **Night City**:
+  - [!map Night City](https://monowi.re/search?q=%21map%20Night%20City)
+
+- Image search:
+  - [!images Johnny Silverhand](https://monowi.re/search?q=%21images%20Johnny%20Silverhand)
+
+Abbreviations for engines and languages are accepted. Engine/category modifiers are chainable and inclusive. E.g., [!map !ddg !wp Night City](https://monowi.re/search?q=%21map%20%21ddg%20%21wp%0ANight%20City) searches the map category, DuckDuckGo, and Wikipedia for **Night City**.
+
+## `:` Select Language
+
+Use a `:` prefix to filter by language. For example:
+
+- Search Wikipedia in French:
+  - [:fr !wp Johnny Silverhand](https://monowi.re/search?q=%3Afr%20%21wp%20Johnny%20Silverhand)
+
+## `!!<bang>` External Bangs
+
+monowi.re supports external bangs from [DuckDuckGo](https://duckduckgo.com/bang). Use the `!!` prefix for a direct jump to an external search page. For example:
+
+- Directly search Wikipedia in French:
+  - [!!wfr Johnny Silverhand](https://monowi.re/search?q=%21%21wfr%20Johnny%20Silverhand)
+
+Note that your search will be performed directly on the external engine; monowi.re cannot protect your privacy in these cases.
+
+## `!!` Automatic Redirect
+
+Mention `!!` within a search query (separated by spaces) to be automatically redirected to the first result, similar to DuckDuckGo's "Feeling Lucky" feature. For example:
+
+- Search for a query and get redirected to the first result:
+  - [!! Johnny Silverhand](https://monowi.re/search?q=%21%21%20Johnny%20Silverhand)
+
+Keep in mind that the results may not be verified as trustworthy, and monowi.re cannot ensure your privacy when using this feature. Use it at your own risk.
+
+## Special Queries
+
+The [preferences](https://monowi.re/preferences) page lists keywords for *special queries*. Examples include:
+
+- Generate a random UUID:
+  - [random uuid](https://monowi.re/search?q=random%20uuid)
+
+- Find the average:
+  - [avg 2077 2023 77.04 50.5](https://monowi.re/search?q=avg%202077%202023%2077.04%2050.5)
+
+- Show your browser's *user agent* (needs activation):
+  - [user-agent](https://monowi.re/search?q=user-agent)
+
+- Convert strings to different hash digests (needs activation):
+  - [md5 cyberpunk](https://monowi.re/search?q=md5%20cyberpunk)
+  - [sha512 cyberpunk](https://monowi.re/search?q=sha512%20cyberpunk)
+
+## Advanced Search Syntax
+
+monowi.re provides additional syntax options to refine your search:
+
+- **Excluding Words**: Use a minus sign (`-`) before words to exclude them.
+  - Example: `Night City -Johnny`
+
+- **Exact Match**: Use quotes to search for an exact phrase.
+  - Example: `"Johnny Silverhand"`
+
+- **Wildcard Search**: Use an asterisk (`*`) as a placeholder for any word or phrase.
+  - Example: `Johnny * hand`
+
+- **Group Words**: Use parentheses to group terms or phrases.
+  - Example: `(Johnny OR Silverhand) AND Night City`
+
+- **OR Searches**: Use `OR` to find results containing any specified terms.
+  - Example: `Johnny OR Silverhand`
+
+- **AND Searches**: Use `AND` to ensure results include all terms, though it is typically implicit.
+  - Example: `Johnny AND Silverhand AND Night City`
+
+- **Site Search**: Use `site:` to restrict your search to a specific site or domain. For instance, to search for content related to "cyber" on the site datakra.sh:
+  - Example: `cyber site:datakra.sh`
+
+- **File Type Search**: Use `filetype:` to search for specific types of files.
+  - Example: `Cyberpunk 2020 filetype:pdf`
+
+- **Title Search**: Use `intitle:` to search for pages with a specific word in the title.
+  - Example: `intitle:"Night City"`
+
+- **URL Search**: Use `inurl:` to search for pages with a specific word in the URL.
+  - Example: `inurl:Johnny`