Atualizar docs/plano-disciplina.md

.vscode/extensions.json

@@ -0,0 +1,10 @@
+{
+    "recommendations": [
+        "tamasfe.even-better-toml",
+        "vscode-icons-team.vscode-icons",
+        "yzhang.markdown-all-in-one",
+        "ms-ceintl.vscode-language-pack-pt-br",
+        "executablebookproject.myst-highlight",
+        "shd101wyy.markdown-preview-enhanced"
+    ]
+}

Makefile

@@ -11,6 +11,7 @@ BUILDDIR      = _build
 # Put it first so that "make" without argument is like "make help".
 help:
 	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	@printf "  \033[34mlivehtml\033[0m    to make standalone HTML files and serve them locally via http.server"
 
 .PHONY: help Makefile
 

docs/aulas/2026-03-13/index.md

@@ -1,5 +0,0 @@
-# Aula de 13/03/2026
-
-Apresentação
-
-

docs/aulas/2026-03-13/levi.md

@@ -1,13 +0,0 @@
-# Apresentação de Levi Neves
-
-## Quem sou eu
-
-ugodifgpiai
-
-## o que gosto de fazer
-
-lhsfiouhpaiof
-
-## o que sei fazer bem
-
-oihfiouas

docs/aulas/aula-2026-03-30/index.md

@@ -0,0 +1,34 @@
+(aula:2026-03-30)=
+
+# Aula de 30/03/2026
+
+Que tal instalarmos una distribuição do Linux?
+
+## Maerial necessário
+
+- [ ] PC de um laboratório de informática do IFRN[^1] com o sistema operacional Windows instalado ou o sistema operacional Linux instalado com ambiente gráfico;
+- [ ] Ambiente de virtualização [Oracle VirtulBox](https://www.virtualbox.org/) instalado; e
+- [ ] Imagem de CD/DVD de instalalação do Alpine Linux.
+
+## Roteiro
+
+1. Baixe a imagem *x86_64* do bloco *VIRTUAL* da página de [Downloads do Alpine Linux](https://alpinelinux.org/downloads/);
+
+   ![Bloco VIRTUAL da página de downloads do Alpine Linux](../../_static/img/alpine-bloco-download-virtual.png)
+
+1. Inicie a aplicação VirtualBox. Caso não a ache, peça para um administrador da máquina instalá-la;
+
+   ![Página inicial da aplicação Oracle VirtualBox](../../_static/img/virtualbox-home.png)
+
+1. Clique no botão *New* ou no link *Create a new virtual macine (VM)* e crie uma VM com as seguintes configurações:
+
+   - Nome: *vm-isa-lab3-pc-XX* (Troque o *XX* pelo número de seu PC, com dois dígitos)
+   - Imagem ISO: *A imagem ISO que você baixou*
+   - Sistema operacional: *Linux*
+   - Distribuição do sistema operacional: *Oracle Linux*[^2]
+   - Versão do sistema operncial: *Oracle Linux (64-bit)*
+
+   ![Janela de criação de nova VM do Oracle VirtualBox](../../_static/img/virtualbox-new-vm.png)
+
+[^1]: Uma das interfaces estará conectada à rede no modo bridge para que haja comunicação entre todas as máquinas virtuais.
+[^2]: No momento da escrita desta documentação, não havia a opção *Alpine Linux* no Oracle VirtualBox.

docs/conf.py

@@ -6,10 +6,21 @@
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
-project = 'DOCE'
-copyright = '2026, AUTOR'
-author = 'AUTOR'
-release = 'ANO_PERIODO'
+# Doce ambiente
+
+DISC = 'DISC'                # Sigla, acrônimo ou abreviação para disciplina
+AUTOR = '{Nome} {Sobrenome}' # Nome e um sobrenome, com iniciais maiúsculas
+ANO = '2026'                 # Ano da disciplina
+PERIODO = '1'                # Período da disciplina
+NAMESPACE = 'redes20261'     # Espaço nominal do repositório remoto do Git
+REPO = 'isa-2026-1'          # Nome do repositório remoto
+
+## As próximas configurações são do Sphinx
+
+project = f'DOCE {DISC}'
+copyright = f'{ANO}, {AUTOR}'
+author = f'{AUTOR}'
+release = f'{ANO}_{PERIODO}'
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
@@ -28,31 +39,29 @@ language = 'pt_BR'
 # -- Options for HTML output -------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
-namespace = 'redes20261'
-repo = 'isa-2026-1'
 
 html_theme = 'furo'
 html_title = html_short_title = project
 html_static_path = ['_static']
 html_theme_options = {
-    "source_repository": f"https://gitea.mange.ifrn.edu.br/{namespace}/{repo}/",
+    "source_repository": f"https://gitea.mange.ifrn.edu.br/{NAMESPACE}/{REPO}/",
     "source_branch": "main",
     "source_directory": "docs/",
-    "source_edit_link": f"https://gitea.mange.ifrn.edu.br/{namespace}/{repo}/_edit/main/docs/{{filename}}",
-    "source_view_link": f"https://gitea.mange.ifrn.edu.br/{namespace}/{repo}/src/branch/main/docs/{{filename}}",
+    "source_edit_link": f"https://gitea.mange.ifrn.edu.br/{NAMESPACE}/{REPO}/_edit/main/docs/{{filename}}",
+    "source_view_link": f"https://gitea.mange.ifrn.edu.br/{NAMESPACE}/{REPO}/src/branch/main/docs/{{filename}}",
 }
 
 myst_links_external_new_tab = True
 myst_number_code_blocks = ['Python', 'Bash']
 myst_heading_anchors = 3
 myst_enable_extensions = {
-    #"colon_fence": True,
+    "colon_fence": True,
 #    "dolarmath": True,
 #    "deflist": True,
 #    "linkify": True,
 #    "replacements": True,
 #    "strikethrough": True,
-#    "tasklist": True,
+    "tasklist": True,
 }
 
 bibtex_bibfiles = ['refs.bib']

docs/plano-disciplina.md

@@ -0,0 +1,104 @@
+# Plano de disciplina de curso
+
+- Curso:  Técnico de Nível Médio em Redes de Computadores, na Forma Subsequente
+- Disciplina:  Introdução a Sistemas Abertos
+- Carga horária: 60h
+  
+## Ementa
+
+Fundamentos de sistemas Linux. Instalação e gerenciamento de pacotes. Comandos e scripts de administração. Sistemas de arquivos e permissões. Gerenciamento de usuários, serviços e rede. Segurança, criptografia e controle de acesso.
+
+## Programa
+
+### Objetivos
+
+- Conhecer o modo de funcionamento do sistema operacional Linux;
+- Compreender o conceito de distribuições Linux; e
+- Instalar, configurar e administrar sistemas Linux.
+
+### Bases Científico-Tecnológicas (Conteúdos)
+
+1. Arquitetura De Sistema
+   1. Configurações de hardware
+   1. Inicialização do sistema
+   1. Níveis de execução, desligamento e reinicialização do sistema
+1. Instalação do Linux eAdministração de Pacotes
+   1. Partições de disco
+   2. Gerenciador de inicialização
+   3. Bibliotecas compartilhadas
+   4. Gerenciamento de pacotes
+   5. Virtualização e contêineres
+2. Comandos do Gnu e do Unix
+   1. Linha de comando
+   2. Variáveis de ambiente
+   3. Processamento de fluxos de texto com filtros
+   4. Gerenciamento de arquivos
+   5. Fluxos, canalização e redirecionamentos de entrada e de saída
+   6. Criação, monitoramento e finalização de processos
+   7. Modificação da prioridade de execução de um processo
+   8.  Agendamento de tarefas
+   9.  Busca em arquivos de texto com expressões regulares
+   10. Edição de arquivos de texto pela linha de comando
+3.  Dispositivos, Sistemas De Arquivos Linux e Padrão FHS
+    1.  Partições e de sistemas de arquivos
+    2.  Integridade de sistemas de arquivos
+    3.  Montagem e desmontagem de sistemas de arquivos
+    4.  Permissões e propriedades de arquivos
+    5.  Links simbólicos e hardlinks
+    6.  Busca e localização de arquivos
+4.  Shells e Scripts do Shell
+    1.  Personalização e escolha do interpretador de comandos
+    2.  Escrita de scripts básicos
+5.  Interfaces de Usuário e Ambientes Gráficos
+    1.  Gerenciador de Ambientes gráficos
+    2.  Ambientes gráficos
+    3.  Acessibilidade
+6.  Tarefas Administrativas
+    1.  Contas de usuário, de grupos e arquivos de sistema relacionados
+    2.  Agendamento de tarefas administrativas de sistema
+    3.  Localização e internacionalização
+7.  Serviços Essenciais do Sistema
+    1.  Data e hora do sistema
+    2.  Log do sistema
+    3.  Impressoras e impressão
+8.  Fundamentos de Rede
+    1.  Identificação dos protocolos da internet no sistema
+    2.  Configuração persistente de interfaces de rede
+    3.  Soluções para problemas simples de rede
+    4.  Configuração do DNS/DHCP cliente
+9.  Segurança
+    1.  Tarefas administrativas de segurança
+        1.  Arquivos com SUID e SGID
+        2.  Gerenciamento e validade das senhas
+        3.  Descoberta de portas abertas
+        4.  Limites em logins de usuário, processos e uso de memória
+        5.  Manipulação dos usuários conectados
+        6.  Execução de comandos como superusuário
+    2.  Configuração da segurança do host
+    3.  Proteção de dados com criptografia
+        1.  SSH
+        2.  GnuPG
+
+### Procedimentos Metodológicos
+
+Para o desenvolvimento desta disciplina, adotaremos aulas expositivas dialogadas e atividades práticas. Utilizaremos abordagens diversificadas e dinâmicas que integrem conteúdos teóricos e práticos, por meio de métodos de resolução de problemas, trabalhos em grupo, estudos dirigidos e uso de tecnologias educacionais. Consideramos essencial, ainda, a utilização de recursos como laboratórios, slides, vídeos, softwares, simulações de experimentos e outros materiais didáticos que favoreçam um envolvimento mais eficaz e motivador dos(as) estudantes no processo de ensino-aprendizagem.
+
+### Recursos Didáticos
+
+Quadro branco, computador, laboratório adequado para a disciplina, projetor multimídia, vídeos, softwares de apoio, material teórico específico e outras ferramentas tecnológicas.
+
+### Avaliação
+
+A avaliação realizar-se-á de forma dialógica, diagnóstica, processual, formativa e contínua, mediante sistematização dos conteúdos, estabelecendo-se relações entre os objetivos propostos e sua efetivação, considerando a frequência, a colaboração e a participação nas atividades desenvolvidas individuais ou em grupo, utilizando-se instrumentos avaliativos diversificados e compatíveis com a natureza da disciplina. Portanto, considera-se o desenvolvimento de avaliações escritas e práticas, trabalhos em grupo e individuais e apresentação de seminários. 
+
+### Bibliografia Básica
+
+- SIQUEIRA, Luciano Antonio. Certificação LPI-1. 4. ed. São Paulo: Linux New Media do Brasil, 2012. 253 p. il. (Linux Pro).
+- SIQUEIRA, Luciano Antonio. Certificação LPI-2. 3. ed. São Paulo: Linux New Media do Brasil, 2012. 309 p. il. (Linux Pro).
+- INSTITUTE, Linux Professional, Linux Essentials versão 1.6 em Português, ed. 1.6., s.l., Linux Professional Institute. 2025, 453 p.. disponível em: https://learning.lpi.org/pt/learning-materials/010-160/
+
+### Bibliografia Complementar
+
+- ALVES, Moisés Pereira. Linux modo texto para profissionais. Florianópolis: Visual Books, 2006. 158 p. il.
+- SOARES, Walace; FERNANDES, Gabriel. Linux: fundamentos. 1. ed. São Paulo: Érica, 2010. ISBN 978-85-365-0321-9.
+- RAMOS, Juliano. Guia prático do servidor Linux Administração Linux para iniciantes. 2 ed. São Paulo, Casa do Código, 2023, 178p. ISBN978-85-94188-78-6

pyproject.toml

@@ -1,12 +1,13 @@
 [project]
 name = "doce"
 version = "0.1.0"
-description = "Add your description here"
+description = "Documentação Estudantil"
 readme = "README.md"
 requires-python = ">=3.14"
 dependencies = [
     "furo>=2025.12.19",
     "myst-parser>=5.0.0",
+    "python-dotenv>=1.2.2",
     "sphinx>=9.1.0",
     "sphinx-autobuild>=2025.8.25",
     "sphinxcontrib-bibtex>=2.6.5",

uv.lock

@@ -119,6 +119,7 @@ source = { virtual = "." }
 dependencies = [
     { name = "furo" },
     { name = "myst-parser" },
+    { name = "python-dotenv" },
     { name = "sphinx" },
     { name = "sphinx-autobuild" },
     { name = "sphinxcontrib-bibtex" },
@@ -129,6 +130,7 @@ dependencies = [
 requires-dist = [
     { name = "furo", specifier = ">=2025.12.19" },
     { name = "myst-parser", specifier = ">=5.0.0" },
+    { name = "python-dotenv", specifier = ">=1.2.2" },
     { name = "sphinx", specifier = ">=9.1.0" },
     { name = "sphinx-autobuild", specifier = ">=2025.8.25" },
     { name = "sphinxcontrib-bibtex", specifier = ">=2.6.5" },
@@ -332,6 +334,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" },
 ]
 
+[[package]]
+name = "python-dotenv"
+version = "1.2.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/82/ed/0301aeeac3e5353ef3d94b6ec08bbcabd04a72018415dcb29e588514bba8/python_dotenv-1.2.2.tar.gz", hash = "sha256:2c371a91fbd7ba082c2c1dc1f8bf89ca22564a087c2c287cd9b662adde799cf3", size = 50135, upload-time = "2026-03-01T16:00:26.196Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0b/d7/1959b9648791274998a9c3526f6d0ec8fd2233e4d4acce81bbae76b44b2a/python_dotenv-1.2.2-py3-none-any.whl", hash = "sha256:1d8214789a24de455a8b8bd8ae6fe3c6b69a5e3d64aa8a8e5d68e694bbcb285a", size = 22101, upload-time = "2026-03-01T16:00:25.09Z" },
+]
+
 [[package]]
 name = "pyyaml"
 version = "6.0.3"