Switch to docusaurus

hufilter · Jul 13, 2024 · e37d83f · e37d83f
1 parent 4f8fd9c
commit e37d83f
Show file tree

Hide file tree

Showing 64 changed files with 10,466 additions and 3,285 deletions.
diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
@@ -1,14 +1,12 @@
 name: Deploy to GitHub Pages
 
+env:
+  NODE_VERSION: 20
+
 on:
-  # Trigger the workflow every time you push to the `main` branch
-  # Using a different branch name? Replace `main` with your branch’s name
   push:
     branches: [ main ]
-  # Allows you to run this workflow manually from the Actions tab on GitHub.
-  workflow_dispatch:
 
-# Allow this job to clone the repo and create a page deployment
 permissions:
   contents: read
   pages: write
@@ -18,14 +16,28 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout your repository using git
+      - name: Check out to repository
         uses: actions/checkout@v4
-      - name: Install, build, and upload your site
-        uses: withastro/action@v2
-        # with:
-          # path: . # The root location of your Astro project inside the repository. (optional)
-          # node-version: 20 # The specific version of Node that should be used to build your site. Defaults to 20. (optional)
-          # package-manager: pnpm@latest # The Node package manager that should be used to install dependencies and build your site. Automatically detected based on your lockfile. (optional)
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build the project
+        run: pnpm build
+
+      - name: Make an artifact named github-pages from build
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: build
 
   deploy:
     needs: build

diff --git a/.gitignore b/.gitignore
@@ -1,24 +1,20 @@
-# build output
-dist/
+# Dependencies
+/node_modules
 
-# generated types
-.astro/
+# Production
+/build
 
-# dependencies
-node_modules/
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
 
-# logs
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
-pnpm-debug.log*
-
-# environment variables
-.env
-.env.production
-
-# macOS-specific files
-.DS_Store
-
-# jetbrains setting folder
-.idea/
diff --git a/.vscode/extensions.json b/.vscode/extensions.json
diff --git a/.vscode/launch.json b/.vscode/launch.json
diff --git a/README.md b/README.md
@@ -1,42 +1,41 @@
-# Hufilter website
+# Website
 
-## 🚀 Project Structure
+This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
 
-Inside of your Astro project, you'll see the following folders and files:
+### Installation
 
-```text
-/
-├── public/
-│   └── favicon.svg
-├── src/
-│   ├── components/
-│   │   └── Card.astro
-│   ├── layouts/
-│   │   └── Layout.astro
-│   └── pages/
-│       └── index.astro
-└── package.json
 ```
+$ pnpm i
+```
+
+### Local Development
 
-Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name.
+```
+$ pnpm start
+```
 
-There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components.
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
 
-Any static assets, like images, can be placed in the `public/` directory.
+### Build
+
+```
+$ pnpm build
+```
 
-## 🧞 Commands
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
 
-All commands are run from the root of the project, from a terminal:
+### Deployment
 
-| Command                    | Action                                           |
-| :------------------------- | :----------------------------------------------- |
-| `pnpm install`             | Installs dependencies                            |
-| `pnpm run dev`             | Starts local dev server at `localhost:4321`      |
-| `pnpm run build`           | Build your production site to `./dist/`          |
-| `pnpm run preview`         | Preview your build locally, before deploying     |
-| `pnpm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
-| `pnpm run astro -- --help` | Get help using the Astro CLI                     |
+Using SSH:
 
-## 👀 Want to learn more?
+```
+$ USE_SSH=true pnpm deploy
+```
+
+Not using SSH:
+
+```
+$ GIT_USER=<Your GitHub username> pnpm deploy
+```
 
-Feel free to check [our documentation](https://docs.astro.build) or jump into our [Discord server](https://astro.build/chat).
+If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
diff --git a/astro.config.mjs b/astro.config.mjs
diff --git a/babel.config.js b/babel.config.js
@@ -0,0 +1,3 @@
+module.exports = {
+  presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
+};
diff --git a/blog/2024-07-13-first-blog-post.mdx b/blog/2024-07-13-first-blog-post.mdx
@@ -0,0 +1,20 @@
+---
+slug: elindult-a-hufilter-hu
+title: Elindult a hufilter.hu!
+authors: [scripthunter7]
+tags: [news]
+---
+
+Kedves Felhasználóink!
+
+Örömmel jelentjük be, hogy elindult a hufilter.hu!
+
+Ezen az oldalon a hufilterrel, illetve a reklámblokkolókkal kapcsolatos tudnivalókat, tippeket, trükköket, 
+és egyéb hasznos információkat találhattok.
+
+A weboldal folyamatosan bővülni fog, így érdemes lesz visszatérni időről időre.
+
+Köszönjük, hogy velünk tartotok!
+
+Üdvözlettel,
+A hufilter csapata
diff --git a/blog/authors.yml b/blog/authors.yml
@@ -0,0 +1,5 @@
+scripthunter7:
+  name: scripthunter7
+  title: Hufilter Maintainer
+  url: https://github.com/scripthunter7
+  image_url: https://github.com/scripthunter7.png
diff --git a/blog/tags.yml b/blog/tags.yml
@@ -0,0 +1,4 @@
+news:
+  label: News
+  permalink: /news
+  description: News about the project
diff --git a/docs/adblockers/_category_.json b/docs/adblockers/_category_.json
@@ -0,0 +1,8 @@
+{
+  "label": "Reklámblokkoló gyorstalpaló",
+  "position": 3,
+  "link": {
+    "type": "doc",
+    "id": "adblockers/index"
+  }
+}
diff --git a/docs/adblockers/about-adblockers.mdx b/docs/adblockers/about-adblockers.mdx
@@ -0,0 +1,22 @@
+---
+sidebar_position: 1
+---
+
+# Mik azok a reklámblokkolók?
+
+A reklámblokkolók olyan szűrőprogramok, amelyek a szűrőlistákban található szabályok alapján blokkolnak, módosítanak
+vagy eltávolítanak bizonyos tartalmi elemeket a weboldalakról. Általában eltávolítják a reklámokat, cookie értesítőket,
+nyomkövetőket, elemző szkripteket, és egyéb zavaró elemeket, amelyek a böngészési élményt ronthatják vagy a
+felhasználók privát szféráját sértik.
+Ezáltal nemcsak javítják a böngészési élményt, de növelik a biztonságot is.
+
+:::caution
+
+**Ha reklámblokkolót használsz, akkor érdemes tisztában lenned azzal, hogy a felkeresett webhelyek tulajdonosainak
+ez bevételkiesést okozhat.
+A hirdetők a reklámok letöltése után fizetnek az oldal tulajdonosának, de ha ez a szám drasztikusan lecsökken,
+akkor az oldal bevétel nélkül marad, és akár tönkre is mehet.**
+Ha értékesnek tartod az oldal által kínált tartalmat, akkor fontold meg, hogy kikapcsolod a reklámblokkolót az oldalon,
+vagy támogatod az üzemeltetőt más módon.
+
+:::
diff --git a/docs/adblockers/adblocker-categories/_category_.json b/docs/adblockers/adblocker-categories/_category_.json
@@ -0,0 +1,7 @@
+{
+  "position": 2,
+  "link": {
+    "type": "doc",
+    "id": "adblockers/adblocker-categories/index"
+  }
+}
diff --git a/docs/adblockers/adblocker-categories/browser-extension.mdx b/docs/adblockers/adblocker-categories/browser-extension.mdx
@@ -0,0 +1,80 @@
+---
+sidebar_position: 2
+---
+
+import {
+  ChromiumLogo,
+  FirefoxLogo,
+  AdGuardLogo,
+  UBlockOriginLogo,
+  AdBlockUltimateLogo,
+  AdblockPlusLogo,
+  AdBlockLogo,
+  FbContainerLogo,
+  BraveLogo,  
+} from "@site/src/components/LogoProvider"
+
+# Böngészőbővítmények
+
+A szűrés a böngészőn belül történik, és csak az adott böngészőben érvényes. Ezek a megoldások ingyenesek, megbízhatóan
+működnek, azonban függnek a böngészőtől, ezért ki vannak szolgáltatva annak a vállalatnak, amelyik az adott böngészőt
+fejleszti.
+Ez elsősorban a Google Chrome esetében probléma, hiszen a Manifest V3 alapjaiban fogja megváltoztatni a
+reklámblokkoló bővítmények működését 2024. júniusától
+([[forrás]](https://developer.chrome.com/blog/resuming-the-transition-to-mv3/#the-phase-out-timeline),
+[[forrás]](https://adguard.com/en/blog/chrome-manifest-v3-where-we-stand.html)).
+
+:::caution
+
+Ne használj több reklámblokkolót egyidejűleg (pl. AdGuard-ot uBlock-al)!
+A közhiedelemmel ellentétben nem adódik össze a hatásuk, hanem épp az ellenkezője történik:
+konfliktusba kerülhetnek egymással, ami bizonyos funkciók működését gátolhatja.
+Viszont nyugodtan kombinálhatsz egy hálózati szintű blokkolót (pl. AdGuard Home vagy Pi-hole) egy böngészőbeli
+blokkolóval (pl. AdGuard vagy uBlock Origin).
+
+:::
+
+Böngészőbővítmények listája (a teljesség igénye nélkül):
+
+<ul style={{ listStyleType: "none" }}>
+  <li><ChromiumLogo /> Chromium alapú böngészőkhöz (Google Chrome, Edge, Opera, Brave, stb.):</li>
+  <ul style={{ listStyleType: "none" }}>
+    <li><AdGuardLogo /> [AdGuard](https://chrome.google.com/webstore/detail/adguard-adblocker/bgnkhhnnamicmpeenaelnjfhikgbkllg?hl=hu)</li>
+    <li><UBlockOriginLogo /> [uBlock Origin](https://chrome.google.com/webstore/detail/ublock-origin/cjpalhdlnbpafiamejdnhcphjbkeiagm?hl=hu)</li>
+    <li><AdBlockUltimateLogo /> [AdBlocker Ultimate](https://chrome.google.com/webstore/detail/adblocker-ultimate/ohahllgiabjaoigichmmfljhkcfikeof?hl=hu)</li>
+    <li><AdblockPlusLogo /> [Adblock Plus](https://chrome.google.com/webstore/detail/adblock-plus-free-ad-bloc/cfhdojbkjhnklbpkdaibdccddilifddb?hl=hu)</li>
+    <li><AdBlockLogo /> [AdBlock](https://chrome.google.com/webstore/detail/adblock-%E2%80%94-best-ad-blocker/gighmmpiobklfepjocnamgkkbiglidom?hl=hu)</li>
+  </ul>
+
+  <li><FirefoxLogo /> Firefoxhoz és Firefox alapú böngészőkhöz:</li>
+  <ul style={{ listStyleType: "none" }}>
+    <li><AdGuardLogo /> [AdGuard](https://addons.mozilla.org/hu/firefox/addon/adguard-adblocker/)</li>
+    <li><UBlockOriginLogo /> [uBlock Origin](https://addons.mozilla.org/hu/firefox/addon/ublock-origin/)</li>
+    <li><AdBlockUltimateLogo /> [AdBlocker Ultimate](https://addons.mozilla.org/hu/firefox/addon/adblocker-ultimate/)</li>
+    <li><AdblockPlusLogo /> [Adblock Plus](https://addons.mozilla.org/hu/firefox/addon/adblock-plus/)</li>
+    <li><AdBlockLogo /> [AdBlock](https://addons.mozilla.org/en-US/firefox/addon/adblock-for-firefox/)</li>
+    <li><FbContainerLogo /> [Facebook Container](https://addons.mozilla.org/hu/firefox/addon/facebook-container/) - a Mozilla által fejlesztett kiegészítő, amely elszigeteli a Facebookot a böngészőben, gátolva ezzel annak követési tevékenységét.</li>
+  </ul>
+</ul>
+
+:::tip
+
+Érdemes az alábbi böngészők valamelyikét használni, mivel tiszteletben tartják a felhasználók magánszféráját és
+a reklámblokkolást is teljes mértékben támogatják:
+
+<ul style={{ listStyleType: "none" }}>
+  <li><FirefoxLogo /> Firefox: https://www.mozilla.org/hu/</li>
+  <ul>
+    <li>A Firefox-os bővítményeket nem érinti a Manifest V3 változás, mivel ők továbbra is lehetővé teszik a
+      reklámblokkolók számára a korábbi működést.
+      [[forrás](https://adguard.com/en/blog/firefox-manifestv3-chrome-adblocking.html)]</li>
+  </ul>
+
+  <li><BraveLogo /> Brave: https://brave.com/</li>
+  <ul>
+    <li>A Brave gyárilag tartalmaz egy beépített reklámblokkolót, amire a Manifest V3 változás nem lesz hatással, mivel
+      nem egy kiegészítő, hanem a böngésző része.</li>
+  </ul>
+</ul>
+
+:::
diff --git a/docs/adblockers/adblocker-categories/index.mdx b/docs/adblockers/adblocker-categories/index.mdx
@@ -0,0 +1,20 @@
+# Reklámblokkolók típusai
+
+A reklámblokkolók többféle módon működhetnek, és különböző szinteken blokkolhatnak.
+Az alábbiakban bemutatjuk a leggyakoribb blokkolókategóriákat:
+
+```mdx-code-block
+import DocCardList from '@theme/DocCardList';
+
+<DocCardList />
+```
+
+:::caution
+
+Ne használj több reklámblokkolót egyidejűleg (pl. AdGuard-ot uBlock-al)!
+A közhiedelemmel ellentétben nem adódik össze a hatásuk, hanem épp az ellenkezője történik:
+konfliktusba kerülhetnek egymással, ami bizonyos funkciók működését gátolhatja.
+Viszont nyugodtan kombinálhatsz egy hálózati szintű blokkolót (pl. AdGuard Home vagy Pi-hole) egy böngészőbeli
+blokkolóval (pl. AdGuard vagy uBlock Origin).
+
+:::