feat: expand documentation structure for new technologies

This commit is contained in:
João Pedro Toledo Goncalves 2026-01-22 23:25:06 -03:00
parent 549b30a527
commit b83ae5b28f
40 changed files with 165 additions and 0 deletions

View File

@ -0,0 +1,41 @@
import os
root_dir = r"c:\Users\joao.goncalves\Desktop\manuais zammad"
structure = {
"documentacao rede e seguranca": ["pfsense"],
"documentacao storage": ["truenas", "samba", "nfs", "iscsi"],
"documentacao bancos de dados": ["postgresql", "mysql"],
"documentacao windows": ["active directory", "dns", "firewall", "gpo"],
"documentacao linux": ["ubuntu", "debian", "alpine"],
"documentacao virtualizacao": ["proxmox"],
"documentacao conteineres": ["docker", "docker-compose", "portainer"],
"documentacao aplicativos": ["gitea", "zammad", "zabbix", "technium", "magnusbilling", "asterisk"],
"documentacao navegadores": ["google chrome", "firefox"],
"documentacao ferramentas": ["putty", "ssh"]
}
for category, subitems in structure.items():
cat_path = os.path.join(root_dir, category)
if not os.path.exists(cat_path):
os.makedirs(cat_path)
print(f"Created category: {category}")
# Create category README
with open(os.path.join(cat_path, "README.md"), "w", encoding="utf-8") as f:
f.write(f"# {category.replace('documentacao ', '').title()}\n\nManuais relacionados a {category.replace('documentacao ', '')}.\n")
for item in subitems:
# Create subdirectories for each item to keep it clean, or just keep them in the category?
# The user's list is long. Specific folders for each item is better for organization.
item_slug = item.replace(" ", "_")
item_path = os.path.join(cat_path, item_slug)
if not os.path.exists(item_path):
os.makedirs(item_path)
print(f" Created item: {item}")
with open(os.path.join(item_path, "README.md"), "w", encoding="utf-8") as f:
f.write(f"# Documentação {item.title()}\n\nLocal para manuais e procedimentos referentes ao **{item.title()}**.\n")
print("Directory structure created successfully.")

View File

@ -6,6 +6,16 @@ Este repositório contém a documentação técnica da iT Guys, organizada por s
* **documentacao exchange/**: Manuais relacionados ao Microsoft Exchange.
* **documentacao vmware/**: Manuais relacionados ao ambiente VMWare.
* **documentacao rede e seguranca/**: Pfsense.
* **documentacao storage/**: TrueNAS, Samba, NFS, iSCSI.
* **documentacao bancos de dados/**: PostgreSQL, MySQL.
* **documentacao windows/**: Active Directory, DNS, Firewall, GPO.
* **documentacao linux/**: Ubuntu, Debian, Alpine.
* **documentacao virtualizacao/**: Proxmox.
* **documentacao conteineres/**: Docker, Docker-compose, Portainer.
* **documentacao aplicativos/**: Zammad, Zabbix, Gitea, VoIP.
* **documentacao navegadores/**: Chrome, Firefox.
* **documentacao ferramentas/**: Putty, SSH.
* **.gemini/**: Scripts e assets utilitários para padronização e geração de PDFs.
## Como Gerar PDFs

View File

@ -0,0 +1,3 @@
# Aplicativos
Manuais relacionados a aplicativos.

View File

@ -0,0 +1,3 @@
# Documentação Asterisk
Local para manuais e procedimentos referentes ao **Asterisk**.

View File

@ -0,0 +1,3 @@
# Documentação Gitea
Local para manuais e procedimentos referentes ao **Gitea**.

View File

@ -0,0 +1,3 @@
# Documentação Magnusbilling
Local para manuais e procedimentos referentes ao **Magnusbilling**.

View File

@ -0,0 +1,3 @@
# Documentação Technium
Local para manuais e procedimentos referentes ao **Technium**.

View File

@ -0,0 +1,3 @@
# Documentação Zabbix
Local para manuais e procedimentos referentes ao **Zabbix**.

View File

@ -0,0 +1,3 @@
# Documentação Zammad
Local para manuais e procedimentos referentes ao **Zammad**.

View File

@ -0,0 +1,3 @@
# Bancos De Dados
Manuais relacionados a bancos de dados.

View File

@ -0,0 +1,3 @@
# Documentação Mysql
Local para manuais e procedimentos referentes ao **Mysql**.

View File

@ -0,0 +1,3 @@
# Documentação Postgresql
Local para manuais e procedimentos referentes ao **Postgresql**.

View File

@ -0,0 +1,3 @@
# Conteineres
Manuais relacionados a conteineres.

View File

@ -0,0 +1,3 @@
# Documentação Docker-Compose
Local para manuais e procedimentos referentes ao **Docker-Compose**.

View File

@ -0,0 +1,3 @@
# Documentação Docker
Local para manuais e procedimentos referentes ao **Docker**.

View File

@ -0,0 +1,3 @@
# Documentação Portainer
Local para manuais e procedimentos referentes ao **Portainer**.

View File

@ -0,0 +1,3 @@
# Ferramentas
Manuais relacionados a ferramentas.

View File

@ -0,0 +1,3 @@
# Documentação Putty
Local para manuais e procedimentos referentes ao **Putty**.

View File

@ -0,0 +1,3 @@
# Documentação Ssh
Local para manuais e procedimentos referentes ao **Ssh**.

View File

@ -0,0 +1,3 @@
# Linux
Manuais relacionados a linux.

View File

@ -0,0 +1,3 @@
# Documentação Alpine
Local para manuais e procedimentos referentes ao **Alpine**.

View File

@ -0,0 +1,3 @@
# Documentação Debian
Local para manuais e procedimentos referentes ao **Debian**.

View File

@ -0,0 +1,3 @@
# Documentação Ubuntu
Local para manuais e procedimentos referentes ao **Ubuntu**.

View File

@ -0,0 +1,3 @@
# Navegadores
Manuais relacionados a navegadores.

View File

@ -0,0 +1,3 @@
# Documentação Firefox
Local para manuais e procedimentos referentes ao **Firefox**.

View File

@ -0,0 +1,3 @@
# Documentação Google Chrome
Local para manuais e procedimentos referentes ao **Google Chrome**.

View File

@ -0,0 +1,3 @@
# Rede E Seguranca
Manuais relacionados a rede e seguranca.

View File

@ -0,0 +1,3 @@
# Documentação Pfsense
Local para manuais e procedimentos referentes ao **Pfsense**.

View File

@ -0,0 +1,3 @@
# Storage
Manuais relacionados a storage.

View File

@ -0,0 +1,3 @@
# Documentação Iscsi
Local para manuais e procedimentos referentes ao **Iscsi**.

View File

@ -0,0 +1,3 @@
# Documentação Nfs
Local para manuais e procedimentos referentes ao **Nfs**.

View File

@ -0,0 +1,3 @@
# Documentação Samba
Local para manuais e procedimentos referentes ao **Samba**.

View File

@ -0,0 +1,3 @@
# Documentação Truenas
Local para manuais e procedimentos referentes ao **Truenas**.

View File

@ -0,0 +1,3 @@
# Virtualizacao
Manuais relacionados a virtualizacao.

View File

@ -0,0 +1,3 @@
# Documentação Proxmox
Local para manuais e procedimentos referentes ao **Proxmox**.

View File

@ -0,0 +1,3 @@
# Windows
Manuais relacionados a windows.

View File

@ -0,0 +1,3 @@
# Documentação Active Directory
Local para manuais e procedimentos referentes ao **Active Directory**.

View File

@ -0,0 +1,3 @@
# Documentação Dns
Local para manuais e procedimentos referentes ao **Dns**.

View File

@ -0,0 +1,3 @@
# Documentação Firewall
Local para manuais e procedimentos referentes ao **Firewall**.

View File

@ -0,0 +1,3 @@
# Documentação Gpo
Local para manuais e procedimentos referentes ao **Gpo**.