From 9ffc796b9e862bd668895314405b4d07a9d7dc3e Mon Sep 17 00:00:00 2001 From: Mircas001 <79532341+Mircas001@users.noreply.github.com> Date: Thu, 10 Jul 2025 17:28:28 -0300 Subject: [PATCH 01/24] docs: Create folder and add layout for portuguese. --- astro.config.mjs | 1 + .../docs/pt/configuring/config_toml.md | 369 ++++++++++++++ src/content/docs/pt/configuring/hyprland.md | 109 ++++ src/content/docs/pt/configuring/overview.md | 12 + src/content/docs/pt/configuring/waybar.md | 481 ++++++++++++++++++ src/content/docs/pt/extensions/swayosd.mdx | 13 + src/content/docs/pt/features/cli.md | 157 ++++++ src/content/docs/pt/features/hyprpanel.md | 45 ++ .../docs/pt/getting-started/installation.md | 124 +++++ .../docs/pt/getting-started/introduction.md | 16 + src/content/docs/pt/getting-started/update.md | 52 ++ src/content/docs/pt/help/faq.md | 259 ++++++++++ src/content/docs/pt/help/nvidia.md | 111 ++++ src/content/docs/pt/index.mdx | 37 ++ src/content/docs/pt/man-pages/hyde-shell.mdx | 91 ++++ src/content/docs/pt/man-pages/overview.md | 8 + src/content/docs/pt/man-pages/theme.import.md | 62 +++ src/content/docs/pt/man-pages/waybar.py.md | 226 ++++++++ src/content/docs/pt/resources/.roadmap.md | 14 + src/content/docs/pt/resources/restore.md | 152 ++++++ src/content/docs/pt/resources/tools.md | 50 ++ src/content/docs/pt/theming/gallery.md | 129 +++++ .../docs/pt/theming/gen-gallery-table.py | 98 ++++ src/content/docs/pt/theming/making-themes.md | 282 ++++++++++ .../docs/pt/theming/wallbash-and-dcol.md | 101 ++++ 25 files changed, 2999 insertions(+) create mode 100644 src/content/docs/pt/configuring/config_toml.md create mode 100644 src/content/docs/pt/configuring/hyprland.md create mode 100644 src/content/docs/pt/configuring/overview.md create mode 100644 src/content/docs/pt/configuring/waybar.md create mode 100644 src/content/docs/pt/extensions/swayosd.mdx create mode 100644 src/content/docs/pt/features/cli.md create mode 100644 src/content/docs/pt/features/hyprpanel.md create mode 100644 src/content/docs/pt/getting-started/installation.md create mode 100644 src/content/docs/pt/getting-started/introduction.md create mode 100644 src/content/docs/pt/getting-started/update.md create mode 100644 src/content/docs/pt/help/faq.md create mode 100644 src/content/docs/pt/help/nvidia.md create mode 100644 src/content/docs/pt/index.mdx create mode 100644 src/content/docs/pt/man-pages/hyde-shell.mdx create mode 100644 src/content/docs/pt/man-pages/overview.md create mode 100644 src/content/docs/pt/man-pages/theme.import.md create mode 100644 src/content/docs/pt/man-pages/waybar.py.md create mode 100644 src/content/docs/pt/resources/.roadmap.md create mode 100644 src/content/docs/pt/resources/restore.md create mode 100644 src/content/docs/pt/resources/tools.md create mode 100644 src/content/docs/pt/theming/gallery.md create mode 100644 src/content/docs/pt/theming/gen-gallery-table.py create mode 100644 src/content/docs/pt/theming/making-themes.md create mode 100644 src/content/docs/pt/theming/wallbash-and-dcol.md diff --git a/astro.config.mjs b/astro.config.mjs index aecfba1..cb52b5b 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -22,6 +22,7 @@ export default defineConfig({ zh: { label: '简体中文', lang: 'zh' }, de: { label: 'Deutsch', lang: 'de' }, hi: { label: 'हिन्दी', lang: 'hi' }, + pt: { label: 'Português', lang: 'pt'}, }, social: [ { diff --git a/src/content/docs/pt/configuring/config_toml.md b/src/content/docs/pt/configuring/config_toml.md new file mode 100644 index 0000000..32e20e2 --- /dev/null +++ b/src/content/docs/pt/configuring/config_toml.md @@ -0,0 +1,369 @@ +--- +title: Main Configuration +description: HyDE's Configuration Guide +sidebar: + order: 2 +--- + + + + + +HyDE exposes `xdg_config/hyde/config.toml` file for users to modify. This lets users have the ability to interact the scripts without using command arguments. + +Users are encouraged to use an editor that support schema validation to ensure the configuration file is valid. +```toml +"$schema" = "https://raw.githubusercontent.com/HyDE-Project/HyDE/refs/heads/master/Configs/.local/share/hyde/schema/config.toml.json" +``` +--- +### [battery.notify] + +batterynotify.sh configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| dock | Dock status for battery notifications. | true | +| interval | Interval for battery notifications. | 5 | +| notify | Notification threshold. | 1140 | +| timer | Timer for battery notifications. | 120 | + +### [battery.notify.execute] + +Commands to execute for battery notifications. + +| Key | Description | Default | +| --- | ----------- | ------- | +| charging | Command to execute when charging. | | +| critical | Command to execute when battery is critical. | systemctl suspend | +| discharging | Command to execute when discharging. | | +| low | Command to execute when battery is low. | | +| unplug | Command to execute when unplugged. | | + +### [battery.notify.threshold] + +Thresholds for battery notifications. + +| Key | Description | Default | +| --- | ----------- | ------- | +| critical | Critical battery threshold. | 10 | +| full | Full battery threshold. | 90 | +| low | Low battery threshold. | 20 | +| unplug | Unplug battery threshold. | 100 | + +### [brightness] + +brightnesscontrol.sh configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| notify | Enable notifications for brightness control. | true | +| steps | Number of steps to increase/decrease brightness. | 5 | + +### [cava.hyprlock] + +'cava.sh hyprlock' configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| bar | Bar characters for cava. | ▁▂▃▄▅▆▇█ | +| max_instances | Maximum number of cava instances. | 1 | +| range | Number of bars minus one. | 7 | +| standby | Standby character for cava. | 🎶 | +| width | Width of the cava output. | 20 | + +### [cava.stdout] + +'cava.sh stdout' configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| bar | Bar characters for cava. | ▁▂▃▄▅▆▇█ | +| max_instances | Maximum number of cava instances. | 1 | +| range | Number of bars minus one. | 7 | +| standby | Standby character for cava. | 🎶 | +| width | Width of the cava output. | 20 | + +### [cava.waybar] + +'cava.sh waybar' configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| bar | Bar characters for cava. | ▁▂▃▄▅▆▇█ | +| max_instances | Maximum number of cava instances. | 1 | +| range | Number of bars minus one. | 7 | +| standby | Standby character for cava. | 🎶 | +| width | Width of the cava output. | 20 | + +### [hypr.config] + +Hypr configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| sanitize | List of regex to sanitize in the theme.config. | [".*rgba\(.*,.*,.*,.*\)"] | + +### [hyprland] + +Hyprland configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| background_path | LockScreen's Background path. | | +| bar | Bar. | waybar | +| browser | Browser. | firefox | +| button_layout | Button layout. (gtk only) | | +| color_scheme | Color scheme. | prefer-dark | +| cursor_size | Cursor size. | 24 | +| cursor_theme | Cursor theme. | Bibata-Modern-Ice | +| document_font_size | Document font size. | 10 | +| editor | Editor. | code | +| explorer | File manager. | dolphin | +| font | Font. | Canterell | +| font_antialiasing | Font antialiasing. | rgba | +| font_hinting | Font hinting. | full | +| font_size | Font size. | 10 | +| gtk_theme | GTK theme. | Wallbash-Gtk | +| icon_theme | Icon theme. | Tela-circle-dracula | +| idle | Idle manager. | hypridle | +| lockscreen | Lockscreen. | lockscreen.sh | +| monospace_font | Monospace font. | CaskaydiaCove Nerd Font Mono | +| monospace_font_size | Monospace font size. | 9 | +| quickapps | Quick apps. | kitty | +| terminal | Terminal. | kitty | + +### [hyprland_start] + +Hyprland start configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| apptray_bluetooth | Bluetooth applet. | blueman-applet | +| auth_dialogue | Authentication dialogue. | polkitkdeauth.sh | +| bar | Bar. | hyde-shell waybar --watch | +| battery_notify | Battery notification script. | batterynotify.sh | +| dbus_share_picker | DBus share picker. | dbus-update-activation-environment --systemd --all | +| idle_daemon | Idle daemon. | hypridle | +| image_clipboard | Image clipboard. | wl-paste --type image --watch cliphist store | +| network_manager | Network manager. | nm-applet --indicator | +| notifications | Notifications. | swaync | +| removable_media | Removable media manager. | udiskie --no-automount --smart-tray | +| systemd_share_picker | Systemd share picker. | systemctl --user import-environment QT_QPA_PLATFORMTHEME WAYLAND_DISPLAY XDG_CURRENT_DESKTOP | +| text_clipboard | Text clipboard. | wl-paste --type text --watch cliphist store | +| wallpaper | Wallpaper script. | $scrPath/wallpaper.sh --global | +| xdg_portal_reset | XDG portal reset script. | resetxdgportal.sh | + +### [mediaplayer] + +mediaplayer.py configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| artist_track_separator | Separator symbols to display between artist and track. |   | +| max_length | Max length of song and artist string. | 70 | +| prefix_paused | Prefix for paused media. |   | +| prefix_playing | Prefix for playing media. |  | +| standby_text | To display on standby. |  Music | + +### [notification] + +Notification script configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| font | Font for notifications. | mononoki Nerd Font | +| font_size | Font size for notifications. | 10 | + +### [rofi] + +Global rofi configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| scale | Rofi default scaling. | 10 | + +### [rofi.animation] + +'animation.sh select' configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| scale | Scaling for animation. | 10 | + +### [rofi.cliphist] + +cliphist.sh configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| scale | Scaling for cliphist. | 10 | + +### [rofi.emoji] + +emoji-picker.sh configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| scale | Scaling for emoji picker. | 10 | +| style | Style for emoji picker. | 1 | + +### [rofi.glyph] + +glyph-picker.sh configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| scale | Scaling for glyph picker. | 10 | + +### [rofi.hyprlock] + +'hyprlock.sh select' configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| scale | Scaling for hyprlock. | 10 | + +### [rofi.launch] + +rofilaunch.sh configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| drun_args | Additional arguments for drun mode. | [] | +| filebrowser_args | Additional arguments for filebrowser mode. | [] | +| run_args | Additional arguments for run mode. | [] | +| scale | Scaling for launch. | 5 | +| window_args | Additional arguments for window mode. | [] | + +### [rofi.theme] + +themeselect.sh configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| scale | Scaling for theme selector. | 6 | + +### [rofi.wallpaper] + +swwwallselect.sh configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| scale | Scaling for wallpaper. | 10 | + +### [rofi.keybind.hint] + +keybind_hint.sh configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| delimiter | Delimiter for keybind hints. | | +| height | Height for keybind hints. | 40em | +| line | Number of lines for keybind hints. | 16 | +| width | Width for keybind hints. | 40em | + +### [screenshot] + +screenshot.sh configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| annotation_post_command | Post command for annotation tool. | [""] | +| annotation_pre_command | Pre command for annotation tool. | [] | +| annotation_tool | Annotation tool for screenshots. | satty | + +### [sysmonitor] + +sysmonlaunch.sh configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| commands | Fallback command options. | [""] | +| execute | Default command to execute. | | + +### [volume] + +volumecontrol.sh configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| boost | Enable volume boost. | false | +| boost_limit | Volume boost limit. | 120 | +| notify | Enable notifications for volume control. | true | +| steps | Number of steps to increase/decrease volume. | 5 | + +### [wallbash] + +wallbash configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| skip_template | Templates to skip when using wallbash. | [""] | + +### [wallpaper] + +Wallpaper configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| backend | Wallpaper backend, requires 'wallpaper..sh' as handler script in $PATH | swww | +| custom_paths | List of paths to search for wallpapers. | [] | + +### [wallpaper.swww] + +swwwallselect.sh configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| duration | Transition duration. | 1 | +| framerate | Transition framerate. | 60 | +| transition_default | Transition type for default wallpaper. | grow | +| transition_next | Transition type for next wallpaper. | grow | +| transition_prev | Transition type for previous wallpaper. | outer | + +### [waybar] + +waybar configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| font | Font for waybar. | JetBrainsMono Nerd Font | +| icon_size | Icon size for waybar. | 10 | +| scale | Total scaling for waybar. | 10 | + +### [weather] + +Weather configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| forecast_days | Number of days to show forecast (0-3). | 3 | +| location | Location/coordinates string for the weather output. | | +| show_icon | Show the weather icon in waybar. | true | +| show_location | Show the location in waybar. | true | +| show_today | Show detailed description of today in tooltip. | true | +| temperature_unit | Temperature unit ('c' or 'f'). | c | +| time_format | Time format ('12h' or '24h'). | 24h | +| windspeed_unit | Windspeed unit ('km/h' or 'mph'). | km/h | + +### [wlogout] + +wlogout configuration. + +| Key | Description | Default | +| --- | ----------- | ------- | +| style | Style for wlogout. | 2 | + diff --git a/src/content/docs/pt/configuring/hyprland.md b/src/content/docs/pt/configuring/hyprland.md new file mode 100644 index 0000000..1f87f1e --- /dev/null +++ b/src/content/docs/pt/configuring/hyprland.md @@ -0,0 +1,109 @@ +--- +title: Hyprland +description: Hyprland related configuration +sidebar: + order: 3 +--- + + + +# Configuration Tree + +``` +. 📂 ~/.config/hypr +└── 📂 animations/ +├── 📄 animations.conf +├── 📄 hyde.conf +├── 📄 hypridle.conf +├── 📄 hyprland.conf +└── 📂 hyprlock/ +├── 📄 hyprlock.conf +├── 📄 keybindings.conf +├── 📄 monitors.conf +├── 📄 nvidia.conf +└── 📂 themes/ +│ ├── 📄 colors.conf +│ ├── 📄 theme.conf +│ ├── 📄 wallbash.conf +├── 📄 userprefs.conf +└── 📄 windowrules.conf +├── +. 📂 ~/.local/share/hyde +│ ├── 📄 hyprland.conf +``` + +--- + +:::caution + +**Read the [Hyprland Wiki](https://wiki.hyprland.org/) first!** + +::: + +# HyDE's Hyprland Configuration + +Since Hyprland sources `~/.config/hypr/hyprland.conf`, HyDE's hyprland configuration is divided into three sections: + +- [Boilerplate](#1-boilerplate) +- [Overrides](#2-overrides) +- [Users](#3-users) + +## 1. Boilerplate + +This section contains the default configuration of HyDE. It is recommended not to change this section. + +**Filepath:** `$XDG_DATA_HOME/hyde/hyprland.conf` + +This file is sourced on top of other configurations in `~/.config/hypr/hyprland.conf`. + +```ini +# Boilerplate configuration +source = ~/.local/share/hyde/hyprland.conf +``` + +## 2. Overrides + +This section is for overriding the default configuration of HyDE. + +:::caution + +The `xdg_config/hypr/hyde.conf` file is deprecated. Use `xdg_config/hyde/config.toml` instead. + +::: + +To override HyDE's default Hyprland settings, configure these sections in your `config.toml`: + +- **[hyprland]** - Application defaults, theming, and display settings +- **[hyprland_start]** - Startup commands and services + +**Configuration File:** `$XDG_STATE_HOME/hyde/hyprland.conf` + +For detailed options, see: +- [hyprland configuration](../config_toml/#hyprland) +- [hyprland_start configuration](../config_toml/#hyprland_start) + +## 3. Users + +This section is for user configuration. It is recommended to change this section to your liking. + +**Filepaths:** + +- `./keybindings.conf` +- `./windowrules.conf` +- `./monitors.conf` +- `./userprefs.conf` + +--- + +:::tip + +Likely you only need this files to configure your preferences. +Hyprland variables can be overridden, therefore you can change the default values to your liking. + +Also Hyprland can hot reload the configuration files, so you can edit them and see the changes immediately. + +::: + +Now you should know which file is which. Refer to the [Hyprland Wiki](https://wiki.hyprland.org) for more information and to achieve your perfect desktop experience. + +Also see [FAQs and Tips](../help/faq#how-can-i-change-keyboard-layout). diff --git a/src/content/docs/pt/configuring/overview.md b/src/content/docs/pt/configuring/overview.md new file mode 100644 index 0000000..5a62d21 --- /dev/null +++ b/src/content/docs/pt/configuring/overview.md @@ -0,0 +1,12 @@ +--- +title: Overview +description: HyDE's Configuration Guide +sidebar: + order: 1 +--- + +### HyDE's Configuration Guide + +As HyDE is not a full-fledge Desktop Environment, we tend to use various tools/apps to accomplish our task. + +In this panel we will talk about how we can configure the dotfiles the HyDE way. diff --git a/src/content/docs/pt/configuring/waybar.md b/src/content/docs/pt/configuring/waybar.md new file mode 100644 index 0000000..3bb81dc --- /dev/null +++ b/src/content/docs/pt/configuring/waybar.md @@ -0,0 +1,481 @@ +--- +title: Waybar +description: Waybar Configuration +--- + +## Configuration Tree + +```text +📂 ~/.config/waybar/ +├── 📂 layouts/ +├── 📂 menus/ +├── 📂 modules/ +├── 📂 styles/ +├── 📂 includes/ +├── 📄 config.jsonc +├── 📄 style.css +├── 📄 theme.css +└── 📄 user-style.css +``` + +- **config.jsonc** + - Copy of a layout configuration. See [layouts](#layouts). + - A transient file therefore edits must be saved at `~/.config/waybar/layouts/` +- **style.css** + - Auto-generated file. + - style.css imports 3 files: + - **Current** `styles/*.css` that matches the `layout.jsonc`. See [styles](#styles) + - **theme.css** generated by themes and this can override the selected style. + - **user-style.css** is an optional file where you can add your own overrides. You can also test your CSS in here. + +- **theme.css** + - Theme generated file. + +:::note +You should know that the `xdg_share/waybar` (~/.local/share/waybar) is a directory that is provided by HyDE. NEVER edit the files in this directory, as they will be overwritten on updates. You should instead edit your own `~/.config/waybar` directory! + +Take note that both have the same structure and I suggest you to copy the files from `xdg_share/waybar` to `~/.config/waybar` and edit them there. + +::: + +### Modules + +Directory: `./modules/` + +```text +└── 📂 modules/ + ├── 📄 backlight.jsonc + ├── 📄 clock.jsonc + ├── 📄 cpu.jsonc + ├── 📄 custom-cpuinfo.jsonc + ├── 📄 hyprland-language.jsonc + ├── 📄 idle_inhibitor.jsonc + ├── 📄 pulseaudio#microphone.jsonc + ├── 📄 pulseaudio.jsonc + ├── 📄 tray.jsonc + ├── 📄 wlr-taskbar#windows.jsonc + └── 📄 wlr-taskbar.jsonc +``` + +- Store all modules in `~/.config/waybar/modules/`. +- Files in here are recursively added as entry in `includes/includes.jsonc` +- All modules under a specific tree will have the `parent-child` convention. Example: `custom/cpuinfo` will be converted into `custom-cpuinfo`. This is used to easily determine the class name in CSS without confusion. + +Example: +```css +.custom-cpuinfo { + padding: 1em; +} +``` + +### Layouts + +Directory: `./layouts/` + +```text +└── 📂 layouts/ + ├── 📄 layout-1.jsonc + ├── 📄 layout-2.jsonc + ├── 📄 khing.jsonc + ├── 📄 macos.jsonc + └── 📄 ....jsonc +``` + +HyDE stores all the ready-to-use configurations in the `layouts/` directory. These can be navigated using the `waybar.py` script. + +:::note +If users accidentally configure `./waybar/config.jsonc`, it will be moved to `~/.config/waybar/layouts/backup/name_timestamp.jsonc`. Even with these measures, we encourage creating a copy of your configuration in `~/.config/waybar/layouts/`. +::: + +For CSS styling of the layouts see [styles](#styles). + +### Styles + +Directory: `./styles/` + +```text +└── 📂 styles/ + └── 📂 groups/ + ├── 📄 layout-1.css + ├── 📄 layout-2.css + ├── 📄 khing.css + ├── 📄 macos.css + └── 📄 ...*.css +``` + +The `styles/` directory contains the counterpart CSS files for layouts. +When choosing a layout, HyDE will try to use the equivalent CSS style by matching the base names e.g. `khing.jsonc` will use `khing.css`. + +Explicit `--config ` and `--style ` options are also supported. + +### Includes + +Directory: `./includes/` + +```text +└── 📂 includes/ + ├── 📄 includes.jsonc + ├── 📄 border-radius.css + └── 📄 global.css +``` + +- **border-radius.css** + - Dynamic border radius for the [groups](#groups). + +#### Dynamic Border-Radius Preview + +**No Rounding** in Hyprland + +![0 rounding in hyprland](../../../../assets/waybar/rounding-0.png) + +**Squircle** 10 rounding in Hyprland + +![10 rounding in hyprland](../../../../assets/waybar/rounding-10.png) + +**Circle** 100 rounding in Hyprland + +![100 rounding in hyprland](../../../../assets/waybar/rounding-100.png) + +**Get the Idea?** + +- **global.css** - Includes the dynamic font-size and font-family. This is dynamic so that themes can override these values via the `hypr.theme` >> `$BAR_FONT` + +### Menus + +Directory: `./menus/` + +Stores all the GTK Object XML files. To correctly manage the files we added the GObject XML files in `~/.config/waybar/menus/` + +## Group Class for Styling + +You should know that Waybar ONLY provides 3 positioning options for the modules: `modules-left`, `modules-center` and `modules-right`. To achieve the desired positioning or the popular pill effect, we need to use the `group` class. + +For example: +![Groups in pill shape](../../../../assets/waybar/groups.png) + +Contents of `../waybar/styles/groups/` are used for styling the border-radius of the given group. Groups are the combination of modules - some call them islands. + +In HyDE, to be able to make use of the groups, we can declare modules in a group first: + +Example in `~/.config/waybar/layouts/my_config.jsonc`: + +```jsonc +{ + "group/pill": { + "orientation": "inherit", + "modules": [ + "custom/gpuinfo", + "clock" + ] + } +} +``` + +Now we can add the group in the waybar modules: + +```jsonc +{ + "modules-center": [ + "group/pill", + "group/pill#tag1", + "group/pill-in" + ] +} +``` + +**Styling** this is easy as we already group the modules. In this way we can use the group name as the class name: + +```css +#pill, +#pill-in { + /* Your styles here */ +} +``` + +**Note:** `pill` and `pill#tag*` have a class name of `pill`. This is waybar convention to enable users to add a similar module but sharing common class name. + + +## Making your own waybar layout + +:::note + +This is a very shallow guide. You should follow the [waybar Wiki](https://github.com/Alexays/Waybar/wiki/Configuration) for more information. + +::: + + +### This is the full layout file used for the instructions + +
+ MyBar.jsonc + +```jsonc +{ + /* + ┌─────────────────────────────────────────────────────────────────────────────┐ + │ Global Options for the Waybar configuration │ + └─────────────────────────────────────────────────────────────────────────────┘ + */ + + "layer": "top", + "output": ["*"], + "position": "top", + "reload_style_on_change": true, + + /* + ┌────────────────────────────────────────────────────────────────────────────┐ + │ │ + │ This is one of the vital part of the configuration, it allows you to │ + │ include other │ + │ files │ + │ The `"$XDG_CONFIG_HOME/waybar/includes/includes.json"` is auto generated │ + │ by the waybar.py │ + │ script. │ + │ 1. Includes all the modules in `./waybar/modules` │ + │ 2. Resolves all the size for the icons that the style.css in waybar │ + │ CANNOT │ + │ handle │ + │ 3. Of course this is optional, you can remove it if you don't want to use │ + │ it and │ + │ include your own set of modules. │ + │ │ + └────────────────────────────────────────────────────────────────────────────┘ + */ + + "include": ["$XDG_CONFIG_HOME/waybar/includes/includes.json"], + + /* + ┌────────────────────────────────────────────────────────────────────────────┐ + │ Declare the modules inside your desired group shapes │ + │ As of now we have: │ + │ │ + │ - pill-left - the curve is facing left │ + │ - pill-right - the curve is facing right │ + │ - pill-up - the curve is facing up │ + │ - pill-down - the curve is facing down │ + │ - pill-in - the curve is facing inwards no matter the position │ + │ - pill-out - the curve is facing outwards no matter the position │ + │ - leaf - a leaf shape │ + │ - leaf-inverse - a leaf shape but inverted │ + │ │ + └────────────────────────────────────────────────────────────────────────────┘ + */ + + "group/pill-left": { + "orientation": "inherit", + "modules": ["custom/keybindhint", "custom/updates"] + }, + "group/pill-right": { + "orientation": "inherit", + "modules": ["battery", "custom/hyde-menu"] + }, + "group/pill-up": { + "orientation": "inherit", + "modules": ["wlr/taskbar"] + }, + "group/pill-down": { + "orientation": "inherit", + "modules": ["hyprland/workspaces"] + }, + "group/pill-in": { + "orientation": "inherit", + "modules": ["idle_inhibitor", "clock"] + }, + "group/pill-out": { + "orientation": "inherit", + "modules": ["custom/weather", "hyprland/language"] + }, + "group/leaf": { + "orientation": "inherit", + "modules": ["custom/workflows", "memory"] + }, + "group/leaf-inverse": { + "orientation": "inherit", + "modules": ["custom/gpuinfo", "custom/cpuinfo"] + }, + + /* + ┌─────────────────────────────────────────────────────────────────────────┐ + │ Re-using a group is simple, You just need to add a #tag to the group │ + │ name. │ + └─────────────────────────────────────────────────────────────────────────┘ + */ + + "group/pill-down#right": { + "orientation": "inherit", + "modules": ["pulseaudio", "pulseaudio#microphone", "tray"] + }, + "group/pill-up#right": { + "orientation": "inherit", + "modules": ["privacy", "custom/hyprsunset", "backlight#intel_backlight"] + }, + + /* + ┌────────────────────────────────────────────────────────────────────────────┐ + │ │ + │ Declare the groups in the module position provided by waybar │ + │ │ + └────────────────────────────────────────────────────────────────────────────┘ + */ + "modules-left": ["group/pill-left", "group/pill-down", "group/pill-up"], + "modules-center": ["group/leaf", "group/pill-in", "group/leaf-inverse"], + "modules-right": [ + "group/pill-up#right", + "group/pill-down#right", + "group/pill-right" + ] +} + +``` + +
+ + +### Step-by-Step Guide + +#### Step 1: Create Your Configuration File + +Start by creating a new file `~/.config/waybar/layouts/my_config.jsonc` or copy one of the existing ones from `~/.local/share/waybar/layouts/`. + +```bash +cp ~/.local/share/waybar/layouts/layout-1.jsonc ~/.config/waybar/layouts/my_config.jsonc +``` + +#### Step 2: Add Global Configuration Options + +Begin with the essential global configurations that define the basic behavior of your waybar: + +```jsonc +{ + "layer": "top", // Position layer: "top" or "bottom" + "output": ["*"], // Apply to all monitors (* means all outputs) + "position": "top", // Bar position: top, bottom, left, right + "reload_style_on_change": true, // Auto-reload when style file changes +``` + +#### Step 3: Include HyDE Module Definitions + +Add the include directive to automatically load all HyDE modules and configurations: + +```jsonc + "include": ["$XDG_CONFIG_HOME/waybar/includes/includes.json"], +``` + +:::tip +The `includes.json` file is auto-generated by HyDE's `waybar.py` script and provides: +- All modules from `./waybar/modules/` +- Icon size configurations that CSS cannot handle +- Dynamic configurations specific to HyDE +::: + +#### Step 4: Define Group Shapes + +HyDE provides several predefined group shapes for creating pill effects and custom layouts. Define your groups before assigning modules: + +```jsonc + // Available group shapes: + // pill-left, pill-right, pill-up, pill-down + // pill-in, pill-out, leaf, leaf-inverse + + "group/pill-left": { + "orientation": "inherit", + "modules": ["custom/keybindhint", "custom/updates"] + }, + "group/pill-right": { + "orientation": "inherit", + "modules": ["battery", "custom/hyde-menu"] + }, + "group/pill-up": { + "orientation": "inherit", + "modules": ["wlr/taskbar"] + }, + "group/pill-down": { + "orientation": "inherit", + "modules": ["hyprland/workspaces"] + }, + "group/pill-in": { + "orientation": "inherit", + "modules": ["idle_inhibitor", "clock"] + }, + "group/pill-out": { + "orientation": "inherit", + "modules": ["custom/weather", "hyprland/language"] + }, + "group/leaf": { + "orientation": "inherit", + "modules": ["custom/workflows", "memory"] + }, + "group/leaf-inverse": { + "orientation": "inherit", + "modules": ["custom/gpuinfo", "custom/cpuinfo"] + }, +``` + +#### Step 5: Reuse Groups with Tags + +You can reuse the same group shape multiple times by adding tags (`#tagname`): + +```jsonc + "group/pill-down#right": { + "orientation": "inherit", + "modules": ["pulseaudio", "pulseaudio#microphone", "tray"] + }, + "group/pill-up#right": { + "orientation": "inherit", + "modules": ["privacy", "custom/hyprsunset", "backlight#intel_backlight"] + }, +``` + +#### Step 6: Arrange Groups in Module Positions + +Finally, assign your groups to the three available positions: + +```jsonc + "modules-left": ["group/pill-left", "group/pill-down", "group/pill-up"], + "modules-center": ["group/leaf", "group/pill-in", "group/leaf-inverse"], + "modules-right": [ + "group/pill-up#right", + "group/pill-down#right", + "group/pill-right" + ] +} +``` + +#### Step 7: Apply Your Configuration + +To use your new layout, run: + +```bash +# Navigate to your layouts using rofi +waybar.py -S + +# Or apply directly +waybar -c ~/.config/waybar/layouts/my_config.jsonc +``` +![alt text](/src/assets/waybar/selector.png) + +:::note +See ./waybar.py --help for more options. +::: + +### Available Group Shapes + +| Shape | Description | +|-------|-------------| +| `pill-left` | Curve facing left | +| `pill-right` | Curve facing right | +| `pill-up` | Curve facing up | +| `pill-down` | Curve facing down | +| `pill-in` | Curve facing inwards regardless of position | +| `pill-out` | Curve facing outwards regardless of position | +| `leaf` | Leaf shape | +| `leaf-inverse` | Inverted leaf shape | + + +### Customizing Module Content + +To customize individual modules, edit the files in `~/.config/waybar/modules/` or create new ones following the naming convention described in the [Modules](#modules) section. + + + + diff --git a/src/content/docs/pt/extensions/swayosd.mdx b/src/content/docs/pt/extensions/swayosd.mdx new file mode 100644 index 0000000..14a7bfa --- /dev/null +++ b/src/content/docs/pt/extensions/swayosd.mdx @@ -0,0 +1,13 @@ +--- +title: swayosd +description: A GTK based on screen display for keyboard shortcuts like caps-lock and volume +--- + +SwayOSD is already supported by HyDE. You just need to manually add the daemon for it to work. + +### Quick setup + +```bash + exec-once = swayosd-server # enable swayosd service + exec-once = $(pkexec swayosd-libinput-backend) # swayosd service for keyboard input (requires to be run in a subshell) +``` diff --git a/src/content/docs/pt/features/cli.md b/src/content/docs/pt/features/cli.md new file mode 100644 index 0000000..5b16aad --- /dev/null +++ b/src/content/docs/pt/features/cli.md @@ -0,0 +1,157 @@ +--- +title: HyDE CLI +description: Installation guide for HyDE-cli +--- + +
+
+ +![hyde_cli_banner](../../../../assets/hyde-cli.png) + + + +
+ +HyDE-cli is a CLI tool for [HyDE](https://github.com/prasanthrangan/hyprdots). +This repository contains scripts that, while may not be perfect, could provide a better way to manage your HyDE installation. +For example, we have a functional TUI restore tool that follows `restore_cfg.lst`, power-saving options that could be useful for laptops, and much more! + +
+ +> 🚨 While HyDE-cli is stable, it is important to note that these scripts do alter and _could_ potentially mess up your system configuration. +> We ask that you use this tool carefully and report any bugs you find. + +## Installation + +To install, execute the following command: + +```sh +curl -sL https://raw.githubusercontent.com/HyDE-Project/Hyde-cli/master/install.sh | bash +``` + +> 📢 For User who do not have root access: +> `export HYDE_LOCAL=1` to install this package locally + +For other working install solutions, see the following below. + +### Arch Linux + +Use your preferred AUR helper `paru` or `yay`: + +```sh +paru -Sy hyde-cli-git +``` + +```sh +yay -Sy hyde-cli-git +``` + +Use makepkg: + +```sh +git clone https://aur.archlinux.org/hyde-cli-git.git +cd ./hyde-cli +makepkg -si +``` + +### Make + +Install required dependencies: `git make fzf tree ttf-jetbrains-mono-nerd`. + +Clone: + +```sh +git clone https://github.com/HyDE-Project/Hyde-cli +cd ./Hyde-cli +``` + +To install: + +```sh +make +``` + +To uninstall: + +```sh +make uninstall +``` + +To update: + +```sh +make update clean install +``` + +> 📢 User who do not have root access should provide this flag for `make`; `make LOCAL=1` + +> ⚠️ If you have previously installed HyDE without using the CLI, you can still use the CLI to manage your installation. +> To do this, combine the --dir and --link flags where the local cloned repository is located. +> +> For example: +> +> ```sh +> Hyde-install --dir /path/to/cloned/hyde --link +> ``` + +#### Installation Instructions for HyDE with Hyde-install + +> 📢 To achieve the best experience, it is encouraged you perform a fresh install of HyDE. + +1. **Basic Installation** + +- To install HyDE with the defaults, simply run the following command: + + ```sh + Hyde-install + ``` + +> ⚠️ _Already have HyDE before you discover this CLI?_ +> Simply run this command +> `Hyde-install --link --dir ~/HyDE` +> Note that the `~/HydE` is the path to the clone directory. +> See **Advanced Installation** below for more info. + +2. **Advanced Installation** + +- For more control over the installation process, you can use the following options: + + - **Specify Local Directory**: To clone HyDE into a specific local directory and run the installation, use the `-d` or `--dir` flag followed by the path of the directory. + + ```sh + Hyde-install --dir /path/to/directory + ``` + + - **Specify Remote Git Repository**: To clone HyDE from a specific remote git repository, use the `-g` or `--git` flag followed by the URL of the repository. + + ```sh + Hyde-install --git https://host/owner/repository + ``` + + - **Link Local Git Repository**: To link a local git repository, use the `-l` or `--link` flag. + + ```sh + Hyde-install --link + ``` + +3. **Sync changes** + +- If you want to get the latest changes from the `hyprdots/HyDE` repo and apply to your local install + + ```sh + Hyde update + Hyde restore Config + ``` + +> ⚠️ If you have previously installed HyDE without using the CLI, you can still use the CLI to manage your installation. +> To do this, combine the --dir and --link flags where the local cloned repository is located. +> +> For example: +> +> ```sh +> Hyde-install --dir /path/to/cloned/hyde --link +> ``` diff --git a/src/content/docs/pt/features/hyprpanel.md b/src/content/docs/pt/features/hyprpanel.md new file mode 100644 index 0000000..3b2b47c --- /dev/null +++ b/src/content/docs/pt/features/hyprpanel.md @@ -0,0 +1,45 @@ +--- +title: HyprPanel +description: HyprPanel wallbash template +--- + +![241005_14h24m09s_screenshot](https://github.com/user-attachments/assets/355aa7f0-856b-47f6-8ced-58bc0c4a3481) +![241005_14h26m11s_screenshot](https://github.com/user-attachments/assets/e7551bec-573c-4d37-91b9-de9400176cac) +![241005_14h19m51s_screenshot](https://github.com/user-attachments/assets/11f40837-08fe-4979-b16e-b1d0a6fd4fcd) + + +### Wallbash Template for HyprPanel + +This template is designed for use with HyprPanel. For more information, visit [HyprPanel](https://hyprpanel.com/). + +> **NOTE:** This is not a standalone package. Ensure you have HyDe installed and a working HyprPanel setup. + +## Usage + +Add the file [/hyprpanel.dcol](https://github.com/HyDE-Project/HyprPanel/blob/3f20c8922d7c3547688a2b16eb74846170a9f224/hyprpanel.dcol) to either `~/.config/hyde/wallbash/Wall-Ways` or `~/.config/hyde/wallbash/Wall-Dcol`. + +### Difference Between Wall-Ways and Wall-Dcol + +- **Wall-Ways**: This file is always used regardless of the theme mode or wallbash mode. +- **Wall-Dcol**: This file attempts to find the theme template (if in theme mode) and falls back to using the dominant color of the wallpapers if no template is available. + +### Using This Template for Themes + +1. **Header Line**: + ```sh + ${cacheDir}/landing/hyprpanel_wallbash.json | ags -r "useTheme('${cacheDir}/landing/hyprpanel_wallbash.json')" + ``` + This command sets the theme using the cached wallbash-generated `.json` file. + `$cacheDir` is the path to `~/.cache/hyde/`. + +2. **Wallbash Generation**: + ```sh + ${cacheDir}/landing/hyprpanel_wallbash.json + ``` + This command generates the wallbash `.json` file. + +3. **Optional Command**: + ```sh + ags -r "useTheme('${cacheDir}/landing/hyprpanel_wallbash.json')" + ``` + This command uses the cached wallbash-generated `.json` file to set the theme. diff --git a/src/content/docs/pt/getting-started/installation.md b/src/content/docs/pt/getting-started/installation.md new file mode 100644 index 0000000..02ce37b --- /dev/null +++ b/src/content/docs/pt/getting-started/installation.md @@ -0,0 +1,124 @@ +--- +title: Installation +description: HyDE Installation guide +--- + +The installation script is designed for a minimal [Arch Linux](https://wiki.archlinux.org/title/Arch_Linux) install, but **may** work on some [Arch-based distros](https://wiki.archlinux.org/title/Arch-based_distributions). +While installing HyDE alongside another [DE](https://wiki.archlinux.org/title/Desktop_environment)/[WM](https://wiki.archlinux.org/title/Window_manager) should work, due to it being a heavily customized setup, it **will** conflict with your [GTK](https://wiki.archlinux.org/title/GTK)/[Qt](https://wiki.archlinux.org/title/Qt) theming, [Shell](https://wiki.archlinux.org/title/Command-line_shell), [SDDM](https://wiki.archlinux.org/title/SDDM), [GRUB](https://wiki.archlinux.org/title/GRUB), etc. and is at your own risk. + +For Nixos support there is a separate project being maintained @ [Hydenix](https://github.com/richen604/hydenix/tree/main) + +:::note + +The install script will auto-detect an NVIDIA card and install nvidia-dkms drivers for your kernel. +Please ensure that your NVIDIA card supports dkms drivers in the list provided [here](https://wiki.archlinux.org/title/NVIDIA). +::: + +:::danger + +The script modifies your `grub` or `systemd-boot` config to enable NVIDIA DRM. + +::: + + + +### Automated installation script + +```shell +pacman -S --needed git base-devel +git clone --depth 1 https://github.com/HyDE-Project/HyDE ~/HyDE +cd ~/HyDE/Scripts +./install.sh +``` + +:::tip +You can also add any other apps you wish to install alongside HyDE to `Scripts/pkg_user.lst` and pass the file as a parameter to install it like so: + +```shell +./install.sh pkg_user.lst +``` + +::: + +:::note +Refer your list from `Scripts/pkg_extra.lst` +or you can `cp Scripts/pkg_extra.lst Scripts/pkg_user.lst` if you wish to install all extra packages. +::: + +### Granular and Manual Installation + +#### Clone + +Clone the repo and change the directory to the script path. Then make sure the user has [w]rite and e[x]ecute permission to the clone directory + +```shell +pacman -Sy git +git clone --depth 1 https://github.com/HyDE-Project/HyDE ~/HyDE +cd ~/HyDE/Scripts +``` + +:::caution +**NEVER** ever execute the script with sudo or as root user! +::: + +#### Modes + +The install script can be executed in different modes, + +- for default full hyprland installation with all configs + +```shell +./install.sh +``` + +- for full or minimal hyprland installation + your favorite packages (ex.`pkg_user.lst`) + +```shell +./install.sh pkg_user.lst # full install pkg_core.lst + pkg_user.lst with configs +./install.sh -i pkg_user.lst # minimal install pkg_core.lst + pkg_user.lst without configs +``` + +- each [section](#process) can also be independently executed as, + +```shell +./install.sh -i # minimal install hyprland without any configs +./install.sh -d # minimal install hyprland without any configs, but with (--noconfirm) install +./install.sh -r # just restores the config files +./install.sh -s # start and enable system services +./install.sh -t # test run without executing (-irst to dry run all) +./install.sh -m # skips the theme installation +./install.sh -n # skips nvidia installation +./install.sh -irst # to do a test run for all +``` + + diff --git a/src/content/docs/pt/getting-started/introduction.md b/src/content/docs/pt/getting-started/introduction.md new file mode 100644 index 0000000..eccf6cb --- /dev/null +++ b/src/content/docs/pt/getting-started/introduction.md @@ -0,0 +1,16 @@ +--- +title: Introduction +description: Get started with HyDE. +sidebar: + order: 1 +--- + +

+ +🚧🚧🚧 The HyDE project is currently a work in progress… +This documentation site is still under development, and we are actively working on improving it! + +Feel free to explore, provide feedback, and contribute to making this documentation as useful and comprehensive as possible. +Your help is invaluable in shaping HyDE and its resources. + +👉 Contribute to the project and documentation on GitHub: [HyDE-Project/hyde-site](https://github.com/HyDE-Project/hyde-site) diff --git a/src/content/docs/pt/getting-started/update.md b/src/content/docs/pt/getting-started/update.md new file mode 100644 index 0000000..c279b64 --- /dev/null +++ b/src/content/docs/pt/getting-started/update.md @@ -0,0 +1,52 @@ +--- +title: Updating +description: HyDE Dotfiles Management guide +--- + +## Automated + +To update HyDE, you will need to pull the latest changes from GitHub and restore the configs by running the following commands: + +```shell +cd ~/HyDE/Scripts +git pull origin master +./install.sh -r +``` + +:::note + +Any configurations you made will be overwritten if listed to be done so as listed by `Scripts/restore_cfg.psv`. +However, all replaced configs are backed up and may be recovered from in `~/.config/cfg_backups`. +See [Restore Configuration](/hyde/installation/restore/) for more information. + +::: + +## Granular and Manual Updates + +In addition to the command above, you can modify the [Scripts/restore_cfg.psv](https://github.com/HyDE-Project/HyDE/blob/master/Scripts/restore_cfg.psv). The documentation on is on the file. + +Also see [this](../../resources/restore/). + +### Updating the dotfiles ONLY + +:::note + +> "restore" in further context is restoring the dotfiles from the repository to your $HOME, not the other way around. + +```sh +./restore_cfg.sh +``` + +::: + +
+Something like this + +```sh +cd ~/HyDE/Scripts +./restore_cfg.sh ./restore_cfg.psv +``` + +
+ +--- diff --git a/src/content/docs/pt/help/faq.md b/src/content/docs/pt/help/faq.md new file mode 100644 index 0000000..99d77b1 --- /dev/null +++ b/src/content/docs/pt/help/faq.md @@ -0,0 +1,259 @@ +--- +title: FAQs & Tips +description: Frequently asked questions about HyDE +--- + + + +:::tip +Hyprland related questions should be referenced to [Hyprland Wiki](https://wiki.hyprland.org) +::: + +
+How do I add global or custom wallpapers? +
+ +#### Global wallpapers + +Global wallpapers will be shown in the selector across all themes. + +In your `xdg_config/hyde/config.toml` add this. + +```toml +[wallpaper] +custom_paths = [ + "$XDG_PICTURES_DIR", + "/path/to/pretty/wallpapers", +] # List of paths to search for wallpapers + +``` + +#### Custom wallpapers per theme + +##### Option 1: GUI + +Using dolphin to select a wallpaper/s for a theme + +![image](https://github.com/user-attachments/assets/a72458fc-da94-45e4-8dd4-dba48b910e82) + +1. Select image +2. Right Click and hover, "Set As Wallpaper" +3. Choose a destination theme + +##### Option 2: CLI + +Custom wallpapers are added per theme. + +1. Add a wallpaper in`~/.config/hyde/themes/Theme-Name/wallpapers/*`. +2. Then run`hyde-shell reload` + +
+
+ +
+How do I screen record? +
+ +You can screen record using the following wayland based recording packages. + +`wl-screenrec` + +`wf-recorder` + +`kooha ` + +`obs` + +
+
+ +
+How do I set my own preferences? +
+ +You can set your Hyprland preferences in `xdg_config/hypr/userprefs.conf`. These settings are retained even when updating the repository. + +See `Configuring` > `Hyprland` to learn how we structure Hyprland configurations. + +
+
+ +
+How do I update my dotfiles to the latest? +
+ +```sh +cd ~/HyDE/Scripts +git pull +./install.sh -r +``` + +See `Resources` > `Restore Configuration` on how it works + +
+
+ +
+How do I set my monitor resolution and refresh rate? +
+ +Read this for details: https://wiki.hyprland.org/Configuring/Monitors/ + +You can set the monitor resolution and refresh rate in `~/.config/hypr/monitors.conf` + +Ex: `monitor = DP-1,2560x1440@144,0x0, 1` >> The @ set's the refresh rate, but note that your monitor may not support all refresh rates. + +
+
+ +
+How do I remove the pokemon characters? +
+ +Uninstall pokego-bin. + +
+
+ +
+How do I change the terminal startup intro? +
+ +Edit `~/.config/zsh/user.zsh` + +
+
+ +
+How do I edit the sddm wallpaper or settings? +
+ +- Change Wallpaper + You need to manually run the script `~/.config/hypr/sddmwall.sh` on the wallpaper you want for the login screen, you can select the wallpaper from the themes and make sure it is the current swww wallpaper. +- Change SDDM settings + (colors, background, date format, font) can be configured in `/usr/share/sddm/themes/corners/theme.conf` + +if you want to modify the structure then you'll have to modify the qml files in /usr/share/sddm/themes/corners/components + +
+
+ +
+How can I change keyboard layout? +
+ +Read this for details: https://wiki.hyprland.org/Configuring/Variables/#input + +In HyDE we have the `~/.config/hypr/userprefs.conf` add the configuration in there. + +``` +input { + kb_layout = us,de +} +``` + +Use `SUPER` + `K` to switch between layouts. + +
+
+ +
+No thumbnails on selectors? +
+ +If your thumbnails are not loading, try to rebuild your wallpaper cache. + +`swwwallcache.sh` + +
+
+ +
+How do I edit the waybar? +
+ +You can create a custom waybar config by adding a custom file to ~/.config/waybar/layouts/.jsonc. It will then be selectable in the HyDE menu, or by running the script in the repo `HyDE/Scripts/waybar.py -S` + +Refer to the theming documentation in the [Waybar Wiki](https://github.com/Alexays/Waybar/wiki). + +
+
+ +
+How do I remove the blur on waybar? +
+ +You can remove the blur on waybar by removing blurls = waybar in the themes directory by commenting the line at the end of each `theme.conf` file. +Themes Directory: `~/.config/hypr/themes/` + +
+
+ +
+How do I launch the gamebar shown in the preview? +
+ +You'll need steam game or lutris library installed, and then run this: + +`~/.config/hypr/scripts/gamelauncher.sh ` # where n is style [1-4] + +
+
+ +
+How can I launch it on app launcher? +
+ +Find the .desktop entry using this handy command find /usr/share/applications -name '\*code.desktop' image +You should copy then edit the .desktop entry of each application to `~/.local/share/applications/` +Find the Exec = part then add the flags +image + +:::note +📢 Remember, if you're looking to edit or create a .desktop file, it's a good practice to place it in ~/.local/share/applications/ to avoid modifying >system-wide files. This ensures that your changes are user-specific and do not require administrative privileges +::: + +Here is the [wiki](https://wiki.archlinux.org/title/Desktop_entries) on how to deal with .desktop entries. + +
+
+ +
+Xwayland(👹) +
+ +Please refer to the [Hyprland Wiki](https://wiki.hyprland.org) for the explanation. + +[XWayland](https://wiki.hyprland.org/Configuring/XWayland/) +Note that if the application does not support Wayland, HyDE, Hyprland and Wayland itself don't have powers to magically fixed the issue! Do not report this as an issue, try to open questions on the [Discussion panel](https://github.com/HyDE-Project/Hyde-cli) for help. + +Known Issues + +- Few scaling issues with rofi configs, as they are created based on my ultrawide (21:9) display. +- Random lockscreen crash, refer https://github.com/swaywm/sway/issues/7046 +- Waybar launching rofi breaks mouse input (added sleep 0.1 as workaround), refer https://github.com/Alexays/Waybar/issues/1850 +- Flatpak QT apps do not follow system theme + +
+
+ +
+Login failed!" loop on SDDM? +
+ +If your user (or login name) contains capitalisation or special characters, you will need to edit your SDDM theme to be able to log in through the SDDM. + +To do this, follow these steps: + +1. When in the SDDM screen, open a tty with `Ctrl + Alt + F6` (or other F key) +2. Log in as the account with the issue +3. `nano usr/share/sddm/themes/[theme name]/theme.conf` +4. Find parameter `AllowBadUsername` and set it to true +5. Reboot + +If you still can't log in after these steps, you can set, on the same file, `AllowEmptyPassword` to true, reboot, log in still writing your password, and after logging in you can set it back to false safely. + +Here is a [GitHub Issue](https://github.com/HyDE-Project/HyDE/issues/404) about this behaviour. + +
+
diff --git a/src/content/docs/pt/help/nvidia.md b/src/content/docs/pt/help/nvidia.md new file mode 100644 index 0000000..8715e1b --- /dev/null +++ b/src/content/docs/pt/help/nvidia.md @@ -0,0 +1,111 @@ +--- +title: NVIDIA +description: For NVIDIA GPU users +--- + +HyDE's installation automates the installation of **NVIDIA drivers** and **nvidia-utils**. + +:::note +More information at: https://wiki.archlinux.org/title/NVIDIA + +::: + +This table shows what drivers will be added to your system based on the nvidia GPU you have. + + + +# Table of Contents + +- [nvidia-340xx-dkms](#nvidia-340xx-dkms) +- [nvidia-390xx-dkms](#nvidia-390xx-dkms) +- [nvidia-470xx-dkms](#nvidia-470xx-dkms) +- [nvidia-dkms](#nvidia-dkms) + + + + +## nvidia-340xx-dkms + +| NVE0 | NVE4 | GK104 | Description | +| ---- | ---- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| NV50 | NV50 | G80 | GeForce 8800 (GTS, GTX, Ultra), Quadro FX (4600 (SDI), 5600) | +| NV50 | NV84 | G84 | GeForce 8600 (GT, GTS, M GT, M GS), 8700M GT, GeForce 9500M GS, 9650M GS, Quadro FX (370, 570, 570M, 1600M, 1700), NVS 320M | +| NV50 | NV86 | G86 | GeForce 8300 GS, 8400 (GS, M G, M GS, M GT), 8500 GT, GeForce 9300M G, Quadro FX 360M, NVS (130M, 135M, 140M, 290) | +| NV50 | NV92 | G92 | GeForce 8800 (GT, GS, GTS 512, M GTS, M GTX), GeForce 9600 GSO, 9800 (GT, GTX, GTX+, GX2, M GT, M GTX), GeForce GTS 150(M), GTS 160M, GTS 240, GTS 250, GTX (260M, 280M, 285M), GT (330, 340), Quadro FX (2800M, 3600M, 3700, 3700M, 3800M, 4700 X2), VX 200 | +| NV50 | NV94 | G94 | GeForce 9600 (GSO 512, GT, S), 9700M GTS, 9800M GTS, GeForce G 110M, GT 130(M), GT 140, Quadro FX (1800, 2700M) | +| NV50 | NV96 | G96 | GeForce 9400 GT, 9500 (GT, M G), 9600 (M GS, M GT), 9650M GT, 9700M GT, GeForce G 102M, GT 120, Quadro FX (380, 580, 770M, 1700M) | +| NV50 | NV98 | G98 | GeForce 8400 GS, GeForce 9200M GS, 9300 (GE, GS, M GS), GeForce G 100, G 105M, Quadro FX (370 LP, 370M), NVS (150M, 160M, 295, 420, 450) | +| NV50 | NVA0 | GT200 | GeForce GTX (260, 275, 280, 285, 295), Quadro CX, FX (3800, 4800, 5800) | +| NV50 | NVA3 | GT215 | GeForce GT (240, 320, 335M), GTS (250M, 260M, 350M, 360M), Quadro FX 1800M | +| NV50 | NVA5 | GT216 | GeForce GT (220, 230M, 240M, 325M, 330M), 315, Quadro 400, FX 880M, NVS 5100M | +| NV50 | NVA8 | GT218 | GeForce 8400 GS, ION 2, GeForce 205, 210, G 210M, 305M, 310(M), 405, Quadro FX (380 LP, 380M), NVS (300, 2100M, 3100M) | +| NV50 | NVAA | MCP77 | GeForce 8100, 8200, 8300 mGPU | +| NV50 | NVAA | MCP78 | nForce 700a series, 8200M G | +| NV50 | NVAC | MCP79 | ION, GeForce 9300, 9400 mGPU | +| NV50 | NVAC | MCP7A | nForce 700i series, 8200M G, 9100M, 9400M (G) | +| NV50 | NVAF | MCP89 | GeForce 320M | + +## nvidia-390xx-dkms + +| NVE0 | NVE4 | GK104 | Description | +| ---- | ---- | ----- | ----------------------------------------------------------------------------------------------------------------------------- | +| NVC0 | NVC0 | GF100 | GeForce GTX (465, 470, 480, 480M), Quadro 4000, 5000[M] (??), 6000 | +| NVC0 | NVC1 | GF108 | GeForce GT (415M, 420, 420M, 425M, 430, 435M, 520M, 525M, 530, 540M, 550M, 555M, 620, 630M, 635M, 640M LE), Quadro 600, 1000M | +| NVC0 | NVC3 | GF106 | GeForce GT (440, 445M, 545, 555M, 630M, 635M), GTS 450, GTX 460M, Quadro 2000 (D), 2000M | +| NVC0 | NVC4 | GF104 | GeForce GTX (460, 460 SE, 470M, 485M), Quadro 5000M (??) | +| NVC0 | NVC8 | GF110 | GeForce GTX (560 Ti OEM, 570, 580, 590), Quadro 3000M, 4000M, 5010M | +| NVC0 | NVCE | GF114 | GeForce GTX (460 v2, 560, 560 Ti, 570M, 580M, 670M, 675M) | +| NVC0 | NVCF | GF116 | GeForce GTS 450 v2, GTX (550 Ti, 560M) | +| NVC0 | NVD7 | GF117 | Geforce GT 620M, 625M, (some) 630M, 710M, 720M | +| NVC0 | NVD9 | GF119 | GeForce 410M, 510 (?), GT (520, 520M, 520MX, 610), 610M, Quadro NVS 4200M | + +## nvidia-470xx-dkms + +| NVE0 | NVE4 | GK104 | Description | +| ---- | ----- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| NVE0 | NVE4 | GK104 | GeForce GTX (660 Ti, 670[M], 680[M], 690, 760, 760 Ti, 770, 775M, 780M, 860M), Quadro K3000[M], K3100M, K4000[M], K4100[M], K5000[M], K5100M, Tesla K10 | +| NVE0 | NVE7 | GK107 | GeForce GT (640[M], 645M, 650M, 710M, 720M, 730M, 740[M], 745M, 750M, 755M), GTX (650, 660M), Quadro 410, K500[M], K600, K1000[M], K1100M, K2000[M], NVS 510, 1000 | +| NVE0 | NVE6 | GK106 | GeForce GTX (645, 650 Ti, 660, 760M, 765M, 770M), Quadro K2100M, K4000 | +| NVE0 | NVF0 | GK110 | GeForce GTX 780, Titan, Tesla K20, Quadro K6000 | +| NVE0 | NVF1 | GK110B | GeForce GTX 780 Ti, Titan Z, Tesla K40 | +| NVE0 | NV106 | GK208B | GeForce GT 720 | +| NVE0 | NV108 | GK208 | GeForce GT 630, 635, 640, 710M, 720M, 730M, 735M, 740M, 920M, Quadro K510M, K610M | +| NVE0 | NVEA | GK20A | Tegra K1 | +| NVE0 | NV??? | GK210 | Tesla K80 | + +## nvidia-dkms + +| NVE0 | NVE4 | GK104 | Description | +| ----- | ----- | ----- | --------------------------------------------------------------------------------------------------------------------------- | +| NV110 | NV117 | GM107 | GeForce GTX (745, 750, 750 Ti, 840M, 845M, 850M, 860M, 950M, 960M) Quadro K620, K1200, K2200, M1000M, M1200M; GRID M30, M40 | +| NV110 | NV118 | GM108 | GeForce 830M, 840M, 930M, 940M[X] | +| NV110 | NV120 | GM200 | GeForce GTX Titan X | +| NV110 | NV124 | GM204 | GeForce GTX (970, 980) | +| NV110 | NV126 | GM206 | GeForce GTX (950, 960) | +| NV110 | NV12B | GM20B | Tegra X1 | +| NV130 | NV132 | GP102 | NVIDIA Titan (X, Xp), GeForce GTX 1080 Ti | +| NV130 | NV134 | GP104 | GeForce GTX (1070, 1080) | +| NV130 | NV136 | GP106 | GeForce GTX 1060 | +| NV130 | NV137 | GP107 | GeForce GTX (1050, 1050 Ti) | +| NV130 | NV138 | GP108 | GeForce GT 1030 | +| NV140 | NV140 | GV100 | NVIDIA Titan V, NVIDIA Quadro GV100 | +| NV160 | NV162 | TU102 | NVIDIA Titan RTX, GeForce RTX 2080 Ti | +| NV160 | NV164 | TU104 | GeForce RTX (2070 Super, 2080, 2080 Super) | +| NV160 | NV166 | TU106 | GeForce RTX (2060, 2060 Super, 2070) | +| NV160 | NV168 | TU116 | GeForce GTX (1650 Super, 1660, 1660 Ti, 1660 Super) | +| NV160 | NV167 | TU117 | GeForce GTX 1650 | +| NV170 | NV172 | GA102 | GeForce RTX (3080, 3090) | +| NV170 | NV174 | GA104 | GeForce RTX (3060 Ti, 3070, 3080 Mobile) | +| NV170 | NV176 | GA106 | GeForce RTX (3050, 3060) | +| NV170 | NV177 | GA107 | GeForce RTX 3050 | +| NV190 | NV192 | AD102 | GeForce RTX 4090 | +| NV190 | NV193 | AD103 | GeForce RTX 4080 | +| NV190 | NV194 | AD104 | GeForce RTX (4070, 4070 Ti) | +| NV190 | NV196 | AD106 | GeForce RTX 4060 Ti | +| NV190 | NV197 | AD107 | GeForce RTX 4060 | + + + +:::note + +::: diff --git a/src/content/docs/pt/index.mdx b/src/content/docs/pt/index.mdx new file mode 100644 index 0000000..b344ea1 --- /dev/null +++ b/src/content/docs/pt/index.mdx @@ -0,0 +1,37 @@ +--- +title: HyDE +description: HyDE your Development Environment - Aesthetic, dynamic and minimal dots for Arch hyprland! +template: splash +hero: + tagline: your Development Environment ✨ + image: + file: ../../../assets/hyde.svg + actions: + - text: Get Started with HyDE + link: /en/getting-started/introduction + icon: rocket + - text: Explore on GitHub + link: https://github.com/HyDE-Project + icon: github + variant: minimal +--- + +import { Card, CardGrid } from "@astrojs/starlight/components"; + +## Features + + + + Follows the XDG Base Directory Specification. + + + Core scripts are separated to user config. + + + More theming options. + + + One of the directions of this project is to be modular. + + + diff --git a/src/content/docs/pt/man-pages/hyde-shell.mdx b/src/content/docs/pt/man-pages/hyde-shell.mdx new file mode 100644 index 0000000..3ee867c --- /dev/null +++ b/src/content/docs/pt/man-pages/hyde-shell.mdx @@ -0,0 +1,91 @@ +--- +title: hyde-shell +description: HyDE's wrapper to execute HyDE scripts and executables. +sidebar: + order: 2 +--- + +## Name + +`hyde-shell` - HyDE script execution wrapper and environment resolver + +## Synopsis + +``` +hyde-shell [command] [arguments...] +hyde-shell [--help | help | -h] +hyde-shell [-r | reload] +``` + +## Description + +`hyde-shell` is a universal wrapper script that executes HyDE scripts without file extensions and solves PATH-related issues where users might accidentally overwrite `~/.local/lib/hyde` in their PATH. + +Located in `~/.local/bin/`, `hyde-shell` automatically discovers and executes scripts from the HyDE library directory, handling both Python scripts (.py) and shell scripts (.sh) without requiring file extensions. + +## Options + +**`--help, help, -h`** +: Display help message showing available commands and usage information. + +**`-r, reload`** +: Reload the HyDE environment and refresh all configurations. + +## Built-in Commands + +**`wallbash`** +: Execute a wallbash script for dynamic theming and color management. + +## Script Execution + +`hyde-shell` provides access to all HyDE scripts without requiring file extensions: + +```bash +hyde-shell waybar # Executes waybar.py +hyde-shell theme.import # Executes theme.import.py +hyde-shell wallpaper # Executes wallpaper.sh +hyde-shell screenrecord # Executes screenrecord.sh +``` + +The wrapper automatically discovers and resolves all scripts in the HyDE library directory. + +## Usage Examples + +Execute any HyDE script without file extension: +```bash +hyde-shell waybar --help # Run waybar.py with help flag +hyde-shell theme.import # Run theme.import.py +hyde-shell wallpaper # Run wallpaper.sh +``` + +Use built-in commands: +```bash +hyde-shell wallbash # Execute wallbash scripts in ~/.config/hyde/wallbash/scripts/ + +hyde-shell reload # Reload HyDE environment +``` + +Pass arguments to underlying scripts: +```bash +hyde-shell waybar --set layout-1 # Pass arguments to waybar.py +``` + +## Key Features + +- **Script Path Resolution**: Finds scripts in `~/.local/lib/hyde/` regardless of PATH configuration +- **Extension Handling**: Automatically appends appropriate file extensions (.py, .sh) +- **PATH Independence**: Works regardless of current PATH configuration or working directory + +## Files + +**`~/.local/bin/hyde-shell`** +: Main executable wrapper script + +**`~/.local/lib/hyde/`** +: Directory containing all HyDE scripts and modules + +## Notes + +- Always prefer `hyde-shell` over direct script execution for maximum compatibility +- File extensions are optional and automatically resolved +- Future HyDE versions will increasingly rely on `hyde-shell` for script execution diff --git a/src/content/docs/pt/man-pages/overview.md b/src/content/docs/pt/man-pages/overview.md new file mode 100644 index 0000000..c4fb0f9 --- /dev/null +++ b/src/content/docs/pt/man-pages/overview.md @@ -0,0 +1,8 @@ +--- +title: Overview +description: HyDE manuals for scripts and executable +sidebar: + order: 1 +--- + +HyDE manuals for scripts and executables. \ No newline at end of file diff --git a/src/content/docs/pt/man-pages/theme.import.md b/src/content/docs/pt/man-pages/theme.import.md new file mode 100644 index 0000000..2e562e1 --- /dev/null +++ b/src/content/docs/pt/man-pages/theme.import.md @@ -0,0 +1,62 @@ +--- +title: theme.import.py +description: theme import manual page +--- + +### Preview + +![preview theme import](../../../../assets/man-pages/theme.import/image.png) + +### NAME + +theme.import.py - Imports themes from the HyDE gallery repository + +### SYNOPSIS + +`theme.import.py` [OPTIONS] + +### DESCRIPTION + +`theme.import.py` is a script to import and manage themes from the HyDE gallery repository. It allows users to clone the repository, fetch theme data, preview themes, and apply selected themes. + +### OPTIONS + +- `-j`, `--json` + Fetch JSON data after cloning the repository. + +- `-S`, `--select` + Select themes using `fzf`. + +- `-p`, `--preview` IMAGE_URL + Get a preview of the specified theme. + +- `-t`, `--preview-text` TEXT + Preview text to display when using the `--preview` option. + +- `--skip-clone` + Skip cloning the repository. + +- `-f`, `--fetch` THEME + Fetch and update a specific theme by name. Use `all` to fetch all themes located in `xdg_config/hyde/themes`. + +### ENVIRONMENT VARIABLES + +- `LOG_LEVEL` + Set the logging level (default: `INFO`). + +- `XDG_CACHE_HOME` + Directory for cache files (default: `~/.cache`). + +- `XDG_CONFIG_HOME` + Directory for configuration files (default: `~/.config`). + +- `FULL_THEME_UPDATE` + Overwrites the archived files (useful for updates and changes in archives). + +### EXAMPLES + +Opens fzf menu and select themes. + +```shell +theme.import.py --select +``` diff --git a/src/content/docs/pt/man-pages/waybar.py.md b/src/content/docs/pt/man-pages/waybar.py.md new file mode 100644 index 0000000..4be1aee --- /dev/null +++ b/src/content/docs/pt/man-pages/waybar.py.md @@ -0,0 +1,226 @@ +--- +title: waybar.py +description: waybar.py manual page +--- + +## Name + +`waybar.py` - HyDE Waybar configuration management script + +## Synopsis + +``` +waybar.py [-h] [--set SET] [-n] [-p] [-u] [-g] [-i] [-b] [-G] + [-c CONFIG] [-s STYLE] [-w] [--json] [--select] [--kill] + [--hide [{0,1,toggle}]] +``` + +## Description + +`waybar.py` is a comprehensive Waybar configuration management script that is part of the HyDE, your Development Environment. + +The script manages Waybar configurations stored in `~/.config/waybar/layouts/` and their corresponding styles in `~/.config/waybar/styles/`. It automatically handles the generation of includes files, icon sizing, border radius updates, and provides seamless switching between different Waybar configurations. + +## Options + +### Layout Management + +**`--set SET`** +: Set a specific layout by name. The layout file should exist in `~/.config/waybar/layouts/` with a `.jsonc` extension. + +**`-n, --next`** +: Switch to the next available layout in alphabetical order. Cycles through all layouts in the layouts directory. + +**`-p, --prev`** +: Switch to the previous available layout in alphabetical order. Cycles through all layouts in the layouts directory. + +### Update Operations + +**`-u, --update`** +: Perform a complete update of all Waybar components including: + - Icon size configurations in JSON files + - Border radius in CSS files + - Includes.json file generation + - Configuration and style synchronization + +**`-g, --update-global-css`** +: Update only the global.css file. This file contains dynamic font-size and font-family configurations that can be overridden by themes via `hypr.theme` >> `$BAR_FONT`. + +**`-i, --update-icon-size`** +: Update icon size configurations in JSON files. This resolves icon sizing that cannot be handled directly by Waybar's CSS. + +**`-b, --update-border-radius`** +: Update border radius configurations in CSS files. This creates dynamic border radius for groups that adapts to Hyprland's corner rounding settings. + +**`-G, --generate-includes`** +: Generate the `includes.json` file. This file contains: + - All modules from `~/.config/waybar/modules/` + - Dynamic configurations that Waybar doesn't provide natively + - Icon size resolutions for proper styling + +### Configuration Paths + +**`-c CONFIG, --config CONFIG`** +: Specify the path to a source `config.jsonc` file. This allows using configurations outside the standard layouts directory. + +**`-s STYLE, --style STYLE`** +: Specify the path to a source `style.css` file. This allows using styles outside the standard styles directory. + +### Process Management + +**`-w, --watch`** +: Enable watch mode. Continuously monitor Waybar and automatically restart it if the process dies. Useful for maintaining a persistent Waybar instance. + +**`--kill, -k`** +: Kill all running Waybar instances and any associated watcher scripts. This provides a clean way to terminate all Waybar processes. + +**`--hide [{0,1,toggle}]`** +: Control Waybar visibility: + - `--hide 0` or `--hide show`: Show Waybar + - `--hide 1` or `--hide hide`: Hide Waybar + - `--hide` or `--hide toggle`: Toggle current visibility state + +### Information and Listing + +**`--json, -j`** +: List all available layouts in JSON format. Useful for scripting and integration with other tools. + +**`--select, -S`** +: Open an interactive rofi menu to select and switch between available layouts. This provides a visual interface for browsing and selecting from all layout configurations in `~/.config/waybar/layouts/`. + +**`-h, --help`** +: Display help message with all available options and exit. + +## Files + +**`~/.config/waybar/`** +: Main Waybar configuration directory for user customizations + +**`~/.config/waybar/layouts/`** +: Directory containing Waybar layout configuration files (`.jsonc` format) + +**`~/.config/waybar/styles/`** +: Directory containing CSS style files corresponding to layouts + +**`~/.config/waybar/modules/`** +: Directory containing individual module configurations + +**`~/.config/waybar/includes/`** +: Directory containing generated include files and dynamic configurations + +**`~/.config/waybar/includes/includes.json`** +: Auto-generated file containing all module definitions and dynamic configurations + +**`~/.config/waybar/config.jsonc`** +: Current active Waybar configuration (transient file, copy of selected layout) + +**`~/.config/waybar/style.css`** +: Current active Waybar style (auto-generated, imports multiple CSS files) + +**`~/.local/share/waybar/`** +: HyDE-provided Waybar configurations (read-only, do not edit) + +## Examples + +### Basic Layout Management + +Select a layout interactively: +```bash +waybar.py --select # Opens rofi layout selector +``` + +Switch to a specific layout: +```bash +waybar.py --set khing +``` + +Cycle through layouts: +```bash +waybar.py --next # Next layout +waybar.py --prev # Previous layout +``` + +### Configuration Updates + +Update all configurations: +```bash +waybar.py --update +``` + +Update specific components: +```bash +waybar.py --update-icon-size # Update icon sizes only +waybar.py --update-border-radius # Update border radius only +waybar.py --generate-includes # Regenerate includes.json +``` + +### Process Management + +Start Waybar with watch mode: +```bash +waybar.py --watch +``` + +Control Waybar visibility: +```bash +waybar.py --hide 1 # Hide Waybar +waybar.py --hide 0 # Show Waybar +waybar.py --hide toggle # Toggle visibility +``` + +Kill all `waybar.py` processes which effectively kill `--watch` mode: + +```bash +waybar.py --kill +``` + +### Information Gathering + +Interactive layout selection: +```bash +waybar.py --select # Opens rofi menu for layout selection +``` + +List available layouts: +```bash +waybar.py --json # JSON format for scripting +``` + +### Custom Configuration Paths + +Use custom configuration files: +```bash +waybar.py --config /path/to/custom-config.jsonc --style /path/to/custom-style.css +``` + +## Configuration Workflow + +1. **Browse and select layouts**: Use `waybar.py --select` to open an interactive rofi menu and preview available layouts + +2. **Create or copy a layout**: Start with an existing layout from `~/.local/share/waybar/layouts/` or create a new one in `~/.config/waybar/layouts/` + +3. **Generate includes**: Run `waybar.py --generate-includes` to ensure all modules are available + +4. **Set the layout**: Use `waybar.py --set ` to activate your configuration, or use the interactive selector with `waybar.py --select` + +5. **Update configurations**: Run `waybar.py --update` after making changes to ensure all components are synchronized + +## Integration with HyDE + +`waybar.py` is tightly integrated with the HyDE ecosystem: + +- **Theme Integration**: Automatically adapts to current HyDE theme settings +- **Dynamic Styling**: Updates border radius based on Hyprland window rounding +- **Font Management**: Synchronizes fonts with HyDE theme configurations +- **Module System**: Manages HyDE-specific Waybar modules and configurations + + +## Notes + +- Always use `~/.config/waybar/` for custom configurations, never edit files in `~/.local/share/waybar/` +- The `includes.json` file is auto-generated and should not be manually edited +- Layout names correspond to filenames without the `.jsonc` extension +- Style files should match layout names for automatic pairing (e.g., `khing.jsonc` uses `khing.css`) + + + diff --git a/src/content/docs/pt/resources/.roadmap.md b/src/content/docs/pt/resources/.roadmap.md new file mode 100644 index 0000000..270c13c --- /dev/null +++ b/src/content/docs/pt/resources/.roadmap.md @@ -0,0 +1,14 @@ +--- +title: Roadmap +description: Finished/Unfinished +--- + +This is the current unfinished and completed plans of the project: + +- [x] Interactive restore config following `restore_cfg.lst` +- [x] Interactive package installation following `custom_apps.lst` +- [x] Interactive theme selection +- [x] Shell swap selection +- [ ] Add interactive installation using fzf +- [ ] Separate TUI from CLI +- [ ] More to come... \ No newline at end of file diff --git a/src/content/docs/pt/resources/restore.md b/src/content/docs/pt/resources/restore.md new file mode 100644 index 0000000..0de9e47 --- /dev/null +++ b/src/content/docs/pt/resources/restore.md @@ -0,0 +1,152 @@ +--- +title: Restore Configuration +description: Restore script's logic +--- + +:::note + +"restore" in further context is restoring the dotfiles from the repository to your $HOME, not the other way around. + +```sh +./restore_cfg.sh +``` + +::: + +## Pipe Separated Values (PSV) + +This is a pipe-separated value file. It contains the paths of the dotfiles and their respective package dependencies. + +#### Note: + +- Lines starting with `#` are comments. +- The only known variable is `${HOME}`. +- This is a 4-column file separated by `|`. +- Each column should use spaces to separate array elements. + +#### Structure: + +```shell +flag|path|target|dependency +``` + +#### Flags: + +- **( P ) Populate/Preserved** + + - This flag ensures that the target is only copied if it does not already exist. It is useful for preserving the current state of the target, preventing any overwrites or modifications to existing files or directories. + +- **( S ) Sync** + + - If the target file(s) exist, overwrite them. + - If the target is a directory, only overwrite the files that are listed. + - Preserve other files in the target directory that are not listed. + - This behavior is similar to the `cp -r` command. + +- **( O ) Overwrite** + + - This flag performs an aggressive sync operation. It ensures that the target is completely replaced by the source. + - If the target is a directory, every file and subdirectory within it will be overwritten by the corresponding items from the source. + - If the target is a file, it will be entirely overwritten by the source file. + - This operation does not preserve any existing files or directories in the target location; everything is replaced. + - Useful for updating core configurations and scripts. + +- **( B ) Backup** + - Backup the target. + - All P, S, O flags will also backup the target file/directory. + +
+Sample PSV file + +```shell + Hyde core files  +P|${HOME}/.config/hyde|config.toml|hyprland +P|${HOME}/.config/hypr|hyde.conf animations.conf windowrules.conf keybindings.conf userprefs.conf monitors.conf|hyprland +P|${HOME}/.config/hypr|nvidia.conf|hyprland nvidia-utils +P|${HOME}/.config/hypr/themes|theme.conf wallbash.conf colors.conf|hyprland +P|${HOME}/.local/state|hyde|hyprland + +S|${HOME}/.config/hypr|hyprland.conf|hyprland +S|${HOME}/.local|bin|hyprland +S|${HOME}/.config|gtk-3.0|nwg-look +S|${HOME}/.config|nwg-look|nwg-look +S|${HOME}/.config|xsettingsd|nwg-look +S|${HOME}|.gtkrc-2.0|nwg-look +S|${HOME}/.config|Kvantum|kvantum +S|${HOME}/.config|qt5ct|qt5ct +S|${HOME}/.config|qt6ct|qt6ct +S|${HOME}/.config/hyde|wallbash|hyprland +S|${HOME}/.config/hypr|animations|hyprland + +O|${HOME}/.local/share|hyde|hyprland +O|${HOME}/.local/lib|hyde|hyprland + + Editor  +P|${HOME}/.config/Code - OSS/User|settings.json|code +P|${HOME}/.config/Code/User|settings.json|visual-studio-code-bin +P|${HOME}/.config/VSCodium/User|settings.json|vscodium-bin + + Bar  +P|${HOME}/.config/waybar|config.ctl|waybar +S|${HOME}/.config/waybar|modules config.jsonc theme.css style.css|waybar + + Terminal  +P|${HOME}/.config|lsd|lsd +S|${HOME}/.config|fastfetch|fastfetch +S|${HOME}/.config/kitty|hyde.conf theme.conf|kitty +P|${HOME}/.config/kitty|kitty.conf|kitty + + Shell  +P|${HOME}/.config|fish|fish +P|${HOME}|.zshrc .hyde.zshrc .p10k.zsh|zsh zsh-theme-powerlevel10k pokego-bin +S|${HOME}|.zshenv|zsh zsh-theme-powerlevel10k + + File Explorer  +P|${HOME}/.local/state|dolphinstaterc|dolphin +P|${HOME}/.config|baloofilerc|dolphin +S|${HOME}/.config/menus|applications.menu|dolphin +S|${HOME}/.config|dolphinrc|dolphin +S|${HOME}/.config|kdeglobals|dolphin +S|${HOME}/.local/share/kio/servicemenus|hydewallpaper.desktop|dolphin +S|${HOME}/.local/share/kxmlgui5|dolphin|dolphin +S|${HOME}/.local/share|dolphin|dolphin + + Input  +P|${HOME}/.config|libinput-gestures.conf|libinput-gestures + + Wayland  +P|${HOME}/.config|spotify-flags.conf|spotify +P|${HOME}/.config|code-flags.conf|code +P|${HOME}/.config|code-flags.conf|visual-studio-code-bin +P|${HOME}/.config|vscodium-flags.conf|vscodium-bin +P|${HOME}/.config|electron-flags.conf|electron + + Notifications  +S|${HOME}/.config|dunst|dunst + + Gaming  +S|${HOME}/.config|MangoHud|mangohud + + Launcher  +S|${HOME}/.config|rofi|rofi +S|${HOME}/.config|wlogout|wlogout + + Lock Screen  +S|${HOME}/.config|swaylock|swaylock-effects +P|${HOME}/.config/hypr|hyprlock.conf|hyprlock +S|${HOME}/.config/hypr|hyprlock|hyprlock + + Idle daemon  +P|${HOME}/.config/hypr|hypridle.conf|hypridle +``` + +
+ +## TOML Configuration + +🚧 🚧 WIP 🚧🚧 + +PSV configuration file is convenient for the script to read and write. However, it is very restrictive and not user-friendly. +For further customization, we can use TOML configuration files. + +... diff --git a/src/content/docs/pt/resources/tools.md b/src/content/docs/pt/resources/tools.md new file mode 100644 index 0000000..e4fbac8 --- /dev/null +++ b/src/content/docs/pt/resources/tools.md @@ -0,0 +1,50 @@ +--- +title: Tools +description: Recommended tools +--- + +These tools can enhance your workflow and help you make the most of your Hyprland experience! They have been tested and works well with HyDe too + +### Wallpaper + +- [Hyprpaper](https://github.com/hyprwm/hyprpaper) ![c++][cpp] (blazing fast wayland wallpaper utility with IPC controls) +- [swww](https://github.com/Horus645/swww) ![rust][rs] (Wallpaper daemon with live switching, awesome animations, and GIF support) +- [mpvpaper](https://github.com/GhostNaN/mpvpaper) ![c][c] (Wallpaper daemon that wraps MPV, useful for videos, and more advanced usage) +- [swaybg](https://github.com/swaywm/swaybg) ![c][c] (Very simple wallpaper daemon used by default on sway) +- [waypaper](https://github.com/anufrievroman/waypaper) ![python][py] (GUI wallpaper setter) +- [waypaper engine](https://github.com/0bCdian/Waypaper-Engine) ![typescript][ts] (GUI wallpaper setter with playlist capabilities) +- [wpaperd](https://github.com/danyspin97/wpaperd) ![rust][rs] (Minimal wallpaper daemon for Wayland) + + +### Idle Daemons + +- [hypridle](https://github.com/hyprwm/hypridle) ![c++][cpp] (Hyprland's idle daemon) +- [swayidle](https://github.com/swaywm/swayidle) ![c][c] (Idle daemon used by default in sway, also only one I could find for wlroots) + +### Lockers + +- [swaylock](https://github.com/swaywm/swaylock) ![c][c] (Sway's default locker, very configurable, and popular) +- [swaylock-effects](https://github.com/mortie/swaylock-effects) ![c][c] (Fork of swaylock, but with effects ^) +- [waylock](https://codeberg.org/ifreund/waylock) ![zig][z] (A small screenlocker for Wayland compositors) +- [hyprlock](https://github.com/hyprwm/hyprlock) ![c++][cpp] (Hyprland's GPU-accelerated screen locking utility) +- [syslock](https://github.com/System64fumo/syslock) ![c++][cpp] (Simple screen locker for wayland written in gtkmm 4) + +### Clipboard Managers + +- [clipman](https://github.com/chmouel/clipman) ![go][go] (A simple clipboard manager for Wayland) +- [cliphist](https://github.com/sentriz/cliphist) ![go][go] (Wayland clipboard manager) + + +### Raw Tools + +- [Grim](https://git.sr.ht/~emersion/grim) ![c][c] (basic screenshot tool) +- [grim-hyprland](https://github.com/eriedaberrie/grim-hyprland) ![c][c] (drop-in replacement Grim fork with support for Hyprland's window capture protocol) +- [Wayshot](https://git.sr.ht/~shinyzenith/wayshot) ![rust][rs] (basic screenshot tool made for speed and in rust) +- [slurp](https://github.com/emersion/slurp) ![c][c] (basic area selection tool) +- [Hyprpicker](https://github.com/hyprwm/hyprpicker) ![c++][cpp] (wlroots-compatible Wayland color picker that does not suck) +- [Wayfreeze](https://github.com/Jappie3/wayfreeze) ![rust][rs] (Tool to freeze the screen of a Wayland compositor) + +### Recording + +- [wf-recorder](https://github.com/ammen99/wf-recorder) ![c++][cpp] (Simple screenrecorder, like grim but records video) +- [wl-screenrec](https://github.com/russelltg/wl-screenrec) ![rust][rs] (Simple and efficient screenrecorder for AMD and Intel GPUs) \ No newline at end of file diff --git a/src/content/docs/pt/theming/gallery.md b/src/content/docs/pt/theming/gallery.md new file mode 100644 index 0000000..4f45613 --- /dev/null +++ b/src/content/docs/pt/theming/gallery.md @@ -0,0 +1,129 @@ +--- +title: HyDE Gallery +description: supported HyDE themes. +sidebar: + order: 1 +--- + +

+ +# Theme Gallery + + + +| Theme | Description | Author | +| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------- | +| [![Vanta Black](https://placehold.co/180x50/000000/FFFFFF?text=Vanta+Black&font=Oswald)](https://github.com/rishav12s/Vanta-Black) | Vanta Black inspired theme having the deepest blacks | [rishav12s](https://github.com/rishav12s) | +| [![Bad Blood](https://placehold.co/180x50/030000/DF1010?text=Bad+Blood&font=Oswald)](https://github.com/HyDE-Project/hyde-gallery/tree/Bad-Blood) | Red & Black based theme. | [HyDE-Project](https://github.com/HyDE-Project) | +| [![Greenify](https://placehold.co/180x50/0e120f/295233?text=Greenify&font=Oswald)](https://github.com/mahaveergurjar/Theme-Gallery/tree/Greenify) | Dark Green based theme for Hyde | [mahaveergurjar](https://github.com/mahaveergurjar) | +| [![Another World](https://placehold.co/180x50/11111B/6AA9C9?text=Another+World&font=Oswald)](https://github.com/cyb3rgh0u1/Another-World) | Step beyond the horizon, where reality fades and imagination reigns supreme. | [cyb3rgh0u1](https://github.com/cyb3rgh0u1) | +| [![Hack the Box](https://placehold.co/180x50/061234/50AA09?text=Hack+the+Box&font=Oswald)](https://github.com/HyDE-Project/hyde-gallery/tree/Hack-the-Box) | Hacker based theme | [T-Crypt](https://github.com/T-Crypt) | +| [![Oxo Carbon](https://placehold.co/180x50/161616/EE5396?text=Oxo+Carbon&font=Oswald)](https://github.com/rishav12s/Oxo-Carbon) | Oxo Carbon based theme for Hyde | [rishav12s](https://github.com/rishav12s) | +| [![Decay Green](https://placehold.co/180x50/14161E/95D3AF?text=Decay+Green&font=Oswald)](https://github.com/HyDE-Project/hyde-themes/tree/Decay-Green) | Official Theme | [prasanthrangan](https://github.com/prasanthrangan) | +| [![Abyssal-Wave](https://placehold.co/180x50/16161D/C8C093?text=Abyssal-Wave&font=Oswald)](https://github.com/Itz-Abhishek-Tiwari/Abyssal-Wave) | Dive into the deep, where elegance meets the infinite night. | [Itz-Abhishek-Tiwari](https://github.com/Itz-Abhishek-Tiwari) | +| [![Ever Blushing](https://placehold.co/180x50/141b1e/67b0e8?text=Ever+Blushing&font=Oswald)](https://github.com/rishav12s/Ever-Blushing) | Ever-Blush inspired dark aesthetic minimal theme | [rishav12s](https://github.com/rishav12s) | +| [![Crimson Blade](https://placehold.co/180x50/082451/D32D6B?text=Crimson+Blade&font=Oswald)](https://github.com/cyb3rgh0u1/Crimson-Blade) | A striking fusion of sharp elegance, cutting through the darkness with bold hues. | [cyb3rgh0u1](https://github.com/cyb3rgh0u1) | +| [![One Dark](https://placehold.co/180x50/1E212B/5B6B76?text=One+Dark&font=Oswald)](https://github.com/RAprogramm/HyDe-Themes/tree/One-Dark) | One Dark based theme | [RAprogramm](https://github.com/RAprogramm) | +| [![Graphite Mono](https://placehold.co/180x50/222222/D9D9D9?text=Graphite+Mono&font=Oswald)](https://github.com/HyDE-Project/hyde-themes/tree/Graphite-Mono) | Official Theme | [prasanthrangan](https://github.com/prasanthrangan) | +| [![Rain Dark](https://placehold.co/180x50/1E2233/822195?text=Rain+Dark&font=Oswald)](https://github.com/rishav12s/Rain-Dark) | Cozy new Rain based theme for HyDE | [rishav12s](https://github.com/rishav12s) | +| [![Pixel Dream](https://placehold.co/180x50/282828/EBDDB2?text=Pixel+Dream&font=Oswald)](https://github.com/rishav12s/Pixel-Dream) | Pixel Art inspired theme | [rishav12s](https://github.com/rishav12s) | +| [![Monokai](https://placehold.co/180x50/2d2a2e/f92672?text=Monokai&font=Oswald)](https://github.com/mahaveergurjar/Theme-Gallery/tree/Monokai) | Monokai based theme for Hyde | [mahaveergurjar](https://github.com/mahaveergurjar) | +| [![Dracula](https://placehold.co/180x50/2B2E3B/607988?text=Dracula&font=Oswald)](https://github.com/RAprogramm/HyDe-Themes/tree/Dracula) | Dracula based theme | [RAprogramm](https://github.com/RAprogramm) | +| [![Eternal Arctic](https://placehold.co/180x50/2E3440/88C0D0?text=Eternal+Arctic&font=Oswald)](https://github.com/rishav12s/Eternal-Arctic) | Serene Nord-inspired theme having frosty aesthetic blues | [rishav12s](https://github.com/rishav12s) | +| [![Solarized Dark](https://placehold.co/180x50/044655/259E9C?text=Solarized+Dark&font=Oswald)](https://github.com/rishav12s/Solarized-Dark) | Solarized Dark based theme for HyDE | [rishav12s](https://github.com/rishav12s) | +| [![Gruvbox Retro](https://placehold.co/180x50/353842/ADAE89?text=Gruvbox+Retro&font=Oswald)](https://github.com/HyDE-Project/hyde-themes/tree/Gruvbox-Retro) | Official Theme | [prasanthrangan](https://github.com/prasanthrangan) | +| [![AbyssGreen](https://placehold.co/180x50/373C3F/83B38E?text=AbyssGreen&font=Oswald)](https://github.com/Itz-Abhishek-Tiwari/AbyssGreen) | AbyssGreen is a theme based on the Everforst color scheme | [Itz-Abhishek-Tiwari](https://github.com/Itz-Abhishek-Tiwari) | +| [![BlueSky](https://placehold.co/180x50/294052/AACBF0?text=BlueSky&font=Oswald)](https://github.com/richen604/BlueSky) | A serene theme inspired by bright cloudy skies | [richen604](https://github.com/richen604) | +| [![Monterey Frost](https://placehold.co/180x50/3B4252/D8DEE9?text=Monterey+Frost&font=Oswald)](https://github.com/rishav12s/Monterey-Frost) | Mac-OS inspired dark theme | [rishav12s](https://github.com/rishav12s) | +| [![Paranoid Sweet](https://placehold.co/180x50/821595/51ABAB?text=Paranoid+Sweet&font=Oswald)](https://github.com/rishav12s/Paranoid-Sweet) | Dark purple based theme for HyDE | [rishav12s](https://github.com/rishav12s) | +| [![Sci-fi](https://placehold.co/180x50/0D55B2/249CB6?text=Sci-fi&font=Oswald)](https://github.com/KaranRaval123/Sci-fi) | Sci-fi based theme | [KaranRaval123](https://github.com/KaranRaval123) | +| [![Scarlet Night](https://placehold.co/180x50/FF0000/0A0A0A?text=Scarlet+Night&font=Oswald)](https://github.com/abenezerw/Scarlet-Night) | Hot-Red + Deep-Black | [abenezerw](https://github.com/abenezerw) | +| [![Synth Wave](https://placehold.co/180x50/495495/ff7edb?text=Synth+Wave&font=Oswald)](https://github.com/HyDE-Project/hyde-themes/tree/Synth-Wave) | Official Theme | [prasanthrangan](https://github.com/prasanthrangan) | +| [![Red Stone](https://placehold.co/180x50/7E5655/C94342?text=Red+Stone&font=Oswald)](https://github.com/mahaveergurjar/Theme-Gallery/tree/Red_Stone) | Hot Red based theme | [mahaveergurjar](https://github.com/mahaveergurjar) | +| [![Windows 11](https://placehold.co/180x50/277AE6/D2DCFD?text=Windows+11&font=Oswald)](https://github.com/HyDE-Project/hyde-gallery/tree/Windows-11) | We love Windows! Wew | [T-Crypt](https://github.com/T-Crypt) | +| [![Mac OS](https://placehold.co/180x50/857990/B9D7EA?text=Mac+OS&font=Oswald)](https://github.com/HyDE-Project/hyde-gallery/tree/Mac-Os) | Official Theme | [T-Crypt](https://github.com/T-Crypt) | +| [![Ice Age](https://placehold.co/180x50/00c1e4cc/0E2840B3?text=Ice+Age&font=Oswald)](https://github.com/saber-88/Ice-Age) | Winter based Ice Age theme for Hyde | [saber-88](https://github.com/saber-88) | +| [![Nordic Blue](https://placehold.co/180x50/7B98B8/CAD7E1?text=Nordic+Blue&font=Oswald)](https://github.com/HyDE-Project/hyde-themes/tree/Nordic-Blue) | Official Theme | [prasanthrangan](https://github.com/prasanthrangan) | +| [![Catppuccin Latte](https://placehold.co/180x50/dd7878/eff1f5?text=Catppuccin+Latte&font=Oswald)](https://github.com/HyDE-Project/hyde-themes/tree/Catppuccin-Latte) | Official Theme | [prasanthrangan](https://github.com/prasanthrangan) | +| [![Tokyo Night](https://placehold.co/180x50/7aa2f7/24283b?text=Tokyo+Night&font=Oswald)](https://github.com/HyDE-Project/hyde-themes/tree/Tokyo-Night) | Official Theme | [prasanthrangan](https://github.com/prasanthrangan) | +| [![Rosé Pine](https://placehold.co/180x50/c4a7e7/191724?text=Rosé+Pine&font=Oswald)](https://github.com/HyDE-Project/hyde-themes/tree/Rose-Pine) | Official Theme | [prasanthrangan](https://github.com/prasanthrangan) | +| [![Green Lush](https://placehold.co/180x50/89E574/153550?text=Green+Lush&font=Oswald)](https://github.com/abenezerw/Green-Lush) | A ghibli based theme for Hyde | [abenezerw](https://github.com/abenezerw) | +| [![Frosted Glass](https://placehold.co/180x50/7ed6ff/1e4c84?text=Frosted+Glass&font=Oswald)](https://github.com/HyDE-Project/hyde-themes/tree/Frosted-Glass) | Official Theme | [prasanthrangan](https://github.com/prasanthrangan) | +| [![Catppuccin Mocha](https://placehold.co/180x50/b4befe/11111b?text=Catppuccin+Mocha&font=Oswald)](https://github.com/HyDE-Project/hyde-themes/tree/Catppuccin-Mocha) | Official Theme | [prasanthrangan](https://github.com/prasanthrangan) | +| [![Edge Runner](https://placehold.co/180x50/fada16/000000?text=Edge+Runner&font=Oswald)](https://github.com/HyDE-Project/hyde-themes/tree/Edge-Runner) | Official Theme | [prasanthrangan](https://github.com/prasanthrangan) | +| [![Material Sakura](https://placehold.co/180x50/f2e9e1/b4637a?text=Material+Sakura&font=Oswald)](https://github.com/HyDE-Project/hyde-themes/tree/Material-Sakura) | Official Theme | [prasanthrangan](https://github.com/prasanthrangan) | +| [![Cat Latte](https://placehold.co/180x50/EFF1F5/DD7878?text=Cat+Latte&font=Oswald)](https://github.com/rishav12s/Cat-Latte) | Better Catppuccin-Latte that fixes the inconsistencies of the official theme | [rishav12s](https://github.com/rishav12s) | + + + +\*All theme tags are linked to their corresponding repositories. + +\*For more information, visit [HyDE-project/hyde-themes](https://github.com/HyDE-project/hyde-themes). + +## Usage + +> - Make sure you have installed [HyDE](https://github.com/HyDE-project/hyde) + +```shell + +> + Execute "theme.import.py" inside your terminal + +> + Choose your theme +``` + +![image](https://raw.githubusercontent.com/HyDE-Project/hyde-gallery/43e6cce54698f24842ae2fbb7b80e79556a21e02/assets/HydeThemes.png) + +--- + +:::note + +HyDE do not utilize a CLI yet, therefore we shall invoke scripts manually. Note that the future CLI will still invoke `theme.import.py` and `theme.patch.sh`, therefore no foreseeable API changes. + +::: + +📢 - You can also add Url-links or File path with single quotations for installing a specific theme + +```shell +theme.patch.sh "Theme-Name" "/Path/to/Configs" +theme.patch.sh "Theme-Name" "https://github.com/User/Repository" +theme.patch.sh "Theme-Name" "https://github.com/User/Repository/tree/branch" +``` + +example + +```shell +theme.patch.sh 'Hack the Box' 'https://github.com/HyDE-Project/Hyde-gallery' +``` + +:::tip +📢 Incase themes have archive updates. export `FORCE_THEME_UPDATE=true` to update Gtk, Icons, Cursors & Font. + +```shell + export FORCE_THEME_UPDATE=true +``` + +::: + +### Updating + +Your local themes can be fetch/updated using the `theme.import.py` script. + +
+Fetch all themes + This command updates all the themes that are located in `xdg_config/hyde/themes/` that are listed in the [HyDe-gallery](#theme-gallery) + +```bash +theme.import.py --fetch all +``` + +
+ +
+Fetch a specific theme + This command updates a specific theme that is located in `xdg_config/hyde/themes/` that are listed in the [HyDe-gallery](#theme-gallery) + +```bash +theme.import.py --fetch "Theme-Name" +``` + +
diff --git a/src/content/docs/pt/theming/gen-gallery-table.py b/src/content/docs/pt/theming/gen-gallery-table.py new file mode 100644 index 0000000..f323942 --- /dev/null +++ b/src/content/docs/pt/theming/gen-gallery-table.py @@ -0,0 +1,98 @@ +#!/bin/env python3 +""" "This is a script to generate a Markdown table for the README.md file""" + +import os +import json +import sys +import requests + +# Check if the output file argument is provided +if len(sys.argv) < 2: + print("Usage: python gen-gallery-table.py ") + sys.exit(1) + +output_file = sys.argv[1] + +# Load JSON data from URL +url = "https://raw.githubusercontent.com/HyDE-Project/hyde-gallery/master/hyde-themes.json" +response = requests.get(url) +data = response.json() + + +# Sort the data list based on the first element of COLORSCHEME +def hex_to_intensity(hex_color): + """Convert hex color to intensity""" + hex_color = hex_color.lstrip("#") + r = int(hex_color[0:2], 16) + g = int(hex_color[2:4], 16) + b = int(hex_color[4:6], 16) + return 0.299 * r + 0.587 * g + 0.114 * b + + +data.sort( + key=lambda theme: hex_to_intensity( + theme.get("COLORSCHEME", ["#000000"])[0] + if isinstance(theme.get("COLORSCHEME"), list) + and len(theme.get("COLORSCHEME")) > 0 + else "#000000" + ) +) + +# Initialize the Markdown table +MD_TABLE = "| Theme | Description | Author |\n" +MD_TABLE += "| --- | --- | --- |\n" + +# Iterate through the sorted JSON data and populate the table +for theme in data: + theme_name = theme.get("THEME", "N/A") + description = theme.get("DESCRIPTION", "N/A") + author = theme.get("OWNER", "N/A").split("/")[-1] + link = theme.get("LINK", "#") + colorscheme = theme.get("COLORSCHEME", ["#000000", "#FFFFFF"]) + + # Generate the image link + BASE_URL = "https://placehold.co/180x50" + color1 = colorscheme[0][1:] + color2 = colorscheme[1][1:] + text = theme_name.replace(" ", "+") + IMAGE_LINK = f"{BASE_URL}/{color1}/{color2}?text={text}&font=Oswald" + # Add the row to the table + MD_TABLE += ( + f"| [![{theme_name}]({IMAGE_LINK})]({link}) | " + f"{description} | " + f"[{author}]({theme.get('OWNER', '#')}) |\n" + ) + +# Add the footer note and end marker +MD_TABLE += "\n" + +# Read the contents of the output file +with open(output_file, "r", encoding="utf-8") as readme_file: + readme_content = readme_file.read() + +# Define the markers where the table content will be inserted +START_MARK = "" +END_MARK = "" + +# Insert the table content between the markers +if START_MARK in readme_content and END_MARK in readme_content: + before_table = readme_content.split(START_MARK)[0] + START_MARK + after_table = readme_content.split(END_MARK)[1] + updated_readme_content = before_table + "\n" + MD_TABLE + after_table +else: + updated_readme_content = ( + readme_content + + "\n" + + "# Theme Gallery\n" + + "\n" + + MD_TABLE + ) + +# Check if the script has write permissions for the output file +if os.access(output_file, os.W_OK): + # Write the updated content back to the output file + with open(output_file, "w", encoding="utf-8") as readme_file: + readme_file.write(updated_readme_content) + print(f"{output_file} has been updated with the generated Markdown table.") +else: + print(f"Permission denied: '{output_file}'. Please check the file permissions.") diff --git a/src/content/docs/pt/theming/making-themes.md b/src/content/docs/pt/theming/making-themes.md new file mode 100644 index 0000000..58e3691 --- /dev/null +++ b/src/content/docs/pt/theming/making-themes.md @@ -0,0 +1,282 @@ +--- +title: Making Themes +description: How to make themes for HyDE +--- + +Here we will walk you through the process of making themes for HyDE step by step. +This tutorial will work for both hyprdots and HyDE. + +### Quick Start Guide + +Clone the hyde-theme-starter repo into your themes directory + +:::tip +Rename `MyTheme` to your theme name, make sure it doesn't conflict in names in [HyDE-Gallery](https://github.com/HyDE-Project/hyde-gallery) +::: + +```bash +git clone https://github.com/richen604/hyde-theme-starter ~/MyTheme +``` + +1. Required components - all must be in `tar.*` format: + + - A GTK theme (mandatory) + - search [Gnome-Look Themes](https://www.gnome-look.org/browse?cat=135&ord=latest) for existing themes + - or see [Generate GTK4](#generate-gtk4-from-wallbash) for generating GTK theme from wallpaper + - Icon pack (optional) - defaults to Tela-circle + - search [Gnome-Look Icons](https://www.gnome-look.org/browse?cat=132&ord=latest) for existing icon packs + - Cursor theme (optional) - defaults to Bibata-Modern-Ice + - search [Gnome-Look Cursors](https://www.gnome-look.org/browse?cat=107&ord=latest) for existing cursor themes + - Font (optional) + - search [fonts.google.com](https://fonts.google.com/) for web fonts + - search [nerdfonts.com](https://www.nerdfonts.com/) for patched developer fonts + +2. A collection of wallpapers that match your desired style/color scheme + + - [Wallhaven](https://wallhaven.cc/) - For wallpapers + - [farbenfroh.io](https://farbenfroh.io/) - For color match wallpapers if you have a desired color scheme in mind + - Don't add too many wallpapers, 8-10 is a good number + +3. Install `just` for running helper scripts `yay -S just` + +Go to your theme directory `cd ~/MyTheme` (replace `MyTheme` with your theme name) + +:::tip +Rename `MyTheme` in the `justfile` to your theme name +::: + +```bash +theme = "MyTheme" +``` + +Run `just init` to generate initial directory structure + +Your theme should have the following structure: + +```bash +~/MyTheme/ +├── Config/ # Part of your final theme - Configuration files +│ └── hyde/ +│ └── themes/ +│ └── MyTheme/ # main theme directory +│ └── wallpapers/ +├── refs/ # for reference files we generate +├── screenshots/ # for screenshots of your theme +├── Source/ # Part of your final theme - Arcs ie. gtk, cursor, icon, font +│ └── arcs/ +├── .gitignore +├── justfile # for running helper scripts +└── README.md # links to this webpage +``` + +### Arcs + +Arcs are the GTK theme, icon, cursor, and font components that make up parts of your theme. +Lets add these right away to the `Source/arcs` directory so they are ready for testing. + +Your folder structure should look something like this: + +```bash +~/MyTheme/ +├── Source/ +│ └── arcs/ +│ ├── Gtk_.tar.* +│ ├── Cursor_.tar.* +│ └── Icon_.tar.* +│ └── Font_.tar.* +``` + +**Make sure to use the correct prefix for each arc**. eg. `Gtk_.tar.*` + +### Viewing your theme with Wallbash + +Copy your wallpapers to your theme directory + +```bash +cp -r ~/wallpapers ~/MyTheme/Config/.config/hyde/themes/MyTheme/wallpapers +``` + +cd into your theme directory + +```bash +cd ~/MyTheme +``` + +install your theme + +```bash +just install +``` + +### Testing your theme with wallbash + +There are two ways to initialize your theme. from wallbash or from an existing theme. + +We are going to use wallbash for this guide. as it gives you a good understanding of how wallbash generates the colors for your theme. You can learn more about wallbash [here](#understanding-wallbash). + +Open Wallbash, setting auto, dark, or light (`Meta + Shift + R`).
+Set your chosen wallpaper as the current wallpaper (`Meta + Shift + W`) + +Observe how wallbash adapts the colors to your wallpaper for the following applications: + +- GTK (nwg-look) + - to test your arc gtk theme, change from wallbash mode to theme mode (Meta + Shift + R) + - then check `pavucontrol` to see if your gtk theme looks weird. if it does, follow the instructions in [Generate GTK4](#generate-gtk4-from-wallbash) to generate GTK4 theme files using wallbash +- Kitty (kitty) +- QT (qt5ct + qt6ct) +- Waybar (waybar) +- Spotify (spotify) +- VSCode (code) - needs wallbash enabled as color theme +- Cava (cava) + +### Generate theme files + +Make sure the wallpaper you picked is the best wallpaper that wallbash generates for your theme.
+Now run the following commands to generate the wallbash files. + +```bash +just gen-all +just set-wall +``` + +You'll see a bunch of new files in your theme `refs` directory. + +```bash +~/MyTheme/ +├── refs/ # for reference files we generate +│ ├── gtk-4.0/ # GTK4 theme files +│ │ ├── gtk.css # Light theme +│ │ └── gtk-dark.css # Dark theme +│ ├── kvantum/ # Kvantum theme files +│ │ ├── kvantum.theme # Kvantum theme config +│ │ └── kvconfig.theme # Kvantum config +│ ├── hypr.theme # Hyprland theme +│ ├── kitty.theme # Kitty terminal theme +│ ├── rofi.theme # Rofi theme +│ ├── theme.dcol # wallbash "theme" mode overrides +│ └── waybar.theme # Waybar theme +│ └── wall.set # First wallpaper theme uses +``` + +You can copy all the files to your `Config/.config/hyde/themes/MyTheme` directory. + +```bash +cp -r ./refs/* ./Config/.config/hyde/themes/MyTheme +``` + +run install again to update your theme + +```bash +just install +``` + +These files are used to set the "theme" mode for your theme. (`Meta + Shift + R`) + +### Editing \*.theme files + +These files are important for themes to work correctly. + +You should reference a theme like [Bad Blood](https://github.com/HyDE-Project/hyde-gallery/blob/Bad-Blood/Configs/.config/hyde/themes/Bad%20Blood) along this guide. + +Each \*.theme file contains configuration lines + +The first line has the format: file_path | command_to_execute + +- hypr.theme - `$HOME/.config/hypr/themes/theme.conf|> $HOME/.config/hypr/themes/colors.conf` +- kitty.theme - `$HOME/.config/kitty/theme.conf|killall -SIGUSR1 kitty` +- rofi.theme - `$HOME/.config/rofi/theme.rasi` +- waybar.theme - `$HOME/.config/waybar/theme.css|${scrDir}/wbarconfgen.sh` + +the most important file is `hypr.theme` + +```bash +$HOME/.config/hypr/themes/theme.conf|> $HOME/.config/hypr/themes/colors.conf +# ~/.config/hypr/theme/theme.conf is an auto-generated file. Do not edit. + +$GTK_THEME=Bad-Blood # folder name inside `Source/arcs/Gtk_.tar.*` +$ICON_THEME=besgnulinux-mono-red # folder name inside `Source/arcs/Icon_.tar.*` +$COLOR_SCHEME=prefer-dark # prefer-dark, prefer-light, or auto +$CURSOR_THEME=Night-Diamond-Red # folder name inside `Source/arcs/Cursor_.tar.*` +$CURSOR_SIZE=30 # cursor size in pixels +``` + +- Edit the variables for arcs, must match the name of the folder **inside** each arc in `Source/arcs` like above +- Set hyprland borders, colors, and other theme related settings +- You can use hypr.theme to set additional programs for your theme. such as SDDM or Vscode theme +- Becomes `$HOME/.config/hypr/themes/theme.conf` + +Any updates to your theme in either `Config` or `Source` should be run with `just install` to update your theme. + +### Editing theme.dcol + +The `theme.dcol` file is used to override some generated wallbash colors for wallbash modes. +Check out [understanding wallbash](#understanding-wallbash) for more information. + +This file is entirely optional + +### Finalizing your theme + +Your theme should now be ready to be added to the hyde-gallery! + +A few more finishing touches: + +- Add some screenshots to `~/screenshots` +- Add your theme to the Hyde-Gallery + +### Adding Themes to Hyde-Gallery + +In your theme directory, generate the readme using + +```bash +python3 generate_readme.py +``` + +Initialize git + +```bash +git init && git branch -M main && git add . && git commit -m "My first HyDE theme" +``` + +[create a github repo](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-new-repository) + +```bash +git remote add origin +git push -u origin main +``` + +Fork hyde-gallery
+Add your theme to the list and `hyde-themes.json` + +## More Information + +### Generate GTK4 from wallbash + +If your theme doesn't include GTK4 support, pavucontrol and other GTK4 applications may appear with a plain white theme. + +Run the following command to generate the GTK4 theme files + +```bash +just gen-gtk4 +``` + +Copy the `refs/gtk-4.0` directory to your theme directory + +```bash +mkdir -p ./Config/.config/hyde/themes/MyTheme/gtk-4.0 +cp -r ./refs/gtk-4.0/* ./Config/.config/hyde/themes/MyTheme/gtk-4.0/ +``` + +### Understanding wallbash + +Wallbash generates 4 primary colors from your wallpaper, then creates color groups around each primary color with the following structure: + +For each primary color (`wallbash_pry1` through `wallbash_pry4`): + +- Text color (`wallbash_txt1` through `wallbash_txt4`) +- 9 accent colors (`wallbash_1xa1` through `wallbash_1xa9` for group 1, etc.) + +Each color has an RGBA variant with configurable opacity (e.g. `wallbash_pry1_rgba(0.95)`) + +Total: 44 base colors (4 groups × 11 colors) plus RGBA variants + +Use `just gen-dcol` to generate a `theme.dcol` with all the wallbash generated colors for your active wallpaper for reference diff --git a/src/content/docs/pt/theming/wallbash-and-dcol.md b/src/content/docs/pt/theming/wallbash-and-dcol.md new file mode 100644 index 0000000..e74568a --- /dev/null +++ b/src/content/docs/pt/theming/wallbash-and-dcol.md @@ -0,0 +1,101 @@ +--- +title: Wallbash and dcol +description: Understanding Wallbash and dcol +--- + +## Overview + +This document provides an explanation of the color configuration used for theming HyDE. It covers primary colors, text colors, and accent colors. Each color can be specified in either hexadecimal or RGBA format. + +## Color Identifiers + +By default, while **wallpaper caching**, it will produce 4 primary colors, 4 text colors, and 9 accent colors for each primary color. + +- **`dcol_mode`**: This identifier determines whether the theme is in dark or light mode. +- **`dcol_pryX`**: These are the primary colors, with `X` ranging from 1 to 4. +- **`dcol_txtX`**: These are the inverted primary colors used for text, with `X` ranging from 1 to 4. +- **`dcol_XaxY`**: These are the accent colors for each primary color, with `X` ranging from 1 to 4 and `Y` ranging from 1 to 9. +- **`_rgba`**: This suffix indicates that the color is in RGBA format. If the suffix is not present, the color is in hexadecimal format. +- **`_rgb`**: This suffix indicates that the color is in RGB format. + +## Usage + +To use the cache color configuration: + +1. Replace the prefix `dcol_` with `wallbash_` to allow the Wallbash script to parse and change values. +2. Consider the `wallbash_` prefix as a placeholder for the dominant color value. +3. Wrap the color identifier with angle brackets (`<...>`) to indicate replacement with the corresponding value, e.g., ``. +4. Use this [example](https://github.com/hyde-project/hyde/tree/master/Configs/.config/hyde/wallbash) as a template. + +This allows you to create a template for configurations, using the dominant color or wallpaper, and let the Wallbash script convert it for you. + +### Creating a `*.dcol` Template + +A template requires three parts: + +- Target file +- Script/command (optional) +- Contents + +## The basic format: + +``` +target|command +contents +``` + + +:::note +**target**|**command** should always be on line 1 of every template file. We will call it `header line`. +::: + +#### Target File + +Structure your template and determine the target configuration location. This can be: + +- `${cacheDir}/wallbash` with post-processing using a script. +- An expected path, e.g., beside `kitty.conf` for Kitty, sourced by `include theme.conf`. + +Use environment variables to handle directories dynamically: + +- `${confDir}` = `$XDG_CONFIG_HOME` or `$HOME/.config/` +- `${cacheDir}/wallbash` = `HYDE_CACHE_DIR/wallbash` = `$HOME/.cache/hyde` + +#### Optional Script/Command + +After filling the target file with contents, you can run arbitrary commands/scripts for post-processing. Use the `WALLBASH_SCRIPTS` variable to navigate to Wallbash's script directory, e.g., `WALLBASH_SCRIPTS/your_script.sh`. + +:::caution +Only add templates from trusted authors to avoid executing bad code. +::: + +#### Contents + +These are the contents of the file, containing Wallbash placeholders, e.g., ``. + +--- + +The `~/.config/hyde/wallbash/*` directory contains three main directories: + +### always + +Templates in `./wallbash/always/` are executed during: + +- Theme switch +- Wallpaper switch +- Mode switch + +More information [here](./always/README). + +### theme + +Templates in `./wallbash/theme/` are executed during: + +- Theme switch +- Mode switch + +More information [here](./theme/README). + +### scripts + +For customization, store your scripts in `./wallbash/scripts`. Use the `$WALLBASH_SCRIPTS` variable to navigate this directory. From 4e4fcc1e8c85ebb0020e5fb3186e78fd4c6487f1 Mon Sep 17 00:00:00 2001 From: Mircas001 <79532341+Mircas001@users.noreply.github.com> Date: Thu, 10 Jul 2025 17:56:07 -0300 Subject: [PATCH 02/24] docs: Update gallery.md on theming --- src/content/docs/en/theming/gallery.md | 24 +++++++++--------------- 1 file changed, 9 insertions(+), 15 deletions(-) diff --git a/src/content/docs/en/theming/gallery.md b/src/content/docs/en/theming/gallery.md index 4f45613..afbaee6 100644 --- a/src/content/docs/en/theming/gallery.md +++ b/src/content/docs/en/theming/gallery.md @@ -66,7 +66,7 @@ sidebar: ```shell -> + Execute "theme.import.py" inside your terminal +> + Execute "hyde-shell theme.import --select" inside your terminal > + Choose your theme ``` @@ -75,45 +75,39 @@ sidebar: --- -:::note - -HyDE do not utilize a CLI yet, therefore we shall invoke scripts manually. Note that the future CLI will still invoke `theme.import.py` and `theme.patch.sh`, therefore no foreseeable API changes. - -::: - 📢 - You can also add Url-links or File path with single quotations for installing a specific theme ```shell -theme.patch.sh "Theme-Name" "/Path/to/Configs" -theme.patch.sh "Theme-Name" "https://github.com/User/Repository" -theme.patch.sh "Theme-Name" "https://github.com/User/Repository/tree/branch" +hyde-shell theme.patch "Theme-Name" "/Path/to/Configs" +hyde-shell theme.patch "Theme-Name" "https://github.com/User/Repository" +hyde-shell theme.patch "Theme-Name" "https://github.com/User/Repository/tree/branch" ``` example ```shell -theme.patch.sh 'Hack the Box' 'https://github.com/HyDE-Project/Hyde-gallery' +hyde-shell theme.patch 'Hack the Box' 'https://github.com/HyDE-Project/Hyde-gallery' ``` :::tip 📢 Incase themes have archive updates. export `FORCE_THEME_UPDATE=true` to update Gtk, Icons, Cursors & Font. ```shell - export FORCE_THEME_UPDATE=true +export FORCE_THEME_UPDATE=true ``` ::: ### Updating -Your local themes can be fetch/updated using the `theme.import.py` script. +Your local themes can be fetch/updated using the `theme.import` script.
Fetch all themes This command updates all the themes that are located in `xdg_config/hyde/themes/` that are listed in the [HyDe-gallery](#theme-gallery) ```bash -theme.import.py --fetch all +hyde-shell theme.import --fetch all ```
@@ -123,7 +117,7 @@ theme.import.py --fetch all This command updates a specific theme that is located in `xdg_config/hyde/themes/` that are listed in the [HyDe-gallery](#theme-gallery) ```bash -theme.import.py --fetch "Theme-Name" +hyde-shell theme.import --fetch "Theme-Name" ``` From 85b0147eeecff4762604de65d58c8b086cff17ce Mon Sep 17 00:00:00 2001 From: Mircas001 <79532341+Mircas001@users.noreply.github.com> Date: Fri, 11 Jul 2025 13:03:40 -0300 Subject: [PATCH 03/24] docs: Update docs to hydectl --- src/content/docs/en/theming/gallery.md | 25 ++++++++++++++++--------- 1 file changed, 16 insertions(+), 9 deletions(-) diff --git a/src/content/docs/en/theming/gallery.md b/src/content/docs/en/theming/gallery.md index afbaee6..9f6a848 100644 --- a/src/content/docs/en/theming/gallery.md +++ b/src/content/docs/en/theming/gallery.md @@ -66,7 +66,7 @@ sidebar: ```shell -> + Execute "hyde-shell theme.import --select" inside your terminal +> + Execute "hydectl theme import" inside your terminal > + Choose your theme ``` @@ -75,18 +75,25 @@ sidebar: --- -📢 - You can also add Url-links or File path with single quotations for installing a specific theme +## Selecting a theme +You can select themes using rofi with the following command: ```shell -hyde-shell theme.patch "Theme-Name" "/Path/to/Configs" -hyde-shell theme.patch "Theme-Name" "https://github.com/User/Repository" -hyde-shell theme.patch "Theme-Name" "https://github.com/User/Repository/tree/branch" +hydectl theme select ``` -example +You can also set it straight from the terminal using the following command +```shell +hydectl theme set "Theme-Name" +``` + +## Importing other themes +You can import other themes by running: ```shell -hyde-shell theme.patch 'Hack the Box' 'https://github.com/HyDE-Project/Hyde-gallery' +hydectl theme import --name "Theme-Name" --url "https://github.com/User/Repository" +hydectl theme import --name "Theme-Name" --url "https://github.com/User/Repository/Branch" +hydectl theme import --name "Theme-Name" --url "/Path/to/Configs/ ``` :::tip @@ -107,7 +114,7 @@ Your local themes can be fetch/updated using the `theme.import` script. This command updates all the themes that are located in `xdg_config/hyde/themes/` that are listed in the [HyDe-gallery](#theme-gallery) ```bash -hyde-shell theme.import --fetch all +hydectl theme import -f all ``` @@ -117,7 +124,7 @@ hyde-shell theme.import --fetch all This command updates a specific theme that is located in `xdg_config/hyde/themes/` that are listed in the [HyDe-gallery](#theme-gallery) ```bash -hyde-shell theme.import --fetch "Theme-Name" +hydectl theme import -f "Theme-Name" ``` From 15afe7bae689f6d03814ff8fa8b778533dcff8ba Mon Sep 17 00:00:00 2001 From: Mircas001 <79532341+Mircas001@users.noreply.github.com> Date: Fri, 11 Jul 2025 13:07:58 -0300 Subject: [PATCH 04/24] docs: Update gallery.md on portuguese --- src/content/docs/pt/theming/gallery.md | 33 +++++++++++++------------- 1 file changed, 17 insertions(+), 16 deletions(-) diff --git a/src/content/docs/pt/theming/gallery.md b/src/content/docs/pt/theming/gallery.md index 4f45613..9f6a848 100644 --- a/src/content/docs/pt/theming/gallery.md +++ b/src/content/docs/pt/theming/gallery.md @@ -66,7 +66,7 @@ sidebar: ```shell -> + Execute "theme.import.py" inside your terminal +> + Execute "hydectl theme import" inside your terminal > + Choose your theme ``` @@ -75,45 +75,46 @@ sidebar: --- -:::note +## Selecting a theme -HyDE do not utilize a CLI yet, therefore we shall invoke scripts manually. Note that the future CLI will still invoke `theme.import.py` and `theme.patch.sh`, therefore no foreseeable API changes. - -::: - -📢 - You can also add Url-links or File path with single quotations for installing a specific theme +You can select themes using rofi with the following command: +```shell +hydectl theme select +``` +You can also set it straight from the terminal using the following command ```shell -theme.patch.sh "Theme-Name" "/Path/to/Configs" -theme.patch.sh "Theme-Name" "https://github.com/User/Repository" -theme.patch.sh "Theme-Name" "https://github.com/User/Repository/tree/branch" +hydectl theme set "Theme-Name" ``` -example +## Importing other themes +You can import other themes by running: ```shell -theme.patch.sh 'Hack the Box' 'https://github.com/HyDE-Project/Hyde-gallery' +hydectl theme import --name "Theme-Name" --url "https://github.com/User/Repository" +hydectl theme import --name "Theme-Name" --url "https://github.com/User/Repository/Branch" +hydectl theme import --name "Theme-Name" --url "/Path/to/Configs/ ``` :::tip 📢 Incase themes have archive updates. export `FORCE_THEME_UPDATE=true` to update Gtk, Icons, Cursors & Font. ```shell - export FORCE_THEME_UPDATE=true +export FORCE_THEME_UPDATE=true ``` ::: ### Updating -Your local themes can be fetch/updated using the `theme.import.py` script. +Your local themes can be fetch/updated using the `theme.import` script.
Fetch all themes This command updates all the themes that are located in `xdg_config/hyde/themes/` that are listed in the [HyDe-gallery](#theme-gallery) ```bash -theme.import.py --fetch all +hydectl theme import -f all ```
@@ -123,7 +124,7 @@ theme.import.py --fetch all This command updates a specific theme that is located in `xdg_config/hyde/themes/` that are listed in the [HyDe-gallery](#theme-gallery) ```bash -theme.import.py --fetch "Theme-Name" +hydectl theme import -f "Theme-Name" ``` From 199763512e513f263106c1371aafbc1fe1d1388e Mon Sep 17 00:00:00 2001 From: Mircas001 <79532341+Mircas001@users.noreply.github.com> Date: Fri, 11 Jul 2025 14:49:37 -0300 Subject: [PATCH 05/24] docs: Translate installation.md --- .../docs/pt/getting-started/installation.md | 63 ++++++++++--------- 1 file changed, 32 insertions(+), 31 deletions(-) diff --git a/src/content/docs/pt/getting-started/installation.md b/src/content/docs/pt/getting-started/installation.md index 02ce37b..846d35e 100644 --- a/src/content/docs/pt/getting-started/installation.md +++ b/src/content/docs/pt/getting-started/installation.md @@ -1,28 +1,30 @@ --- -title: Installation -description: HyDE Installation guide +title: Instalação +description: Guia de Instalação do HyDE --- -The installation script is designed for a minimal [Arch Linux](https://wiki.archlinux.org/title/Arch_Linux) install, but **may** work on some [Arch-based distros](https://wiki.archlinux.org/title/Arch-based_distributions). -While installing HyDE alongside another [DE](https://wiki.archlinux.org/title/Desktop_environment)/[WM](https://wiki.archlinux.org/title/Window_manager) should work, due to it being a heavily customized setup, it **will** conflict with your [GTK](https://wiki.archlinux.org/title/GTK)/[Qt](https://wiki.archlinux.org/title/Qt) theming, [Shell](https://wiki.archlinux.org/title/Command-line_shell), [SDDM](https://wiki.archlinux.org/title/SDDM), [GRUB](https://wiki.archlinux.org/title/GRUB), etc. and is at your own risk. +// TODO: Por artigos -For Nixos support there is a separate project being maintained @ [Hydenix](https://github.com/richen604/hydenix/tree/main) +Este script de instalação foi projetado para um sistema mínimo [Arch Linux](https://wiki.archlinux.org/title/Arch_Linux_(Portugu%C3%AAs)) , mas **pode** funcionar em alguns [distros derivados do Arch](https://wiki.archlinux.org/title/Arch-based_distributions_(Portugu%C3%AAs)). +Embora instalar HyDE com outro [DE](https://wiki.archlinux.org/title/Desktop_environment_(Portugu%C3%AAs)/[WM](https://wiki.archlinux.org/title/Window_manager_(Portugu%C3%AAs) funcione, como ele é uma configuração fortemente customizada, ele **irá** conflitar com a personalização visual do [GTK](https://wiki.archlinux.org/title/GTK_(Portugu%C3%AAs)/[Qt](https://wiki.archlinux.org/title/Qt_(Portugu%C3%AAs), [Shell](https://wiki.archlinux.org/title/Command-line_shell_(Portugu%C3%AAs), [SDDM](https://wiki.archlinux.org/title/SDDM_(Portugu%C3%AAs), [GRUB](https://wiki.archlinux.org/title/GRUB_(Portugu%C3%AAs), etc., e é por sua própria conta e risco. + +Para suporte a NixOS, há um projeto separado mantido: @ [Hydenix](https://github.com/richen604/hydenix/tree/main). :::note -The install script will auto-detect an NVIDIA card and install nvidia-dkms drivers for your kernel. -Please ensure that your NVIDIA card supports dkms drivers in the list provided [here](https://wiki.archlinux.org/title/NVIDIA). +O script de instalação irá automaticamente detectar uma placa NVIDIA, e instalará drivers nvidia-dkms para o seu kernel +Por favor, verifique se sua placa NVIDIA tem suporte aos drivers dkms na lista indicada [aqui](https://wiki.archlinux.org/title/NVIDIA_(Portugu%C3%AAs). ::: :::danger -The script modifies your `grub` or `systemd-boot` config to enable NVIDIA DRM. +O script modifica sua configuração `grub` ou `systemd-boot` para habilitar DRM NVIDIA. ::: -### Automated installation script +### Script automático de instalação. ```shell pacman -S --needed git base-devel @@ -32,7 +34,7 @@ cd ~/HyDE/Scripts ``` :::tip -You can also add any other apps you wish to install alongside HyDE to `Scripts/pkg_user.lst` and pass the file as a parameter to install it like so: +Você pode adicionar quaisquer outros apps que você deseja instalar com o HyDE no arquivo `Scripts/pkg_user.lst` e passar como parâmetro para instalá-los dessa maneira: ```shell ./install.sh pkg_user.lst @@ -41,16 +43,15 @@ You can also add any other apps you wish to install alongside HyDE to `Scripts/p ::: :::note -Refer your list from `Scripts/pkg_extra.lst` -or you can `cp Scripts/pkg_extra.lst Scripts/pkg_user.lst` if you wish to install all extra packages. +Use o `Scripts/pkg_extra.lst` como referência para sua lista, +ou `cp Scripts/pkg_extra.lst Scripts/pkg_user.lst` se deseja instalar todos os pacotes extras. ::: -### Granular and Manual Installation +### Instalação manual e granular #### Clone -Clone the repo and change the directory to the script path. Then make sure the user has [w]rite and e[x]ecute permission to the clone directory - +Clone o repositório e mude o diretório para o caminho do script. Também garante que o usuário tem permissão de escrever[w] e de e[x]ecutar no diretório clonado. ```shell pacman -Sy git git clone --depth 1 https://github.com/HyDE-Project/HyDE ~/HyDE @@ -58,37 +59,37 @@ cd ~/HyDE/Scripts ``` :::caution -**NEVER** ever execute the script with sudo or as root user! +**JAMAIS** execute o script com sudo ou como usuario root! ::: -#### Modes +#### Modos -The install script can be executed in different modes, +O script de instalação pode ser executado em diferentes modos -- for default full hyprland installation with all configs +- Para instalação completa padrão hyprland com todas as configurações ```shell ./install.sh ``` -- for full or minimal hyprland installation + your favorite packages (ex.`pkg_user.lst`) +- Para instalação completa ou minima + seus pacotes favoritos (ex.`pkg_user.lst`) ```shell -./install.sh pkg_user.lst # full install pkg_core.lst + pkg_user.lst with configs -./install.sh -i pkg_user.lst # minimal install pkg_core.lst + pkg_user.lst without configs +./install.sh pkg_user.lst # instalação completa pkg_core.lst + pkg_user.lst com configurações +./install.sh -i pkg_user.lst # instalação minima pkg_core.lst + pkg_user.lst sem configurações. ``` -- each [section](#process) can also be independently executed as, +- Cada [seção](#process) pode ser executada de forma independente como, ```shell -./install.sh -i # minimal install hyprland without any configs -./install.sh -d # minimal install hyprland without any configs, but with (--noconfirm) install -./install.sh -r # just restores the config files -./install.sh -s # start and enable system services -./install.sh -t # test run without executing (-irst to dry run all) -./install.sh -m # skips the theme installation -./install.sh -n # skips nvidia installation -./install.sh -irst # to do a test run for all +./install.sh -i # instalação hyprland minima sem quaisquer configurações +./install.sh -d # instalação minima hyprland sem quaisquer configurações, mas com instalação (--noconfirm). +./install.sh -r # apenas restaura os arquivos de configuração +./install.sh -s # inicia e habilita serviços do sistema +./install.sh -t # Teste sem executar (-irst para simular tudo) +./install.sh -m # pula a instalação de temas +./install.sh -n # pula a instalação nvidia +./install.sh -irst # para testar tudo sem aplicar nada ``` -HyDE exposes `xdg_config/hyde/config.toml` file for users to modify. This lets users have the ability to interact the scripts without using command arguments. +--- +O HyDE expõe o arquivo `xdg_config/hyde/config.toml` para usuários modificarem. Isto permite que usuários tenham a habilidade de interagir com os scripts sem usar parâmetros de comando. -Users are encouraged to use an editor that support schema validation to ensure the configuration file is valid. +Os usuários são encorajados a usar um editor que suporte validação de schema para garantir que o arquivo de configuração é válido. ```toml "$schema" = "https://raw.githubusercontent.com/HyDE-Project/HyDE/refs/heads/master/Configs/.local/share/hyde/schema/config.toml.json" ``` --- ### [battery.notify] -batterynotify.sh configuration. +Configuração para o batterynotify.sh. | Key | Description | Default | | --- | ----------- | ------- | -| dock | Dock status for battery notifications. | true | -| interval | Interval for battery notifications. | 5 | -| notify | Notification threshold. | 1140 | -| timer | Timer for battery notifications. | 120 | +| dock | Status do dock para notificações da bateria. | true | +| interval | Intervalo para notificações da bateria. | 5 | +| notify | Limite de notificações. | 1140 | +| timer | Timer para notificações da bateria. | 120 | ### [battery.notify.execute] -Commands to execute for battery notifications. +Comando para executar para notificações da bateria. | Key | Description | Default | | --- | ----------- | ------- | -| charging | Command to execute when charging. | | -| critical | Command to execute when battery is critical. | systemctl suspend | -| discharging | Command to execute when discharging. | | -| low | Command to execute when battery is low. | | -| unplug | Command to execute when unplugged. | | +| charging | Comando para executar quando carregando. | | +| critical | Comando para executar quando bateria critica. | systemctl suspend | +| discharging | Comando para executar quando descarregando. | | +| low | Comando para executar quando bateria baixa. | | +| unplug | Comando para executar quando desconectado. | | ### [battery.notify.threshold] -Thresholds for battery notifications. +Limiar para notificações da bateria. | Key | Description | Default | | --- | ----------- | ------- | -| critical | Critical battery threshold. | 10 | -| full | Full battery threshold. | 90 | -| low | Low battery threshold. | 20 | -| unplug | Unplug battery threshold. | 100 | +| critical | Limiar para bateria critica. | 10 | +| full | Limiar para bateria cheia. | 90 | +| low | Limiar para bateria baixa. | 20 | +| unplug | Limiar para desconectar bateria. | 100 | ### [brightness] -brightnesscontrol.sh configuration. +Configuração do brightnesscontrol.sh. | Key | Description | Default | | --- | ----------- | ------- | -| notify | Enable notifications for brightness control. | true | -| steps | Number of steps to increase/decrease brightness. | 5 | +| notify | Habilitar notificações para controle de brilho. | true | +| steps | Número de passos para incrementar/reduzir volume. | 5 | ### [cava.hyprlock] -'cava.sh hyprlock' configuration. +Configuração do 'cava.sh hyprlock'. | Key | Description | Default | | --- | ----------- | ------- | -| bar | Bar characters for cava. | ▁▂▃▄▅▆▇█ | -| max_instances | Maximum number of cava instances. | 1 | -| range | Number of bars minus one. | 7 | -| standby | Standby character for cava. | 🎶 | -| width | Width of the cava output. | 20 | +| bar | Caracteres de barra do cava. | ▁▂▃▄▅▆▇█ | +| max_instances | número máximo de instâncias do cava. | 1 | +| range | Número de barras, menos um. | 7 | +| standby | Caractere de standby do cava. | 🎶 | +| width | Largura da saida do cava. | 20 | ### [cava.stdout] -'cava.sh stdout' configuration. +Configuração do 'cava.sh stdout'. | Key | Description | Default | | --- | ----------- | ------- | -| bar | Bar characters for cava. | ▁▂▃▄▅▆▇█ | -| max_instances | Maximum number of cava instances. | 1 | -| range | Number of bars minus one. | 7 | -| standby | Standby character for cava. | 🎶 | -| width | Width of the cava output. | 20 | +| bar | Caracteres de barra para o cava. | ▁▂▃▄▅▆▇█ | +| max_instances | número de instâncias máxima do cava. | 1 | +| range | número de barras, menos um. | 7 | +| standby | Caractere de espera do cava. | 🎶 | +| width | Largura da saída do cava. | 20 | ### [cava.waybar] -'cava.sh waybar' configuration. +'Configuração do cava.sh waybar'. | Key | Description | Default | | --- | ----------- | ------- | -| bar | Bar characters for cava. | ▁▂▃▄▅▆▇█ | -| max_instances | Maximum number of cava instances. | 1 | -| range | Number of bars minus one. | 7 | -| standby | Standby character for cava. | 🎶 | -| width | Width of the cava output. | 20 | +| bar | Caracteres de barra do cava. | ▁▂▃▄▅▆▇█ | +| max_instances | número máximo de instâncias do cava. | 1 | +| range | número de barras, menos um. | 7 | +| standby | Caractere de espera do cava. | 🎶 | +| width | Largura da saída do cava. | 20 | ### [hypr.config] -Hypr configuration. +Configuração do Hypr. | Key | Description | Default | | --- | ----------- | ------- | -| sanitize | List of regex to sanitize in the theme.config. | [".*rgba\(.*,.*,.*,.*\)"] | +| sanitize | Lista de regex para higienizar no theme.config. | [".*rgba\(.*,.*,.*,.*\)"] | ### [hyprland] -Hyprland configuration. +Configuração do hyprland. | Key | Description | Default | | --- | ----------- | ------- | -| background_path | LockScreen's Background path. | | -| bar | Bar. | waybar | -| browser | Browser. | firefox | -| button_layout | Button layout. (gtk only) | | -| color_scheme | Color scheme. | prefer-dark | -| cursor_size | Cursor size. | 24 | -| cursor_theme | Cursor theme. | Bibata-Modern-Ice | -| document_font_size | Document font size. | 10 | +| background_path | Caminho do papel de parede da tela de bloqueio. | | +| bar | Barra. | waybar | +| browser | Navegador. | firefox | +| button_layout | Layout do botão. (apenas gtk) | | +| color_scheme | Esquema de cores. | prefer-dark | +| cursor_size | Tamanho do cursor. | 24 | +| cursor_theme | Tema do cursor. | Bibata-Modern-Ice | +| document_font_size | Tamanho da fonte do documento. | 10 | | editor | Editor. | code | -| explorer | File manager. | dolphin | -| font | Font. | Canterell | -| font_antialiasing | Font antialiasing. | rgba | +| explorer | Gerenciador de arquivos. | dolphin | +| font | Fonte. | Canterell | +| font_antialiasing | Antialiasing da fonte. | rgba | | font_hinting | Font hinting. | full | -| font_size | Font size. | 10 | -| gtk_theme | GTK theme. | Wallbash-Gtk | -| icon_theme | Icon theme. | Tela-circle-dracula | -| idle | Idle manager. | hypridle | -| lockscreen | Lockscreen. | lockscreen.sh | -| monospace_font | Monospace font. | CaskaydiaCove Nerd Font Mono | -| monospace_font_size | Monospace font size. | 9 | -| quickapps | Quick apps. | kitty | +| font_size | Tamanho da fonte. | 10 | +| gtk_theme | Tema GTK. | Wallbash-Gtk | +| icon_theme | Tema dos ícones. | Tela-circle-dracula | +| idle | Gerenciador de ociosidade. | hypridle | +| lockscreen | Tela de bloqueio. | lockscreen.sh | +| monospace_font | Fonte mono espaçada. | CaskaydiaCove Nerd Font Mono | +| monospace_font_size | Tamanho da fonte mono espaçada. | 9 | +| quickapps | Aplicativos de acesso rápido. | kitty | | terminal | Terminal. | kitty | ### [hyprland_start] -Hyprland start configuration. +Configuração de inicialização hyprland. | Key | Description | Default | | --- | ----------- | ------- | -| apptray_bluetooth | Bluetooth applet. | blueman-applet | -| auth_dialogue | Authentication dialogue. | polkitkdeauth.sh | -| bar | Bar. | hyde-shell waybar --watch | -| battery_notify | Battery notification script. | batterynotify.sh | -| dbus_share_picker | DBus share picker. | dbus-update-activation-environment --systemd --all | -| idle_daemon | Idle daemon. | hypridle | -| image_clipboard | Image clipboard. | wl-paste --type image --watch cliphist store | -| network_manager | Network manager. | nm-applet --indicator | -| notifications | Notifications. | swaync | -| removable_media | Removable media manager. | udiskie --no-automount --smart-tray | -| systemd_share_picker | Systemd share picker. | systemctl --user import-environment QT_QPA_PLATFORMTHEME WAYLAND_DISPLAY XDG_CURRENT_DESKTOP | -| text_clipboard | Text clipboard. | wl-paste --type text --watch cliphist store | -| wallpaper | Wallpaper script. | $scrPath/wallpaper.sh --global | -| xdg_portal_reset | XDG portal reset script. | resetxdgportal.sh | +| apptray_bluetooth | Applet do Bluetooth | blueman-applet | +| auth_dialogue | Caixa de diálogo da autenticação. | polkitkdeauth.sh | +| bar | Barra. | hyde-shell waybar --watch | +| battery_notify | Script de notificação da bateria. | batterynotify.sh | +| dbus_share_picker | Share picker do DBus. | dbus-update-activation-environment --systemd --all | +| idle_daemon | Gerenciador de ociosidade. | hypridle | +| image_clipboard | Área de transferência de imagens. | wl-paste --type image --watch cliphist store | +| network_manager | Gerenciador de rede. | nm-applet --indicator | +| notifications | Notificações. | swaync | +| removable_media | Gerenciador de mídias removíveis. | udiskie --no-automount --smart-tray | +| systemd_share_picker | Share picker do systemd. | systemctl --user import-environment QT_QPA_PLATFORMTHEME WAYLAND_DISPLAY XDG_CURRENT_DESKTOP | +| text_clipboard | Área de transferência do texto. | wl-paste --type text --watch cliphist store | +| wallpaper | Script do papel de parede. | $scrPath/wallpaper.sh --global | +| xdg_portal_reset | Script de reset do XDG-Portal. | resetxdgportal.sh | ### [mediaplayer] -mediaplayer.py configuration. +Configuração do mediaplayer.py. | Key | Description | Default | | --- | ----------- | ------- | -| artist_track_separator | Separator symbols to display between artist and track. |   | -| max_length | Max length of song and artist string. | 70 | -| prefix_paused | Prefix for paused media. |   | -| prefix_playing | Prefix for playing media. |  | -| standby_text | To display on standby. |  Music | +| artist_track_separator | Simbolo do separador para mostrar entre o artista e a música. |   | +| max_length | Tamanho máximo para o string da música e artista. | 70 | +| prefix_paused | Prefixo para mídia pausada. |   | +| prefix_playing | Prefixo para mídia tocando. |  | +| standby_text | Prefix para standby. |  Music | ### [notification] -Notification script configuration. +Configuração do script de notificação. | Key | Description | Default | | --- | ----------- | ------- | -| font | Font for notifications. | mononoki Nerd Font | -| font_size | Font size for notifications. | 10 | +| font | Fonte para notificações. | mononoki Nerd Font | +| font_size | Tamanho da fonte para notificações. | 10 | ### [rofi] -Global rofi configuration. +Configuração global do Rofi. | Key | Description | Default | | --- | ----------- | ------- | -| scale | Rofi default scaling. | 10 | +| scale | Escala para o Rofi. | 10 | ### [rofi.animation] -'animation.sh select' configuration. +Configuração do 'animation.sh select'. | Key | Description | Default | | --- | ----------- | ------- | -| scale | Scaling for animation. | 10 | +| scale | Escala para a animação. | 10 | ### [rofi.cliphist] -cliphist.sh configuration. +Configuração do cliphist.sh. | Key | Description | Default | | --- | ----------- | ------- | -| scale | Scaling for cliphist. | 10 | +| scale | Escala para o cliphist.sh. | 10 | ### [rofi.emoji] -emoji-picker.sh configuration. +Configuração para o emoji-picker.sh. | Key | Description | Default | | --- | ----------- | ------- | -| scale | Scaling for emoji picker. | 10 | -| style | Style for emoji picker. | 1 | +| scale | Escala para o seletor de emojis. | 10 | +| style | Estilo para o seletor de emojis. | 1 | ### [rofi.glyph] -glyph-picker.sh configuration. +Configuração do glyph-picker.sh. | Key | Description | Default | | --- | ----------- | ------- | -| scale | Scaling for glyph picker. | 10 | +| scale | Escala para o glyph-picker.sh. | 10 | ### [rofi.hyprlock] -'hyprlock.sh select' configuration. +Configuração do 'hyprlock.sh select'. | Key | Description | Default | | --- | ----------- | ------- | -| scale | Scaling for hyprlock. | 10 | +| scale | Escala para o hyprlock. | 10 | ### [rofi.launch] -rofilaunch.sh configuration. +Configuração para o rofilaunch.sh | Key | Description | Default | | --- | ----------- | ------- | -| drun_args | Additional arguments for drun mode. | [] | -| filebrowser_args | Additional arguments for filebrowser mode. | [] | -| run_args | Additional arguments for run mode. | [] | -| scale | Scaling for launch. | 5 | -| window_args | Additional arguments for window mode. | [] | +| drun_args | Argumentos adicionais para o modo drun. | [] | +| filebrowser_args | Argumentos adicionais para o modo filebrowser. | [] | +| run_args | Argumentos adicionais para o modo run. | [] | +| scale | Escala para abertura. | 5 | +| window_args | Argumentos adicionais para o modo window. | [] | ### [rofi.theme] -themeselect.sh configuration. +Configuração do themeselect.sh. | Key | Description | Default | | --- | ----------- | ------- | -| scale | Scaling for theme selector. | 6 | +| scale | Escala para o seletor de temas. | 6 | ### [rofi.wallpaper] -swwwallselect.sh configuration. +Configuração para o swwwallselect.sh. | Key | Description | Default | | --- | ----------- | ------- | -| scale | Scaling for wallpaper. | 10 | +| scale | Escala para o papel de parede. | 10 | ### [rofi.keybind.hint] -keybind_hint.sh configuration. +Configuração do keybind_hint.sh. | Key | Description | Default | | --- | ----------- | ------- | -| delimiter | Delimiter for keybind hints. | | -| height | Height for keybind hints. | 40em | -| line | Number of lines for keybind hints. | 16 | -| width | Width for keybind hints. | 40em | +| delimiter | Delimitador para sugestões de teclas. | | +| height | Altura para sugestões de teclas. | 40em | +| line | Número de linhas para sugestões de teclas. | 16 | +| width | Largura para sugestões de teclas. | 40em | ### [screenshot] -screenshot.sh configuration. +Configuração do screenshot.sh. | Key | Description | Default | | --- | ----------- | ------- | -| annotation_post_command | Post command for annotation tool. | [""] | -| annotation_pre_command | Pre command for annotation tool. | [] | -| annotation_tool | Annotation tool for screenshots. | satty | +| annotation_post_command | Comando a executar após a captura de tela. | [""] | +| annotation_pre_command | Comando a executar antes da captura de tela. | [] | +| annotation_tool | Ferramenta de anotação para capturas de tela. | satty | ### [sysmonitor] -sysmonlaunch.sh configuration. +Configuração do sysmonlaunch.sh. | Key | Description | Default | | --- | ----------- | ------- | -| commands | Fallback command options. | [""] | -| execute | Default command to execute. | | +| commands | Opções do comando de fallback. | [""] | +| execute | Comando padrão para executar. | | ### [volume] -volumecontrol.sh configuration. +Configuração do volumecontrol.sh. | Key | Description | Default | | --- | ----------- | ------- | -| boost | Enable volume boost. | false | -| boost_limit | Volume boost limit. | 120 | -| notify | Enable notifications for volume control. | true | -| steps | Number of steps to increase/decrease volume. | 5 | +| boost | Habilitar amplificação do volume. | false | +| boost_limit | Limite da amplificação do volume. | 120 | +| notify | Habilitar notificações para controle do volume. | true | +| steps | número de passos para incrementar/reduzir o volume. | 5 | ### [wallbash] -wallbash configuration. +Configuração do wallbash. | Key | Description | Default | | --- | ----------- | ------- | -| skip_template | Templates to skip when using wallbash. | [""] | +| skip_template | Templates a serem ignorados pelo wallbash. | [""] | ### [wallpaper] -Wallpaper configuration. +Configuração do papel de parede | Key | Description | Default | | --- | ----------- | ------- | -| backend | Wallpaper backend, requires 'wallpaper..sh' as handler script in $PATH | swww | -| custom_paths | List of paths to search for wallpapers. | [] | +| backend | Backend do papel de parede, requer o script 'wallpaper..sh' no $PATH para funcionar | swww | +| custom_paths | Lista de caminhos para procurar papéis de parede | [] | ### [wallpaper.swww] -swwwallselect.sh configuration. +Configuração do swwwallselect.sh | Key | Description | Default | | --- | ----------- | ------- | -| duration | Transition duration. | 1 | -| framerate | Transition framerate. | 60 | -| transition_default | Transition type for default wallpaper. | grow | -| transition_next | Transition type for next wallpaper. | grow | -| transition_prev | Transition type for previous wallpaper. | outer | +| duration | Duração da transição do papel de parede. | 1 | +| framerate | Framerate da transição do papel de parede. | 60 | +| transition_default | Modo de transição do papel de parede padrão. | grow | +| transition_next | Modo de transição para o próximo papel de parede. | grow | +| transition_prev | Modo de transição para o papel de parede anterior. | outer | ### [waybar] -waybar configuration. +Configuração do waybar. | Key | Description | Default | | --- | ----------- | ------- | -| font | Font for waybar. | JetBrainsMono Nerd Font | -| icon_size | Icon size for waybar. | 10 | -| scale | Total scaling for waybar. | 10 | +| font | Fonte para o waybar. | JetBrainsMono Nerd Font | +| icon_size | Tamanho dos ícones do waybar. | 10 | +| scale | Escala global do waybar. | 10 | ### [weather] -Weather configuration. +Configuração do módulo do clima. | Key | Description | Default | | --- | ----------- | ------- | -| forecast_days | Number of days to show forecast (0-3). | 3 | -| location | Location/coordinates string for the weather output. | | -| show_icon | Show the weather icon in waybar. | true | -| show_location | Show the location in waybar. | true | -| show_today | Show detailed description of today in tooltip. | true | -| temperature_unit | Temperature unit ('c' or 'f'). | c | -| time_format | Time format ('12h' or '24h'). | 24h | -| windspeed_unit | Windspeed unit ('km/h' or 'mph'). | km/h | +| forecast_days | número de dias a serem mostrados na previsão (0-3). | 3 | +| location | Localização/coordenadas para o clima. | | +| show_icon | Mostra o ícone do clima no waybar. | true | +| show_location | Mostra a localização no waybar. | true | +| show_today | Mostra descrição detalhada de hoje no tooltip. | true | +| temperature_unit | Unidade de temperatura ('c' ou 'f'). | c | +| time_format | Formato da hora ('12h' ou '24h'). | 24h | +| windspeed_unit | Unidade da velocidade do vento ('km/h' ou 'mph'). | km/h | ### [wlogout] -wlogout configuration. +Configuração do wlogout. | Key | Description | Default | | --- | ----------- | ------- | -| style | Style for wlogout. | 2 | - +| style | Estilo para o wlogout. | 2 | From 9e01a351a45c89fc467a8f1e8e42806599ba12fb Mon Sep 17 00:00:00 2001 From: Mircas001 <79532341+Mircas001@users.noreply.github.com> Date: Tue, 15 Jul 2025 13:04:50 -0300 Subject: [PATCH 14/24] docs: Translate hyprland.md to pt --- src/content/docs/pt/configuring/hyprland.md | 56 ++++++++++----------- 1 file changed, 28 insertions(+), 28 deletions(-) diff --git a/src/content/docs/pt/configuring/hyprland.md b/src/content/docs/pt/configuring/hyprland.md index 1f87f1e..3cf0db9 100644 --- a/src/content/docs/pt/configuring/hyprland.md +++ b/src/content/docs/pt/configuring/hyprland.md @@ -1,13 +1,13 @@ --- title: Hyprland -description: Hyprland related configuration +description: Configurações relacionadas ao Hyprland sidebar: order: 3 --- -# Configuration Tree +# Árvore de configuração ``` . 📂 ~/.config/hypr @@ -36,57 +36,57 @@ sidebar: :::caution -**Read the [Hyprland Wiki](https://wiki.hyprland.org/) first!** +**Leia a [_Wiki_ do _Hyprland_](https://wiki.hyprland.org/) primeiro!** ::: -# HyDE's Hyprland Configuration +# Configuração do _Hyprland_ do _HyDE_ -Since Hyprland sources `~/.config/hypr/hyprland.conf`, HyDE's hyprland configuration is divided into three sections: +Como o _Hyprland_ importa o `~/.config/hypr/hyprland.conf`, a configuração do _Hyprland_ do _HyDE_ é dividida em três seções: -- [Boilerplate](#1-boilerplate) -- [Overrides](#2-overrides) -- [Users](#3-users) +- [Modelo base](#1-boilerplate) +- [Sobrescrições](#2-overrides) +- [Usuários](#3-users) -## 1. Boilerplate +## 1. Modelo base -This section contains the default configuration of HyDE. It is recommended not to change this section. +Essa seção contêm a configuração padrão do _HyDE_. Não é recomendado mudar esta seção. -**Filepath:** `$XDG_DATA_HOME/hyde/hyprland.conf` +**Caminho:** `$XDG_DATA_HOME/hyde/hyprland.conf` -This file is sourced on top of other configurations in `~/.config/hypr/hyprland.conf`. +Essa configuração é importada em cima de outras configurações em `~/.config/hypr/hyprland.conf`. ```ini # Boilerplate configuration source = ~/.local/share/hyde/hyprland.conf ``` -## 2. Overrides +## 2. Sobreescrições -This section is for overriding the default configuration of HyDE. +Essa seção é para sobrescrever a configuração padrão do _HyDE_. :::caution -The `xdg_config/hypr/hyde.conf` file is deprecated. Use `xdg_config/hyde/config.toml` instead. +O arquivo `xdg_config/hypr/hyde.conf` é obsoleto. Use `xdg_config/hyde/config.toml` em vez disso. ::: -To override HyDE's default Hyprland settings, configure these sections in your `config.toml`: +Para sobrescrever a configuração padrão, configure estas seções no seu `config.toml`: -- **[hyprland]** - Application defaults, theming, and display settings -- **[hyprland_start]** - Startup commands and services +- **[hyprland]** - Aplicativos padrão, temas e configurações de display. +- **[hyprland_start]** - Comandos na inicialização e serviços. -**Configuration File:** `$XDG_STATE_HOME/hyde/hyprland.conf` +**Arquivo de configuração:** `$XDG_STATE_HOME/hyde/hyprland.conf` -For detailed options, see: +Para opções mais detalhadas, veja: - [hyprland configuration](../config_toml/#hyprland) - [hyprland_start configuration](../config_toml/#hyprland_start) -## 3. Users +## 3. Usuário; -This section is for user configuration. It is recommended to change this section to your liking. +Essa seção é para configuração do usuário. É recomendado mudar esta seção de acordo com seu gosto. -**Filepaths:** +**Caminhos:** - `./keybindings.conf` - `./windowrules.conf` @@ -97,13 +97,13 @@ This section is for user configuration. It is recommended to change this section :::tip -Likely you only need this files to configure your preferences. -Hyprland variables can be overridden, therefore you can change the default values to your liking. +Você provavelmente só precisa destes arquivos para configurar suas preferências. +As variáveis do _Hyprland_ podem ser sobrescritas, logo você pode mudar os valores padrão de acordo com seu gosto. -Also Hyprland can hot reload the configuration files, so you can edit them and see the changes immediately. +O _Hyprland_ pode recarregar instantaneamente os arquivos de configuração, então você pode editá-los, e ver as mudanças imediatamente. ::: -Now you should know which file is which. Refer to the [Hyprland Wiki](https://wiki.hyprland.org) for more information and to achieve your perfect desktop experience. +Agora você deve saber qual arquivo é responsável pelo oque. Refira-se a [_Wiki_ do _Hyprland_](https://wiki.hyprland.org) para mais informações e para conseguir sua experiência de _desktop_ perfeita. -Also see [FAQs and Tips](../help/faq#how-can-i-change-keyboard-layout). +Também veja [Duvidas Frequentes e Dicas](../help/faq#how-can-i-change-keyboard-layout). From 9d8e370fe46d4f32cf55568477933bf8342a2613 Mon Sep 17 00:00:00 2001 From: Mircas001 <79532341+Mircas001@users.noreply.github.com> Date: Tue, 15 Jul 2025 13:47:07 -0300 Subject: [PATCH 15/24] docs: Add warning that hyprland is in english --- src/content/docs/pt/configuring/hyprland.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/pt/configuring/hyprland.md b/src/content/docs/pt/configuring/hyprland.md index 3cf0db9..feea273 100644 --- a/src/content/docs/pt/configuring/hyprland.md +++ b/src/content/docs/pt/configuring/hyprland.md @@ -36,7 +36,7 @@ sidebar: :::caution -**Leia a [_Wiki_ do _Hyprland_](https://wiki.hyprland.org/) primeiro!** +**Leia a [_Wiki_ do _Hyprland_](https://wiki.hyprland.org/) (Em inglês) primeiro!** ::: From 9363e2b955b37849dd32fe21825b48ee5914d4db Mon Sep 17 00:00:00 2001 From: Mircas001 <79532341+Mircas001@users.noreply.github.com> Date: Thu, 17 Jul 2025 16:27:21 -0300 Subject: [PATCH 16/24] docs: Update waybar.md --- src/content/docs/pt/configuring/waybar.md | 224 +++++++++++----------- 1 file changed, 107 insertions(+), 117 deletions(-) diff --git a/src/content/docs/pt/configuring/waybar.md b/src/content/docs/pt/configuring/waybar.md index 3bb81dc..7663be5 100644 --- a/src/content/docs/pt/configuring/waybar.md +++ b/src/content/docs/pt/configuring/waybar.md @@ -1,9 +1,9 @@ --- title: Waybar -description: Waybar Configuration +description: Configuração do Waybar --- -## Configuration Tree +## Árvore de configuração ```text 📂 ~/.config/waybar/ @@ -19,28 +19,28 @@ description: Waybar Configuration ``` - **config.jsonc** - - Copy of a layout configuration. See [layouts](#layouts). - - A transient file therefore edits must be saved at `~/.config/waybar/layouts/` + - Cópia de uma configuração de layout. See [layouts](#layouts). + - Um arquivo transitório, logo quaisquer mudanças devem ser feitas em `~/.config/waybar/layouts/`. - **style.css** - - Auto-generated file. - - style.css imports 3 files: - - **Current** `styles/*.css` that matches the `layout.jsonc`. See [styles](#styles) - - **theme.css** generated by themes and this can override the selected style. - - **user-style.css** is an optional file where you can add your own overrides. You can also test your CSS in here. + - Arquivo gerado automaticamente. + - O style.css importa 3 arquivos: + - **Current :** O `styles/*.css` que bate com o `layout.jsonc`. Veja [Estilos](#estilos) + - **theme.css :** É gerado por temas e pode sobrescrever o estilo selecionado. + - **user-style.css :** É um arquivo opcional onde você pode adicionar suas próprias sobrescrições. Você também pode testar seu CSS aqui. - **theme.css** - - Theme generated file. + - Arquivo gerado pelo tema. :::note -You should know that the `xdg_share/waybar` (~/.local/share/waybar) is a directory that is provided by HyDE. NEVER edit the files in this directory, as they will be overwritten on updates. You should instead edit your own `~/.config/waybar` directory! +Você deve saber que o `xdg_share/waybar` (~/.local/share/waybar) é uma pasta providenciada pelo HyDE. NUNCA faça alterações nesta pasta, já que elas serão sobrescritas nas atualizações. Você deve, em vez disso, editar seu próprio diretório `~/.config/waybar`! -Take note that both have the same structure and I suggest you to copy the files from `xdg_share/waybar` to `~/.config/waybar` and edit them there. +Leve em conta que ambas tem a mesma estrutura e que eu sugiro que você copie os arquivos do `xdg_share/waybar` para o `~/.config/waybar`, e os edite lá. ::: -### Modules +### Módulos -Directory: `./modules/` +Pasta: `./modules/` ```text └── 📂 modules/ @@ -57,11 +57,11 @@ Directory: `./modules/` └── 📄 wlr-taskbar.jsonc ``` -- Store all modules in `~/.config/waybar/modules/`. -- Files in here are recursively added as entry in `includes/includes.jsonc` -- All modules under a specific tree will have the `parent-child` convention. Example: `custom/cpuinfo` will be converted into `custom-cpuinfo`. This is used to easily determine the class name in CSS without confusion. +- Guarda todos os módulos em `~/.config/waybar/modules/`. +- Arquivos aqui são recursivamente adicionados como entrada no `includes/includes.jsonc`. +- Todos os módulos em uma árvore especifica seguirão a convenção `pai-filho`. Exemplo: `custom/cpuinfo` será convertido em `custom-cpuinfo`. Isto é usada para facilmente determinar o nome da classe no CSS, evitando confusões. -Example: +Exemplo: ```css .custom-cpuinfo { padding: 1em; @@ -70,7 +70,7 @@ Example: ### Layouts -Directory: `./layouts/` +Pasta: `./layouts/` ```text └── 📂 layouts/ @@ -81,17 +81,17 @@ Directory: `./layouts/` └── 📄 ....jsonc ``` -HyDE stores all the ready-to-use configurations in the `layouts/` directory. These can be navigated using the `waybar.py` script. +O HyDE guarda todos os layouts prontos para usar na pasta `layouts/`. Essas configurações podem ser navegados utilizando o script `hyde-shell waybar` :::note -If users accidentally configure `./waybar/config.jsonc`, it will be moved to `~/.config/waybar/layouts/backup/name_timestamp.jsonc`. Even with these measures, we encourage creating a copy of your configuration in `~/.config/waybar/layouts/`. +Se um usuário acidentalmente configurar o `./waybar/config.jsonc`, ela será movida para o `~/.config/waybar/layouts/backup/name_timestamp.jsonc`. Mesmo com essas medidas, nós te encorajamos a criar uma cópia de sua configuração em `~/.config/waybar/layouts/`. ::: -For CSS styling of the layouts see [styles](#styles). +Para a estilização veja [Estilos](#estilos). -### Styles +### Estilos -Directory: `./styles/` +Pasta: `./styles/` ```text └── 📂 styles/ @@ -103,14 +103,14 @@ Directory: `./styles/` └── 📄 ...*.css ``` -The `styles/` directory contains the counterpart CSS files for layouts. -When choosing a layout, HyDE will try to use the equivalent CSS style by matching the base names e.g. `khing.jsonc` will use `khing.css`. +A pasta `styles/` contem os arquivos CSS contraparte para os layouts. +Quando você escolhe o layout, o HyDE tentará utilizar o estilo CSS equivalente correspondendo os nomes-base. `khing.jsonc` utilizará o `khing.css`. -Explicit `--config ` and `--style ` options are also supported. +Explicitar as opções `--config ` e o `--style ` também é suportado. ### Includes -Directory: `./includes/` +Pasta: `./includes/` ```text └── 📂 includes/ @@ -120,44 +120,42 @@ Directory: `./includes/` ``` - **border-radius.css** - - Dynamic border radius for the [groups](#groups). + - Border-radius dinâmico para os [grupos](#groups). -#### Dynamic Border-Radius Preview +#### Visualização do Border-Radius Dinâmico -**No Rounding** in Hyprland +**Nenhum arredondamento** no Hyprland -![0 rounding in hyprland](../../../../assets/waybar/rounding-0.png) +![0 arredondamento no hyprland](../../../../assets/waybar/rounding-0.png) -**Squircle** 10 rounding in Hyprland +**Squircle** arredondamento 10 no Hyprland -![10 rounding in hyprland](../../../../assets/waybar/rounding-10.png) +![10 arredondamento no hyprland](../../../../assets/waybar/rounding-10.png) -**Circle** 100 rounding in Hyprland +**Circulo** arredondamento 100 no Hyprland ![100 rounding in hyprland](../../../../assets/waybar/rounding-100.png) -**Get the Idea?** +**Entendeu?** -- **global.css** - Includes the dynamic font-size and font-family. This is dynamic so that themes can override these values via the `hypr.theme` >> `$BAR_FONT` +- **global.css** - Inclui o font-size dinâmico, e o font-family. Isso é dinâmico, então temas podem sobrescrever estes valores por via do `hypr.theme` >> `$BAR_FONT`. ### Menus -Directory: `./menus/` +Pasta: `./menus/` -Stores all the GTK Object XML files. To correctly manage the files we added the GObject XML files in `~/.config/waybar/menus/` +Guarda todos os arquivos XML de objetos GTK. Para corretamente gerenciar os arquivos, adicionamos os arquivos GObject XML em `~/.config/waybar/menus/` -## Group Class for Styling +## Classe de Grupo para Estilização -You should know that Waybar ONLY provides 3 positioning options for the modules: `modules-left`, `modules-center` and `modules-right`. To achieve the desired positioning or the popular pill effect, we need to use the `group` class. +Você deve saber que o Waybar apenas providencia 3 opções de posicionamento para seus módulos: `modules-left` (Esquerda), `modules-center` (Centro) e `modules-right` (Direita). Para obter o posicionamento desejado ou o popular efeito de "pílula", devemos usar a classe `group`. For example: -![Groups in pill shape](../../../../assets/waybar/groups.png) +![Grupos em formato de "pílula"](../../../../assets/waybar/groups.png) -Contents of `../waybar/styles/groups/` are used for styling the border-radius of the given group. Groups are the combination of modules - some call them islands. +Os conteúdos do `../waybar/styles/groups/` são utilizados para estilizar o `border-radius`. Grupos são as combinações de módulos, vamos chamar eles de ilhas. -In HyDE, to be able to make use of the groups, we can declare modules in a group first: - -Example in `~/.config/waybar/layouts/my_config.jsonc`: +Exemplo em `~/.config/waybar/layouts/my_config.jsonc`: ```jsonc { @@ -171,7 +169,7 @@ Example in `~/.config/waybar/layouts/my_config.jsonc`: } ``` -Now we can add the group in the waybar modules: +Agora podemos adicionar nosso grupo nos módulos Waybar: ```jsonc { @@ -183,7 +181,7 @@ Now we can add the group in the waybar modules: } ``` -**Styling** this is easy as we already group the modules. In this way we can use the group name as the class name: +**Estilização:** Isso é fácil, já que já agrupamos os módulos. Dessa maneira podemos utilizar o nome do grupo como o nome da classe. ```css #pill, @@ -192,19 +190,18 @@ Now we can add the group in the waybar modules: } ``` -**Note:** `pill` and `pill#tag*` have a class name of `pill`. This is waybar convention to enable users to add a similar module but sharing common class name. - +**Nota:** `pill` e `pill#tag*` usam o nome de classe `pill`. Esta é uma convenção do Waybar que permite aos usuários adicionar módulos semelhantes compartilhando o mesmo nome de classe. -## Making your own waybar layout +## Criando seu próprio layout Waybar :::note -This is a very shallow guide. You should follow the [waybar Wiki](https://github.com/Alexays/Waybar/wiki/Configuration) for more information. +Essa é uma guia muito rasa, você deve seguir a [Wiki do Waybar](https://github.com/Alexays/Waybar/wiki/Configuration) para mais informações. ::: -### This is the full layout file used for the instructions +### Este é o arquivo do layout inteiro usada pelas instruções
MyBar.jsonc @@ -213,7 +210,7 @@ This is a very shallow guide. You should follow the [waybar Wiki](https://github { /* ┌─────────────────────────────────────────────────────────────────────────────┐ - │ Global Options for the Waybar configuration │ + │ Opções globais para a configuração do Waybar │ └─────────────────────────────────────────────────────────────────────────────┘ */ @@ -225,19 +222,15 @@ This is a very shallow guide. You should follow the [waybar Wiki](https://github /* ┌────────────────────────────────────────────────────────────────────────────┐ │ │ - │ This is one of the vital part of the configuration, it allows you to │ - │ include other │ - │ files │ - │ The `"$XDG_CONFIG_HOME/waybar/includes/includes.json"` is auto generated │ - │ by the waybar.py │ - │ script. │ - │ 1. Includes all the modules in `./waybar/modules` │ - │ 2. Resolves all the size for the icons that the style.css in waybar │ - │ CANNOT │ - │ handle │ - │ 3. Of course this is optional, you can remove it if you don't want to use │ - │ it and │ - │ include your own set of modules. │ + │ Isso é uma das partes vitais da configuração, ela permite que você │ + │ inclua outros arquivos │ + │ O `"$XDG_CONFIG_HOME/waybar/includes/includes.json"` é gerado pelo │ + │ waybar.py automaticamente: │ + │ 1. Inclui todos os módulos em `./waybar/modules │ + │ 2. Resolve todos os tamanhos para os icones que o style.css do waybar não │ + │ consegue lidar │ + │ 3. Isto obviamente é opcional, e você pode removê-lo se não quer usa-lo, e │ + │ incluir seu próprio conjunto de módulos │ │ │ └────────────────────────────────────────────────────────────────────────────┘ */ @@ -246,17 +239,17 @@ This is a very shallow guide. You should follow the [waybar Wiki](https://github /* ┌────────────────────────────────────────────────────────────────────────────┐ - │ Declare the modules inside your desired group shapes │ - │ As of now we have: │ + │ Declare os módulos dentro de seus grupos desejados. │ + │ Atualmente temos: │ │ │ - │ - pill-left - the curve is facing left │ - │ - pill-right - the curve is facing right │ - │ - pill-up - the curve is facing up │ - │ - pill-down - the curve is facing down │ - │ - pill-in - the curve is facing inwards no matter the position │ - │ - pill-out - the curve is facing outwards no matter the position │ - │ - leaf - a leaf shape │ - │ - leaf-inverse - a leaf shape but inverted │ + │ - pill-left - a curva está voltada para a esquerda │ + │ - pill-right - a curva está voltada para a direita │ + │ - pill-up - a curva está voltada para cima │ + │ - pill-down - a curva está voltada para baixo │ + │ - pill-in - a curva está voltada para dentro, não importa a posição │ + │ - pill-out - a curva está voltada para fora, não importa a posição │ + │ - leaf - um formato de folha │ + │ - leaf-inverse - um formato de folha, só que invertida │ │ │ └────────────────────────────────────────────────────────────────────────────┘ */ @@ -296,8 +289,7 @@ This is a very shallow guide. You should follow the [waybar Wiki](https://github /* ┌─────────────────────────────────────────────────────────────────────────┐ - │ Re-using a group is simple, You just need to add a #tag to the group │ - │ name. │ + │ Reusar um grupo é simples, basta adicionar um #tag ao nome do grupo │ └─────────────────────────────────────────────────────────────────────────┘ */ @@ -311,11 +303,9 @@ This is a very shallow guide. You should follow the [waybar Wiki](https://github }, /* - ┌────────────────────────────────────────────────────────────────────────────┐ - │ │ - │ Declare the groups in the module position provided by waybar │ - │ │ - └────────────────────────────────────────────────────────────────────────────┘ + ┌─────────────────────────────────────────────────────────────────────────┐ + │ Declare os grupos na posição do módulo providenciada pelo waybar │ + └─────────────────────────────────────────────────────────────────────────┘ */ "modules-left": ["group/pill-left", "group/pill-down", "group/pill-up"], "modules-center": ["group/leaf", "group/pill-in", "group/leaf-inverse"], @@ -331,19 +321,19 @@ This is a very shallow guide. You should follow the [waybar Wiki](https://github
-### Step-by-Step Guide +### Guia passo-a-passo -#### Step 1: Create Your Configuration File +#### Passo 1: Crie seu arquivo de configuração -Start by creating a new file `~/.config/waybar/layouts/my_config.jsonc` or copy one of the existing ones from `~/.local/share/waybar/layouts/`. +Comecr criando um arquivo como: `~/.config/waybar/layouts/my_config.jsonc` ou copie um dos arquivos existentes do `~/.local/share/waybar/layouts/`. ```bash cp ~/.local/share/waybar/layouts/layout-1.jsonc ~/.config/waybar/layouts/my_config.jsonc ``` -#### Step 2: Add Global Configuration Options +#### Passo 2: Adicione opções de configuração global -Begin with the essential global configurations that define the basic behavior of your waybar: +Comece com todas as configurações globais essenciais que definem o comportamento básico de seu Waybar. ```jsonc { @@ -353,27 +343,27 @@ Begin with the essential global configurations that define the basic behavior of "reload_style_on_change": true, // Auto-reload when style file changes ``` -#### Step 3: Include HyDE Module Definitions +#### Passo 3: Inclua definições de módulos HyDE. -Add the include directive to automatically load all HyDE modules and configurations: +Adicione a diretiva `include` para automaticamente carregar todos os módulos e configurações HyDE. ```jsonc "include": ["$XDG_CONFIG_HOME/waybar/includes/includes.json"], ``` :::tip -The `includes.json` file is auto-generated by HyDE's `waybar.py` script and provides: -- All modules from `./waybar/modules/` -- Icon size configurations that CSS cannot handle -- Dynamic configurations specific to HyDE +O arquivo `includes.json` é automaticamente gerado pelo script `waybar.py` e providência: +- Todos os módulos do `./waybar/modules/` +- Configuração dos tamanhos dos icones que o CSS não consegue lidar. +- Configurações dinâmicas especificas para o HyDE. ::: #### Step 4: Define Group Shapes -HyDE provides several predefined group shapes for creating pill effects and custom layouts. Define your groups before assigning modules: +O HyDE providencia vários formatos de grupo predefinidos para criar layouts customizados e efeitos de pílula. Defina seus grupos antes de atribuir módulos: ```jsonc - // Available group shapes: + // Grupos de formato dísponiveis: // pill-left, pill-right, pill-up, pill-down // pill-in, pill-out, leaf, leaf-inverse @@ -411,9 +401,9 @@ HyDE provides several predefined group shapes for creating pill effects and cust }, ``` -#### Step 5: Reuse Groups with Tags +#### Passo 5: Reusar grupos com tags -You can reuse the same group shape multiple times by adding tags (`#tagname`): +Você pode reusar o mesmo grupo de formato múltiplas vezes adicionando tags (`#nomedatag`): ```jsonc "group/pill-down#right": { @@ -426,9 +416,9 @@ You can reuse the same group shape multiple times by adding tags (`#tagname`): }, ``` -#### Step 6: Arrange Groups in Module Positions +#### Step 6: Organize grupos nas posições de módulo -Finally, assign your groups to the three available positions: +Finalmente, atribua seus grupos para às três posições disponíveis: ```jsonc "modules-left": ["group/pill-left", "group/pill-down", "group/pill-up"], @@ -441,40 +431,40 @@ Finally, assign your groups to the three available positions: } ``` -#### Step 7: Apply Your Configuration +#### Passo 7: Aplique sua configuração -To use your new layout, run: +Para usar seu novo layout, execute: ```bash # Navigate to your layouts using rofi -waybar.py -S +hyde-shell waybar -S # Or apply directly -waybar -c ~/.config/waybar/layouts/my_config.jsonc +hyde-shell waybar -c ~/.config/waybar/layouts/minha_configuração.jsonc ``` ![alt text](/src/assets/waybar/selector.png) :::note -See ./waybar.py --help for more options. +Veja hyde-shell waybar --help para mais opções. ::: ### Available Group Shapes -| Shape | Description | +| Formato | Descrição | |-------|-------------| -| `pill-left` | Curve facing left | -| `pill-right` | Curve facing right | -| `pill-up` | Curve facing up | -| `pill-down` | Curve facing down | -| `pill-in` | Curve facing inwards regardless of position | -| `pill-out` | Curve facing outwards regardless of position | -| `leaf` | Leaf shape | -| `leaf-inverse` | Inverted leaf shape | +| `pill-left` | Curva voltada para a esquerda | +| `pill-right` | Curva voltada para a direita | +| `pill-up` | Curva voltada para cima | +| `pill-down` | Curva voltada para baixo | +| `pill-in` | Curva voltada para dentro, não importa a posição | +| `pill-out` | Curva voltada para dentro, não importa a posição | +| `leaf` | Formato de folha | +| `leaf-inverse` | Formato de folha invertida. | -### Customizing Module Content +### Customizando conteúdo do módulo -To customize individual modules, edit the files in `~/.config/waybar/modules/` or create new ones following the naming convention described in the [Modules](#modules) section. +Para customizar módulos individuais, edite os arquivos em `~/.config/waybar/modules/` ou crie novos seguindo a convenção de nomenclatura descrita em [Modules](#modules) section. From d056ea94db1064b0a7fdd5609a0efab6e376b396 Mon Sep 17 00:00:00 2001 From: Mircas001 <79532341+Mircas001@users.noreply.github.com> Date: Thu, 17 Jul 2025 16:28:38 -0300 Subject: [PATCH 17/24] docs: Update hyprland.md --- src/content/docs/pt/configuring/hyprland.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/src/content/docs/pt/configuring/hyprland.md b/src/content/docs/pt/configuring/hyprland.md index feea273..3e15b61 100644 --- a/src/content/docs/pt/configuring/hyprland.md +++ b/src/content/docs/pt/configuring/hyprland.md @@ -36,13 +36,13 @@ sidebar: :::caution -**Leia a [_Wiki_ do _Hyprland_](https://wiki.hyprland.org/) (Em inglês) primeiro!** +**Leia a [Wiki do Hyprland](https://wiki.hyprland.org/) (Em inglês) primeiro!** ::: -# Configuração do _Hyprland_ do _HyDE_ +# Configuração do Hyprland do HyDE -Como o _Hyprland_ importa o `~/.config/hypr/hyprland.conf`, a configuração do _Hyprland_ do _HyDE_ é dividida em três seções: +Como o Hyprland importa o `~/.config/hypr/hyprland.conf`, a configuração do Hyprland do HyDE é dividida em três seções: - [Modelo base](#1-boilerplate) - [Sobrescrições](#2-overrides) @@ -50,7 +50,7 @@ Como o _Hyprland_ importa o `~/.config/hypr/hyprland.conf`, a configuração do ## 1. Modelo base -Essa seção contêm a configuração padrão do _HyDE_. Não é recomendado mudar esta seção. +Essa seção contêm a configuração padrão do HyDE. Não é recomendado mudar esta seção. **Caminho:** `$XDG_DATA_HOME/hyde/hyprland.conf` @@ -63,7 +63,7 @@ source = ~/.local/share/hyde/hyprland.conf ## 2. Sobreescrições -Essa seção é para sobrescrever a configuração padrão do _HyDE_. +Essa seção é para sobrescrever a configuração padrão do HyDE. :::caution @@ -98,12 +98,12 @@ Essa seção é para configuração do usuário. É recomendado mudar esta seç :::tip Você provavelmente só precisa destes arquivos para configurar suas preferências. -As variáveis do _Hyprland_ podem ser sobrescritas, logo você pode mudar os valores padrão de acordo com seu gosto. +As variáveis do Hyprland podem ser sobrescritas, logo você pode mudar os valores padrão de acordo com seu gosto. -O _Hyprland_ pode recarregar instantaneamente os arquivos de configuração, então você pode editá-los, e ver as mudanças imediatamente. +O Hyprland pode recarregar instantaneamente os arquivos de configuração, então você pode editá-los, e ver as mudanças imediatamente. ::: -Agora você deve saber qual arquivo é responsável pelo oque. Refira-se a [_Wiki_ do _Hyprland_](https://wiki.hyprland.org) para mais informações e para conseguir sua experiência de _desktop_ perfeita. +Agora você deve saber qual arquivo é responsável pelo oque. Refira-se a [_Wiki_ do Hyprland](https://wiki.hyprland.org) para mais informações e para conseguir sua experiência de desktop perfeita. Também veja [Duvidas Frequentes e Dicas](../help/faq#how-can-i-change-keyboard-layout). From 22dbeee6b7a6abe457039a55de98f1b75b1bc33f Mon Sep 17 00:00:00 2001 From: Mircas001 <79532341+Mircas001@users.noreply.github.com> Date: Sun, 20 Jul 2025 11:53:23 -0300 Subject: [PATCH 18/24] Update hyde-shell to md instead of mdx, as ut kacks any JSX --- src/content/docs/en/man-pages/{hyde-shell.mdx => hyde-shell.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename src/content/docs/en/man-pages/{hyde-shell.mdx => hyde-shell.md} (100%) diff --git a/src/content/docs/en/man-pages/hyde-shell.mdx b/src/content/docs/en/man-pages/hyde-shell.md similarity index 100% rename from src/content/docs/en/man-pages/hyde-shell.mdx rename to src/content/docs/en/man-pages/hyde-shell.md From cbd14932a1584d047b3d8e25459983593ab2f358 Mon Sep 17 00:00:00 2001 From: Mircas001 <79532341+Mircas001@users.noreply.github.com> Date: Sun, 20 Jul 2025 11:55:07 -0300 Subject: [PATCH 19/24] docs: Update hyde-shell to md as it lacks JSX in pt --- src/content/docs/pt/man-pages/{hyde-shell.mdx => hyde-shell.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename src/content/docs/pt/man-pages/{hyde-shell.mdx => hyde-shell.md} (100%) diff --git a/src/content/docs/pt/man-pages/hyde-shell.mdx b/src/content/docs/pt/man-pages/hyde-shell.md similarity index 100% rename from src/content/docs/pt/man-pages/hyde-shell.mdx rename to src/content/docs/pt/man-pages/hyde-shell.md From 0b1963d1d4958505137f3be1cbc00d4adfe67b47 Mon Sep 17 00:00:00 2001 From: Mircas001 <79532341+Mircas001@users.noreply.github.com> Date: Sun, 20 Jul 2025 11:55:58 -0300 Subject: [PATCH 20/24] docs: Fix number agreement issue. --- src/content/docs/en/man-pages/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/en/man-pages/overview.md b/src/content/docs/en/man-pages/overview.md index c4fb0f9..2a837ed 100644 --- a/src/content/docs/en/man-pages/overview.md +++ b/src/content/docs/en/man-pages/overview.md @@ -1,6 +1,6 @@ --- title: Overview -description: HyDE manuals for scripts and executable +description: HyDE manuals for scripts and executables sidebar: order: 1 --- From aa7b86880ae7e792168ea8269929b0c35a6f328e Mon Sep 17 00:00:00 2001 From: Mircas001 <79532341+Mircas001@users.noreply.github.com> Date: Sun, 20 Jul 2025 11:57:58 -0300 Subject: [PATCH 21/24] docs: Translate overview.md to PT --- src/content/docs/pt/man-pages/overview.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/content/docs/pt/man-pages/overview.md b/src/content/docs/pt/man-pages/overview.md index c4fb0f9..d864265 100644 --- a/src/content/docs/pt/man-pages/overview.md +++ b/src/content/docs/pt/man-pages/overview.md @@ -1,8 +1,8 @@ --- -title: Overview -description: HyDE manuals for scripts and executable +title: Visão Geral +description: Manuais do HyDE para scripts e executáveis. sidebar: order: 1 --- -HyDE manuals for scripts and executables. \ No newline at end of file + Manuais do HyDE para scripts e executáveis. \ No newline at end of file From 712628508c7aaa4f36f99f135cf19d70dd6773f6 Mon Sep 17 00:00:00 2001 From: Mircas001 <79532341+Mircas001@users.noreply.github.com> Date: Sun, 20 Jul 2025 12:19:19 -0300 Subject: [PATCH 22/24] docs: Translate hyde-shell.md --- src/content/docs/pt/man-pages/hyde-shell.md | 76 ++++++++++----------- 1 file changed, 38 insertions(+), 38 deletions(-) diff --git a/src/content/docs/pt/man-pages/hyde-shell.md b/src/content/docs/pt/man-pages/hyde-shell.md index 3ee867c..a97abbf 100644 --- a/src/content/docs/pt/man-pages/hyde-shell.md +++ b/src/content/docs/pt/man-pages/hyde-shell.md @@ -1,91 +1,91 @@ --- title: hyde-shell -description: HyDE's wrapper to execute HyDE scripts and executables. +description: Wrapper do HyDE para executar scripts e executáveis do HyDE. sidebar: order: 2 --- -## Name +## Nome -`hyde-shell` - HyDE script execution wrapper and environment resolver +`hyde-shell` - Wrapper de execução dos scripts do HyDE e resolvedor de ambiente. -## Synopsis +## Sinopse ``` -hyde-shell [command] [arguments...] +hyde-shell [comando] [argumentos...] hyde-shell [--help | help | -h] hyde-shell [-r | reload] ``` -## Description +## Descrição -`hyde-shell` is a universal wrapper script that executes HyDE scripts without file extensions and solves PATH-related issues where users might accidentally overwrite `~/.local/lib/hyde` in their PATH. +`hyde-shell` é um script de wrapper universal que executa scripts do HyDE sem extensões de arquivo e resolve problemas relacionados ao PATH, onde usuários podem acidentalmente sobrescrever `~/.local/lib/hyde` no PATH. -Located in `~/.local/bin/`, `hyde-shell` automatically discovers and executes scripts from the HyDE library directory, handling both Python scripts (.py) and shell scripts (.sh) without requiring file extensions. +Localizado em `~/.local/bin/`, o `hyde-shell` automaticamente descobre e executa scripts do diretório de biblioteca do HyDE, lidando com scripts Python (.py) e scripts shell (.sh) sem precisar de extensões de arquivo. -## Options +## Opções **`--help, help, -h`** -: Display help message showing available commands and usage information. +: Exibe mensagem de ajuda mostrando comandos disponíveis e instruções de uso. **`-r, reload`** -: Reload the HyDE environment and refresh all configurations. +: Recarrega o ambiente HyDE e recarrega todas as configurações. -## Built-in Commands +## Comandos embutidos **`wallbash`** -: Execute a wallbash script for dynamic theming and color management. +: Executa um script wallbash para estilização dinâmica e gerenciamento de cores. -## Script Execution +## Execução de scripts -`hyde-shell` provides access to all HyDE scripts without requiring file extensions: +`hyde-shell` fornece acesso a todos os scripts HyDE sem precisar de extensões de arquivo: ```bash -hyde-shell waybar # Executes waybar.py -hyde-shell theme.import # Executes theme.import.py -hyde-shell wallpaper # Executes wallpaper.sh -hyde-shell screenrecord # Executes screenrecord.sh +hyde-shell waybar # Executa waybar.py +hyde-shell theme.import # Executa theme.import.py +hyde-shell wallpaper # Executa wallpaper.sh +hyde-shell screenrecord # Executa screenrecord.sh ``` -The wrapper automatically discovers and resolves all scripts in the HyDE library directory. +O wrapper automaticamente descobre e resolve todos os scripts no diretório da biblioteca HyDE. ## Usage Examples -Execute any HyDE script without file extension: +Executa qualquer script HyDE sem precisar da extensão do arquivo: ```bash -hyde-shell waybar --help # Run waybar.py with help flag -hyde-shell theme.import # Run theme.import.py -hyde-shell wallpaper # Run wallpaper.sh +hyde-shell waybar --help # Executa waybar.py com o argumento de ajuda +hyde-shell theme.import # Executa theme.import.py +hyde-shell wallpaper # Executa wallpaper.sh ``` -Use built-in commands: +Usa comandos embutidos: ```bash hyde-shell wallbash # Execute wallbash scripts in ~/.config/hyde/wallbash/scripts/ hyde-shell reload # Reload HyDE environment ``` -Pass arguments to underlying scripts: +Passa argumentos para o script subjacente: ```bash -hyde-shell waybar --set layout-1 # Pass arguments to waybar.py +hyde-shell waybar --set layout-1 # Passa arguments para o waybar.py ``` -## Key Features +## Ferramentas chave -- **Script Path Resolution**: Finds scripts in `~/.local/lib/hyde/` regardless of PATH configuration -- **Extension Handling**: Automatically appends appropriate file extensions (.py, .sh) -- **PATH Independence**: Works regardless of current PATH configuration or working directory +- **Resolução do caminho do Script**: Encontra scripts no `~/.local/lib/hyde/` independente da configuração do PATH. +- **Lida com extensões**: Automaticamente acrescenta extensões de arquivo apropriadas (.py, .sh). +- **Independência do PATH**: Funciona de forma independente da configuração atual do HyDE ou do diretório de trabalho. -## Files +## Arquivos **`~/.local/bin/hyde-shell`** -: Main executable wrapper script +: Executável principal do script de wrapper. **`~/.local/lib/hyde/`** -: Directory containing all HyDE scripts and modules +: Diretório contendo todos scripts e módulos HyDE. -## Notes +## Notas -- Always prefer `hyde-shell` over direct script execution for maximum compatibility -- File extensions are optional and automatically resolved -- Future HyDE versions will increasingly rely on `hyde-shell` for script execution +- Sempre prefira `hyde-shell` sobre execução direta dos scripts para máxima compatibilidade. +- Extensões de arquivo são opcionais e automaticamente resolvidas. +- Versões futuras do HyDE vão cada vez mais depender do `hyde-shell` para execução de scripts. From 66b18d229efb8b8a6677a3b9fe9b3ba69d86af15 Mon Sep 17 00:00:00 2001 From: Mircas001 <79532341+Mircas001@users.noreply.github.com> Date: Sun, 20 Jul 2025 12:21:52 -0300 Subject: [PATCH 23/24] docs: Update waybar.md in pt to a better-suited language. --- src/content/docs/pt/configuring/waybar.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/src/content/docs/pt/configuring/waybar.md b/src/content/docs/pt/configuring/waybar.md index 7663be5..199aea4 100644 --- a/src/content/docs/pt/configuring/waybar.md +++ b/src/content/docs/pt/configuring/waybar.md @@ -32,7 +32,7 @@ description: Configuração do Waybar - Arquivo gerado pelo tema. :::note -Você deve saber que o `xdg_share/waybar` (~/.local/share/waybar) é uma pasta providenciada pelo HyDE. NUNCA faça alterações nesta pasta, já que elas serão sobrescritas nas atualizações. Você deve, em vez disso, editar seu próprio diretório `~/.config/waybar`! +Você deve saber que o `xdg_share/waybar` (~/.local/share/waybar) é um diretório providenciada pelo HyDE. NUNCA faça alterações neste diretório, já que elas serão sobrescritas nas atualizações. Você deve, em vez disso, editar seu próprio diretório `~/.config/waybar`! Leve em conta que ambas tem a mesma estrutura e que eu sugiro que você copie os arquivos do `xdg_share/waybar` para o `~/.config/waybar`, e os edite lá. @@ -40,7 +40,7 @@ Leve em conta que ambas tem a mesma estrutura e que eu sugiro que você copie os ### Módulos -Pasta: `./modules/` +Diretório: `./modules/` ```text └── 📂 modules/ @@ -70,7 +70,7 @@ Exemplo: ### Layouts -Pasta: `./layouts/` +Diretório: `./layouts/` ```text └── 📂 layouts/ @@ -81,7 +81,7 @@ Pasta: `./layouts/` └── 📄 ....jsonc ``` -O HyDE guarda todos os layouts prontos para usar na pasta `layouts/`. Essas configurações podem ser navegados utilizando o script `hyde-shell waybar` +O HyDE guarda todos os layouts prontos para usar no diretório `layouts/`. Essas configurações podem ser navegados utilizando o script `hyde-shell waybar` :::note Se um usuário acidentalmente configurar o `./waybar/config.jsonc`, ela será movida para o `~/.config/waybar/layouts/backup/name_timestamp.jsonc`. Mesmo com essas medidas, nós te encorajamos a criar uma cópia de sua configuração em `~/.config/waybar/layouts/`. @@ -91,7 +91,7 @@ Para a estilização veja [Estilos](#estilos). ### Estilos -Pasta: `./styles/` +Diretório: `./styles/` ```text └── 📂 styles/ @@ -103,14 +103,14 @@ Pasta: `./styles/` └── 📄 ...*.css ``` -A pasta `styles/` contem os arquivos CSS contraparte para os layouts. +O diretório `styles/` contem os arquivos CSS contraparte para os layouts. Quando você escolhe o layout, o HyDE tentará utilizar o estilo CSS equivalente correspondendo os nomes-base. `khing.jsonc` utilizará o `khing.css`. Explicitar as opções `--config ` e o `--style ` também é suportado. ### Includes -Pasta: `./includes/` +Diretório: `./includes/` ```text └── 📂 includes/ @@ -142,7 +142,7 @@ Pasta: `./includes/` ### Menus -Pasta: `./menus/` +Diretório: `./menus/` Guarda todos os arquivos XML de objetos GTK. Para corretamente gerenciar os arquivos, adicionamos os arquivos GObject XML em `~/.config/waybar/menus/` From ee6861bc343b000318f620c1b6601a01f219c394 Mon Sep 17 00:00:00 2001 From: Mircas001 <79532341+Mircas001@users.noreply.github.com> Date: Mon, 21 Jul 2025 14:51:49 -0300 Subject: [PATCH 24/24] docs: Translate theme.import.md --- src/content/docs/pt/man-pages/theme.import.md | 42 +++++++++---------- 1 file changed, 21 insertions(+), 21 deletions(-) diff --git a/src/content/docs/pt/man-pages/theme.import.md b/src/content/docs/pt/man-pages/theme.import.md index 2e562e1..c57628e 100644 --- a/src/content/docs/pt/man-pages/theme.import.md +++ b/src/content/docs/pt/man-pages/theme.import.md @@ -1,61 +1,61 @@ --- title: theme.import.py -description: theme import manual page +description: Página do manual do theme import. --- -### Preview +### Prévia ![preview theme import](../../../../assets/man-pages/theme.import/image.png) -### NAME +### NOME -theme.import.py - Imports themes from the HyDE gallery repository +theme.import.py - Importa temas do repositório da galeria do HyDE. ### SYNOPSIS -`theme.import.py` [OPTIONS] +`theme.import.py` [OPÇÕES] -### DESCRIPTION +### DESCRIÇÃO -`theme.import.py` is a script to import and manage themes from the HyDE gallery repository. It allows users to clone the repository, fetch theme data, preview themes, and apply selected themes. +`theme.import.py` é um script para importar e gerenciar temas do repositório da galeria do HyDE. Ele permite que usuários clonem o repositório, busquem dados do tema, vejam uma prévia do tema, e apliquem temas selecionados. -### OPTIONS +### OPÇÕES - `-j`, `--json` - Fetch JSON data after cloning the repository. + Carrega dados JSON após clonar o repositório. - `-S`, `--select` - Select themes using `fzf`. + Seleciona temas usando `fzf`. -- `-p`, `--preview` IMAGE_URL - Get a preview of the specified theme. +- `-p`, `--preview` TEMA. + Mostra uma prévia do tema especificado -- `-t`, `--preview-text` TEXT - Preview text to display when using the `--preview` option. +- `-t`, `--preview-text` TEMA.r + Prévia do texto para mostrar quando usando a opção `--preview`. - `--skip-clone` - Skip cloning the repository. + Pula a clonagem do repositório. - `-f`, `--fetch` THEME - Fetch and update a specific theme by name. Use `all` to fetch all themes located in `xdg_config/hyde/themes`. + Busca e atualiza um tema específico por nome. Use `all` para buscar todos os temas em `xdg_config/hyde/themes`. ### ENVIRONMENT VARIABLES - `LOG_LEVEL` - Set the logging level (default: `INFO`). + Configuração o nível de log (padrão: `INFO`). - `XDG_CACHE_HOME` - Directory for cache files (default: `~/.cache`). + Diretório para o cache (padrão: `~/.cache`). - `XDG_CONFIG_HOME` - Directory for configuration files (default: `~/.config`). + Diretório para os arquivos de configuração (padrão: `~/.config`). - `FULL_THEME_UPDATE` - Overwrites the archived files (useful for updates and changes in archives). + Sobrescreve os ficheiros arquivados (Útil para atualizações e mudanças nos arquivos). ### EXAMPLES -Opens fzf menu and select themes. +Abre menu fzf e seleciona temas. ```shell theme.import.py --select