shellutils.github.io/README_pt.html at main · shellutils/shellutils.github.io · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
<!DOCTYPE html>
<html lang="pt-BR">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Shell Utils Framework</title>
    <style>
        .center {
            text-align: center;
        }
        body {
            max-width: 1200px;
            margin: 0 auto;
            padding: 20px;
            font-family: system-ui, -apple-system, sans-serif;
        }
        pre {
            background-color: #f6f8fa;
            padding: 16px;
            border-radius: 6px;
            overflow-x: auto;
        }
        img {
            max-width: 100%;
            height: auto;
        }
    </style>
</head>
<body>

<h1><a href="https://github.com/felipefacundes/shell_utils">Shell Utils Framework 🐚</a></h1>

<p>
    <a href="./README_pt.html"><img src="https://img.shields.io/badge/lang-pt--BR-green.svg" alt="pt-BR"></a>
    <a href="./README_es.html"><img src="https://img.shields.io/badge/lang-es-yellow.svg" alt="es"></a>
    <a href="./README.html"><img src="https://img.shields.io/badge/lang-en-red.svg" alt="en"></a>
</p>

<div class="center">
    <img src="./icons/logo.png" alt="Shell Utils Logo">

    <p><em>Uma Coleção Dinâmica de Scripts Shell com Propósito Educacional</em></p>

    <img src="https://img.shields.io/github/stars/felipefacundes/shell_utils?style=social" alt="GitHub stars">
    <img src="https://img.shields.io/github/forks/felipefacundes/shell_utils?style=social" alt="GitHub forks">
    <img src="https://img.shields.io/github/issues/felipefacundes/shell_utils" alt="GitHub issues">
    <img src="https://img.shields.io/github/license/felipefacundes/shell_utils" alt="GitHub license">
</div>

<h2>🌟 Visão Geral</h2>

<p>O Shell Utils é um framework educacional projetado para tornar a programação shell acessível e poderosa. É o resultado de um trabalho exaustivo de muitos anos, agora disponível no GitHub. Com mais de 280 scripts documentados, atende tanto iniciantes quanto usuários avançados. Seu grande diferencial é a capacidade de interagir com os principais shells: <strong>Bash, Zsh e Fish</strong>.</p>

<p>✅ Inclui scripts de terceiros, como os do <a href="http://www.fmwconcepts.com/imagemagick/index.php">Fred's Imagemagick</a> <em>(créditos mantidos nos scripts)</em>.</p>

<h3>✨ Características Principais</h3>

<ul>
    <li>Reconhecimento dinâmico de scripts, funções, variáveis e aliases</li>
    <li>Documentação abrangente e menus de ajuda</li>
    <li>Compatibilidade entre shells (fish, zsh, bash)</li>
    <li>Rica coleção de scripts utilitários</li>
    <li>Recursos educacionais e tutoriais</li>
</ul>

<p>📌 O script <code>help_shell</code> lista funções como <code>sed_info</code> (para auxiliar no uso do sed), fornecendo tutoriais rápidos sobre comandos do Linux. Para criar uma função simples, basta criar um arquivo <code>função.sh</code> e armazená-lo em <code>~/.shell_utils/scripts/helps/</code>. O script <code>help_shell</code> será capaz de lê-los e mostrar uma lista completa de funções pedagógicas e muito mais.</p>

<h2>📁 Estrutura de Diretórios</h2>

<pre>
~/.shell_utils/
├── scripts/     # Scripts principais
│   ├── faqs/    # Scripts de tutorial e guias
│   └── helps/   # Funções auxiliares educacionais
├── functions/   # Funções personalizadas
├── variables/   # Variáveis de ambiente
└── aliases/     # Aliases do shell
</pre>

<h2>🔧 Recursos e Ferramentas</h2>

<ul>
    <li><strong>Alarme</strong>: Alarme multilíngue, com capacidade de executar comandos externos, função soneca e muito mais.</li>
    <li><strong>Calendário</strong>: Calendário completo com suporte a feriados</li>
    <li><strong>Ferramentas de Video</strong>: Gravador de tela e gerenciadores de videos</li>
    <li><strong>Ferramentas de Áudio</strong>: Gerar frequências de áudio e gerenciares de som</li>
    <li><strong>Ferramentas de Processamento de Imagem</strong>: Converter, redimensionar e manipular imagens</li>
    <li><strong>Gerenciamento de Temas</strong>:
        <ul>
            <li>Temas do GRUB</li>
            <li>Temas do Terminal</li>
            <li>Coleções de arte ASCII</li>
        </ul>
    </li>
    <li><strong>Utilitários de Cores</strong>:
        <ul>
            <li>Paleta de cores ANSI</li>
            <li>Conversor de Hex para ANSI</li>
        </ul>
    </li>
    <li><strong>Ferramentas para Gerenciadores de Janelas</strong>: Suporte para i3, awesome, openbox e outros</li>
    <li><strong>Integração com Ferramentas de Terceiros</strong>: Incluindo scripts do <a href="http://www.fmwconcepts.com/imagemagick/index.php">"Fred's Imagemagick"</a></li>
</ul>

<h2>🚀 Instalação</h2>

<h3>Opção 1: Instalação em Uma Linha</h3>
<pre>bash -c "$(curl -fsSL https://raw.githubusercontent.com/felipefacundes/shell_utils/refs/heads/main/install.sh)"</pre>

<h3>Opção 2: Instalação Manual</h3>
<pre>git clone https://github.com/felipefacundes/shell_utils ~/.shell_utils
bash ~/.shell_utils/install.sh</pre>

<h2>🔄 Dependências</h2>

<p>O instalador detecta automaticamente seu shell (fish, zsh ou bash) e instala as dependências necessárias:</p>
<ul>
    <li>Para usuários bash: oh-my-bash</li>
    <li>Para usuários zsh: oh-my-zsh</li>
</ul>

<h2>🤝 Contribuindo</h2>

<p>Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request. Para mudanças importantes, por favor, abra uma issue primeiro para discutir o que você gostaria de mudar.</p>

<h2>📜 Licença</h2>

<p>Este projeto está licenciado sob a Licença GPLv3 - consulte o arquivo <a href="LICENSE.html">LICENSE</a> para obter detalhes.</p>

<h2>👏 Créditos</h2>

<ul>
    <li>Criador original: <a href="https://github.com/felipefacundes">Felipe Facundes</a></li>
    <li>Agradecimentos especiais a todos os contribuidores e ao <a href="http://www.fmwconcepts.com/imagemagick/index.php">Fred's Imagemagick</a> por alguns scripts incluídos</li>
</ul>

<hr>

<div class="center">
    <p><strong>Feito com ❤️ pela comunidade Shell Utils</strong></p>

    <p>
        <a href="https://github.com/felipefacundes/shell_utils/issues">Reportar Bug</a> ·
        <a href="https://github.com/felipefacundes/shell_utils/issues">Solicitar Recurso</a>
    </p>
</div>

</body>
</html>