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/en/configuring/overview.md b/src/content/docs/en/configuring/overview.md index 5a62d21..818be87 100644 --- a/src/content/docs/en/configuring/overview.md +++ b/src/content/docs/en/configuring/overview.md @@ -7,6 +7,6 @@ sidebar: ### HyDE's Configuration Guide -As HyDE is not a full-fledge Desktop Environment, we tend to use various tools/apps to accomplish our task. +As HyDE is not a full-fledged 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/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 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 --- 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..80a51fa --- /dev/null +++ b/src/content/docs/pt/configuring/config_toml.md @@ -0,0 +1,369 @@ +--- +title: Configuração principal +description: Guia de configuração do HyDE +sidebar: + order: 2 +--- + + + + + +--- +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. + +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] + +Configuração para o batterynotify.sh. + +| Key | Description | Default | +| --- | ----------- | ------- | +| 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] + +Comando para executar para notificações da bateria. + +| Key | Description | Default | +| --- | ----------- | ------- | +| 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] + +Limiar para notificações da bateria. + +| Key | Description | Default | +| --- | ----------- | ------- | +| 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] + +Configuração do brightnesscontrol.sh. + +| Key | Description | Default | +| --- | ----------- | ------- | +| notify | Habilitar notificações para controle de brilho. | true | +| steps | Número de passos para incrementar/reduzir volume. | 5 | + +### [cava.hyprlock] + +Configuração do 'cava.sh hyprlock'. + +| Key | Description | Default | +| --- | ----------- | ------- | +| 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] + +Configuração do 'cava.sh stdout'. + +| Key | Description | Default | +| --- | ----------- | ------- | +| 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] + +'Configuração do cava.sh waybar'. + +| Key | Description | Default | +| --- | ----------- | ------- | +| 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] + +Configuração do Hypr. + +| Key | Description | Default | +| --- | ----------- | ------- | +| sanitize | Lista de regex para higienizar no theme.config. | [".*rgba\(.*,.*,.*,.*\)"] | + +### [hyprland] + +Configuração do hyprland. + +| Key | Description | Default | +| --- | ----------- | ------- | +| 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 | Gerenciador de arquivos. | dolphin | +| font | Fonte. | Canterell | +| font_antialiasing | Antialiasing da fonte. | rgba | +| font_hinting | Font hinting. | full | +| 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] + +Configuração de inicialização hyprland. + +| Key | Description | Default | +| --- | ----------- | ------- | +| 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] + +Configuração do mediaplayer.py. + +| Key | Description | Default | +| --- | ----------- | ------- | +| 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] + +Configuração do script de notificação. + +| Key | Description | Default | +| --- | ----------- | ------- | +| font | Fonte para notificações. | mononoki Nerd Font | +| font_size | Tamanho da fonte para notificações. | 10 | + +### [rofi] + +Configuração global do Rofi. + +| Key | Description | Default | +| --- | ----------- | ------- | +| scale | Escala para o Rofi. | 10 | + +### [rofi.animation] + +Configuração do 'animation.sh select'. + +| Key | Description | Default | +| --- | ----------- | ------- | +| scale | Escala para a animação. | 10 | + +### [rofi.cliphist] + +Configuração do cliphist.sh. + +| Key | Description | Default | +| --- | ----------- | ------- | +| scale | Escala para o cliphist.sh. | 10 | + +### [rofi.emoji] + +Configuração para o emoji-picker.sh. + +| Key | Description | Default | +| --- | ----------- | ------- | +| scale | Escala para o seletor de emojis. | 10 | +| style | Estilo para o seletor de emojis. | 1 | + +### [rofi.glyph] + +Configuração do glyph-picker.sh. + +| Key | Description | Default | +| --- | ----------- | ------- | +| scale | Escala para o glyph-picker.sh. | 10 | + +### [rofi.hyprlock] + +Configuração do 'hyprlock.sh select'. + +| Key | Description | Default | +| --- | ----------- | ------- | +| scale | Escala para o hyprlock. | 10 | + +### [rofi.launch] + +Configuração para o rofilaunch.sh + +| Key | Description | Default | +| --- | ----------- | ------- | +| 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] + +Configuração do themeselect.sh. + +| Key | Description | Default | +| --- | ----------- | ------- | +| scale | Escala para o seletor de temas. | 6 | + +### [rofi.wallpaper] + +Configuração para o swwwallselect.sh. + +| Key | Description | Default | +| --- | ----------- | ------- | +| scale | Escala para o papel de parede. | 10 | + +### [rofi.keybind.hint] + +Configuração do keybind_hint.sh. + +| Key | Description | Default | +| --- | ----------- | ------- | +| 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] + +Configuração do screenshot.sh. + +| Key | Description | Default | +| --- | ----------- | ------- | +| 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] + +Configuração do sysmonlaunch.sh. + +| Key | Description | Default | +| --- | ----------- | ------- | +| commands | Opções do comando de fallback. | [""] | +| execute | Comando padrão para executar. | | + +### [volume] + +Configuração do volumecontrol.sh. + +| Key | Description | Default | +| --- | ----------- | ------- | +| 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] + +Configuração do wallbash. + +| Key | Description | Default | +| --- | ----------- | ------- | +| skip_template | Templates a serem ignorados pelo wallbash. | [""] | + +### [wallpaper] + +Configuração do papel de parede + +| Key | Description | Default | +| --- | ----------- | ------- | +| 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] + +Configuração do swwwallselect.sh + +| Key | Description | Default | +| --- | ----------- | ------- | +| 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] + +Configuração do waybar. + +| Key | Description | Default | +| --- | ----------- | ------- | +| font | Fonte para o waybar. | JetBrainsMono Nerd Font | +| icon_size | Tamanho dos ícones do waybar. | 10 | +| scale | Escala global do waybar. | 10 | + +### [weather] + +Configuração do módulo do clima. + +| Key | Description | Default | +| --- | ----------- | ------- | +| 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] + +Configuração do wlogout. + +| Key | Description | Default | +| --- | ----------- | ------- | +| style | Estilo para o 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..3e15b61 --- /dev/null +++ b/src/content/docs/pt/configuring/hyprland.md @@ -0,0 +1,109 @@ +--- +title: Hyprland +description: Configurações relacionadas ao Hyprland +sidebar: + order: 3 +--- + + + +# Árvore de configuração + +``` +. 📂 ~/.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 + +**Leia a [Wiki do Hyprland](https://wiki.hyprland.org/) (Em inglês) primeiro!** + +::: + +# 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: + +- [Modelo base](#1-boilerplate) +- [Sobrescrições](#2-overrides) +- [Usuários](#3-users) + +## 1. Modelo base + +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` + +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. Sobreescrições + +Essa seção é para sobrescrever a configuração padrão do HyDE. + +:::caution + +O arquivo `xdg_config/hypr/hyde.conf` é obsoleto. Use `xdg_config/hyde/config.toml` em vez disso. + +::: + +Para sobrescrever a configuração padrão, configure estas seções no seu `config.toml`: + +- **[hyprland]** - Aplicativos padrão, temas e configurações de display. +- **[hyprland_start]** - Comandos na inicialização e serviços. + +**Arquivo de configuração:** `$XDG_STATE_HOME/hyde/hyprland.conf` + +Para opções mais detalhadas, veja: +- [hyprland configuration](../config_toml/#hyprland) +- [hyprland_start configuration](../config_toml/#hyprland_start) + +## 3. Usuário; + +Essa seção é para configuração do usuário. É recomendado mudar esta seção de acordo com seu gosto. + +**Caminhos:** + +- `./keybindings.conf` +- `./windowrules.conf` +- `./monitors.conf` +- `./userprefs.conf` + +--- + +:::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. + +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. + +Também veja [Duvidas Frequentes e Dicas](../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..cca7b43 --- /dev/null +++ b/src/content/docs/pt/configuring/overview.md @@ -0,0 +1,12 @@ +--- +title: Visão geral +description: Guia de Configuração do HyDE +sidebar: + order: 1 +--- + +### Guia de Configuração do HyDE + +O HyDE não é um DE completo, para isso, nós usamos várias ferramentas/apps para completar esta tarefa. + +Nesta seção nós iremos conversar sobre como podemos configurar os dotfiles da maneira HyDE. diff --git a/src/content/docs/pt/configuring/waybar.md b/src/content/docs/pt/configuring/waybar.md new file mode 100644 index 0000000..199aea4 --- /dev/null +++ b/src/content/docs/pt/configuring/waybar.md @@ -0,0 +1,471 @@ +--- +title: Waybar +description: Configuração do Waybar +--- + +## Árvore de configuração + +```text +📂 ~/.config/waybar/ +├── 📂 layouts/ +├── 📂 menus/ +├── 📂 modules/ +├── 📂 styles/ +├── 📂 includes/ +├── 📄 config.jsonc +├── 📄 style.css +├── 📄 theme.css +└── 📄 user-style.css +``` + +- **config.jsonc** + - 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** + - 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** + - Arquivo gerado pelo tema. + +:::note +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á. + +::: + +### Módulos + +Diretório: `./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 +``` + +- 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. + +Exemplo: +```css +.custom-cpuinfo { + padding: 1em; +} +``` + +### Layouts + +Diretório: `./layouts/` + +```text +└── 📂 layouts/ + ├── 📄 layout-1.jsonc + ├── 📄 layout-2.jsonc + ├── 📄 khing.jsonc + ├── 📄 macos.jsonc + └── 📄 ....jsonc +``` + +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/`. +::: + +Para a estilização veja [Estilos](#estilos). + +### Estilos + +Diretório: `./styles/` + +```text +└── 📂 styles/ + └── 📂 groups/ + ├── 📄 layout-1.css + ├── 📄 layout-2.css + ├── 📄 khing.css + ├── 📄 macos.css + └── 📄 ...*.css +``` + +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 + +Diretório: `./includes/` + +```text +└── 📂 includes/ + ├── 📄 includes.jsonc + ├── 📄 border-radius.css + └── 📄 global.css +``` + +- **border-radius.css** + - Border-radius dinâmico para os [grupos](#groups). + +#### Visualização do Border-Radius Dinâmico + +**Nenhum arredondamento** no Hyprland + +![0 arredondamento no hyprland](../../../../assets/waybar/rounding-0.png) + +**Squircle** arredondamento 10 no Hyprland + +![10 arredondamento no hyprland](../../../../assets/waybar/rounding-10.png) + +**Circulo** arredondamento 100 no Hyprland + +![100 rounding in hyprland](../../../../assets/waybar/rounding-100.png) + +**Entendeu?** + +- **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 + +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/` + +## Classe de Grupo para Estilização + +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: +![Grupos em formato de "pílula"](../../../../assets/waybar/groups.png) + +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. + +Exemplo em `~/.config/waybar/layouts/my_config.jsonc`: + +```jsonc +{ + "group/pill": { + "orientation": "inherit", + "modules": [ + "custom/gpuinfo", + "clock" + ] + } +} +``` + +Agora podemos adicionar nosso grupo nos módulos Waybar: + +```jsonc +{ + "modules-center": [ + "group/pill", + "group/pill#tag1", + "group/pill-in" + ] +} +``` + +**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, +#pill-in { + /* Your styles here */ +} +``` + +**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. + +## Criando seu próprio layout Waybar + +:::note + +Essa é uma guia muito rasa, você deve seguir a [Wiki do Waybar](https://github.com/Alexays/Waybar/wiki/Configuration) para mais informações. + +::: + + +### Este é o arquivo do layout inteiro usada pelas instruções + +
+ MyBar.jsonc + +```jsonc +{ + /* + ┌─────────────────────────────────────────────────────────────────────────────┐ + │ Opções globais para a configuração do Waybar │ + └─────────────────────────────────────────────────────────────────────────────┘ + */ + + "layer": "top", + "output": ["*"], + "position": "top", + "reload_style_on_change": true, + + /* + ┌────────────────────────────────────────────────────────────────────────────┐ + │ │ + │ 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 │ + │ │ + └────────────────────────────────────────────────────────────────────────────┘ + */ + + "include": ["$XDG_CONFIG_HOME/waybar/includes/includes.json"], + + /* + ┌────────────────────────────────────────────────────────────────────────────┐ + │ Declare os módulos dentro de seus grupos desejados. │ + │ Atualmente temos: │ + │ │ + │ - 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 │ + │ │ + └────────────────────────────────────────────────────────────────────────────┘ + */ + + "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"] + }, + + /* + ┌─────────────────────────────────────────────────────────────────────────┐ + │ Reusar um grupo é simples, basta adicionar um #tag ao nome do grupo │ + └─────────────────────────────────────────────────────────────────────────┘ + */ + + "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 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"], + "modules-right": [ + "group/pill-up#right", + "group/pill-down#right", + "group/pill-right" + ] +} + +``` + +
+ + +### Guia passo-a-passo + +#### Passo 1: Crie seu arquivo de configuração + +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 +``` + +#### Passo 2: Adicione opções de configuração global + +Comece com todas as configurações globais essenciais que definem o comportamento básico de seu 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 +``` + +#### Passo 3: Inclua definições de módulos HyDE. + +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 +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 + +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 + // Grupos de formato dísponiveis: + // 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"] + }, +``` + +#### Passo 5: Reusar grupos com tags + +Você pode reusar o mesmo grupo de formato múltiplas vezes adicionando tags (`#nomedatag`): + +```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: Organize grupos nas posições de módulo + +Finalmente, atribua seus grupos para às três posições disponíveis: + +```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" + ] +} +``` + +#### Passo 7: Aplique sua configuração + +Para usar seu novo layout, execute: + +```bash +# Navigate to your layouts using rofi +hyde-shell waybar -S + +# Or apply directly +hyde-shell waybar -c ~/.config/waybar/layouts/minha_configuração.jsonc +``` +![alt text](/src/assets/waybar/selector.png) + +:::note +Veja hyde-shell waybar --help para mais opções. +::: + +### Available Group Shapes + +| Formato | Descrição | +|-------|-------------| +| `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. | + + +### Customizando conteúdo do módulo + +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. + + + + 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..846d35e --- /dev/null +++ b/src/content/docs/pt/getting-started/installation.md @@ -0,0 +1,125 @@ +--- +title: Instalação +description: Guia de Instalação do HyDE +--- + +// TODO: Por artigos + +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 + +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 + +O script modifica sua configuração `grub` ou `systemd-boot` para habilitar DRM NVIDIA. + +::: + + + +### Script automático de instalação. + +```shell +pacman -S --needed git base-devel +git clone --depth 1 https://github.com/HyDE-Project/HyDE ~/HyDE +cd ~/HyDE/Scripts +./install.sh +``` + +:::tip +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 +``` + +::: + +:::note +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. +::: + +### Instalação manual e granular + +#### Clone + +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 +cd ~/HyDE/Scripts +``` + +:::caution +**JAMAIS** execute o script com sudo ou como usuario root! +::: + +#### Modos + +O script de instalação pode ser executado em diferentes modos + +- Para instalação completa padrão hyprland com todas as configurações + +```shell +./install.sh +``` + +- Para instalação completa ou minima + seus pacotes favoritos (ex.`pkg_user.lst`) + +```shell +./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. +``` + +- Cada [seção](#process) pode ser executada de forma independente como, + +```shell +./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 +``` + + 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..9517272 --- /dev/null +++ b/src/content/docs/pt/getting-started/introduction.md @@ -0,0 +1,16 @@ +--- +title: Introdução +description: Primeiros passos com o HyDE. +sidebar: + order: 1 +--- + +

+ +🚧🚧🚧 O projeto HyDE ainda está em desenvolvimento. +Este site de documentação ainda está em desenvolvimento, e estamos ativamente trabalhando em melhora-lo! + +Sinta-se à vontade para explorar, dar feedback, e contribuir para fazer esta documentação o quão util e compreensiva como possivel. +Sua ajuda é inestimável em moldar o HyDE e seus recursos. + +👉 Contribua para o projeto e sua documentação no 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..8b37f12 --- /dev/null +++ b/src/content/docs/pt/getting-started/update.md @@ -0,0 +1,50 @@ +--- +title: Atualizando +description: Guia de Gerenciamento dos Dotfiles HyDE +--- + +## Automatizada + +Para atualizar o HyDE, você precisa puxar as mudanças mais recentes e restaurar as configurações executando os seguintes comandos: + +shell +cd ~/HyDE/Scripts +git pull origin master +./install.sh -r + + +:::note + +Quaisquer configurações que você fez serão sobreescritas se listadas para serem feitas em: Scripts/restore_cfg.psv. +No entanto, todas as configurações sobreescritas serão salvas e podem ser recuperadas em: ~/.config/cfg_backups. +Veja [Restaurando configuração](/hyde/installation/restore/) para mais informações. + +::: + +## Atualizações manuais e granulares + +Além do comando acima, você pode modificar o [Scripts/restore_cfg.psv](https://github.com/HyDE-Project/HyDE/blob/master/Scripts/restore_cfg.psv). A documentação está no arquivo. + +Também veja [isso](../../resources/restore/). + +### Atualizando APENAS os dotfiles + +:::note + +> "restaurar" no contexto aqui é restaurar os dotfiles do repositório para seu $HOME, não o contrário. + +sh +./restore_cfg.sh + + +::: + +
+Algo assim + +sh +cd ~/HyDE/Scripts +./restore_cfg.sh ./restore_cfg.psv + + +
\ No newline at end of file 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.md b/src/content/docs/pt/man-pages/hyde-shell.md new file mode 100644 index 0000000..a97abbf --- /dev/null +++ b/src/content/docs/pt/man-pages/hyde-shell.md @@ -0,0 +1,91 @@ +--- +title: hyde-shell +description: Wrapper do HyDE para executar scripts e executáveis do HyDE. +sidebar: + order: 2 +--- + +## Nome + +`hyde-shell` - Wrapper de execução dos scripts do HyDE e resolvedor de ambiente. + +## Sinopse + +``` +hyde-shell [comando] [argumentos...] +hyde-shell [--help | help | -h] +hyde-shell [-r | reload] +``` + +## Descrição + +`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. + +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. + +## Opções + +**`--help, help, -h`** +: Exibe mensagem de ajuda mostrando comandos disponíveis e instruções de uso. + +**`-r, reload`** +: Recarrega o ambiente HyDE e recarrega todas as configurações. + +## Comandos embutidos + +**`wallbash`** +: Executa um script wallbash para estilização dinâmica e gerenciamento de cores. + +## Execução de scripts + +`hyde-shell` fornece acesso a todos os scripts HyDE sem precisar de extensões de arquivo: + +```bash +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 +``` + +O wrapper automaticamente descobre e resolve todos os scripts no diretório da biblioteca HyDE. + +## Usage Examples + +Executa qualquer script HyDE sem precisar da extensão do arquivo: +```bash +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 +``` + +Usa comandos embutidos: +```bash +hyde-shell wallbash # Execute wallbash scripts in ~/.config/hyde/wallbash/scripts/ + +hyde-shell reload # Reload HyDE environment +``` + +Passa argumentos para o script subjacente: +```bash +hyde-shell waybar --set layout-1 # Passa arguments para o waybar.py +``` + +## Ferramentas chave + +- **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. + +## Arquivos + +**`~/.local/bin/hyde-shell`** +: Executável principal do script de wrapper. + +**`~/.local/lib/hyde/`** +: Diretório contendo todos scripts e módulos HyDE. + +## Notas + +- 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. 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..d864265 --- /dev/null +++ b/src/content/docs/pt/man-pages/overview.md @@ -0,0 +1,8 @@ +--- +title: Visão Geral +description: Manuais do HyDE para scripts e executáveis. +sidebar: + order: 1 +--- + + Manuais do HyDE para scripts e executáveis. \ 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..c57628e --- /dev/null +++ b/src/content/docs/pt/man-pages/theme.import.md @@ -0,0 +1,62 @@ +--- +title: theme.import.py +description: Página do manual do theme import. +--- + +### Prévia + +![preview theme import](../../../../assets/man-pages/theme.import/image.png) + +### NOME + +theme.import.py - Importa temas do repositório da galeria do HyDE. + +### SYNOPSIS + +`theme.import.py` [OPÇÕES] + +### DESCRIÇÃO + +`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. + +### OPÇÕES + +- `-j`, `--json` + Carrega dados JSON após clonar o repositório. + +- `-S`, `--select` + Seleciona temas usando `fzf`. + +- `-p`, `--preview` TEMA. + Mostra uma prévia do tema especificado + +- `-t`, `--preview-text` TEMA.r + Prévia do texto para mostrar quando usando a opção `--preview`. + +- `--skip-clone` + Pula a clonagem do repositório. + +- `-f`, `--fetch` THEME + 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` + Configuração o nível de log (padrão: `INFO`). + +- `XDG_CACHE_HOME` + Diretório para o cache (padrão: `~/.cache`). + +- `XDG_CONFIG_HOME` + Diretório para os arquivos de configuração (padrão: `~/.config`). + +- `FULL_THEME_UPDATE` + Sobrescreve os ficheiros arquivados (Útil para atualizações e mudanças nos arquivos). + +### EXAMPLES + +Abre menu fzf e seleciona temas. + +```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..582975d --- /dev/null +++ b/src/content/docs/pt/theming/gallery.md @@ -0,0 +1,123 @@ +--- +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) + +### Interactively import themes from the gallery + +```shell +hydectl theme import +``` + +### Import a specific theme by name and URL + +```shell +hydectl theme import --name "Theme Name" --url "https://github.com/User/Repository" +``` + +### Update all local themes + +```shell +hydectl theme import --fetch all +``` + +### Update a specific theme + +```shell +hydectl theme import --fetch "Theme Name" +``` + +### Select a theme interactively + +```shell +hydectl theme select +``` + +### Set a theme directly + +```shell +hydectl theme set "Theme Name" +``` + +--- + +## Wallpaper Management + +### Select a wallpaper interactively + +```shell +hydectl wallpaper select +``` + +### Set a specific wallpaper + +```shell +hydectl wallpaper set /path/to/wallpaper.jpg +``` + +### List available wallpapers + +```shell +hydectl wallpaper list +``` 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.