Jump to content

Ajuda:Recurso de Censura e Segredos

From Vampiro

🔒 Recurso de Censura & Segredos — Guia Técnico Interno

Este artigo documenta a arquitetura, parâmetros, arquivos envolvidos e procedimentos de manutenção do recurso de Censura e Segredos Dinâmicos implementado no wiki da crônica Vampiro: A Máscara.

🩸 Visão Geral

O recurso permite que o Narrador ou criador de um artigo oculte trechos de texto sensível sob uma tarja preta sólida (estética de documentos censurados / dossiês da Segunda Inquisição). O texto fica invisível para todos os leitores até que:

  1. O criador libere manualmente (alterando para liberado=sim); ou
  2. Uma data de desclassificação programada seja atingida (data=2026-10-15).

Ao passar o mouse sobre a tarja, o leitor vê o tooltip temático: [INFORMAÇÃO SENSÍVEL - BLOQUEADO PELA CAMARILLA].

📁 Arquivos Envolvidos no Sistema

Arquivo Localização Função
Template:Segredo Template:Segredo Predefinição que gera a tag com atributos data-*
MediaWiki:Common.js MediaWiki:Common.js LIBERADO]
MediaWiki:Common.css MediaWiki:Common.css (seção 14) Estilos visuais da tarja (censurado, revelado e bloco)
MediaWiki:Vector-2022.css MediaWiki:Vector-2022.css (seção 14) Espelho dos estilos para o skin Vector 2022

⚙️ Parâmetros da Predefinição

Uso básico: {{Segredo|Texto confidencial|liberado=nao}}

Parâmetro Obrigatório Tipo Valores Descrição
1 (sem nome) Sim Texto Qualquer texto O conteúdo que ficará oculto sob a tarja preta.
liberado Não String nao / sim Controle manual de liberação. Padrão: nao (censurado).
data Não Data AAAA-MM-DD ou DD/MM/AAAA Data a partir da qual o texto será desclassificado automaticamente.
tipo Não String inline / bloco inline = tarja no meio da frase. bloco = caixa de dossiê completa. Padrão: inline.
dica Não String Texto livre Nome-código exibido no tooltip (ex: "Identidade do Infiltrado").
nivel Não String Texto livre Nível de sigilo para o carimbo no formato bloco. Padrão: CONFIDENCIAL.

📖 Exemplos Práticos de Uso

1. Tarja Inline com Liberação Manual

O traidor foi identificado como {{Segredo|Padre Tiago|liberado=nao|dica=Identidade do Infiltrado}}.

Resultado para o leitor: O traidor foi identificado como Padre Tiago.

2. Tarja Inline com Liberação por Data

A localização do refúgio é {{Segredo|Cripta da Sé de Lisboa|data=2027-01-01}}.

O texto permanecerá coberto até 01/01/2027, quando será revelado automaticamente.

3. Tarja Já Liberada (Texto Visível)

O líder da revolta era {{Segredo|Aiden, o Monstro das Catacumbas|liberado=sim}}.

Resultado: O líder da revolta era Aiden, o Monstro das Catacumbas.

4. Dossiê em Bloco (Relatório Completo)

{{Segredo|tipo=bloco|nivel=RELATÓRIO SAD // CONFIDENCIAL|data=2027-06-01|dica=Operação Lisboa|
O destacamento interceptou três mensageiros no Parque das Nações.
Foram confiscadas três chaves criptografadas e um diário de sangue pertencente a Duarte Montenegro.
}}

🛠️ Ferramentas no Editor

1. Barra de Ferramentas Rápida (Editor de Código-Fonte)

Ao editar pelo código-fonte, uma barra temática com borda carmesim aparece logo acima do campo de digitação:

  • ⬛ Censurar Trecho — Envolve a seleção com {{Segredo|...|liberado=nao}}.
  • 🔓 Inserir Liberado — Envolve a seleção com {{Segredo|...|liberado=sim}}.
  • 📁 Dossiê Bloco — Insere a estrutura completa de um relatório confidencial.
  • 🗑️ Remover Censura — Remove a predefinição mantendo o texto interno limpo.

2. Botões Interativos no Modal do VisualEditor

Ao editar a predefinição pelo VisualEditor:

  • O campo textual de liberado é substituído por botões clicáveis:
 * [ ⬛ CENSURADO ] (vermelho escuro)
 * [ 🔓 LIBERADO ] (verde esmeralda)

3. Menu Inserir do VisualEditor

  • Opção 🔒 Censura / Segredo (Confidencial) disponível no menu superior de inserção.

🔍 Arquitetura e Linhas de Código Importantes

Lógica de Revelação (MediaWiki:Common.js)

A função initVtmSecrets() avalia a revelação segundo a seguinte precedência:

  1. Se data-liberado === "sim" (ou "true"/"1") → Adiciona .is-revealed (texto visível).
  2. Se data-liberado === "nao" → Adiciona .is-redacted (tarja preta ativa).
  3. Se houver data-reveal-date → Compara com new Date():
    • Se agora >= data → Revela automaticamente.
    • Se agora < data → Mantém censurado e exibe a data formatada no tooltip.
  4. Padrão: .is-redacted.

Estilos Visuais (MediaWiki:Common.css)

  • .vtm-segredo.is-redacted: background: #0a0a0e; color: transparent; user-select: none;
  • .vtm-segredo.is-revealed: background: rgba(45,12,18,.4); color: #f5f0e6; font-family: 'Special Elite';
  • .vtm-segredo[data-tipo="bloco"]: display: block; border-left: 4px solid;

🔧 Guia para Edições e Manutenções Futuras

Como alterar o texto do tooltip da Camarilla?

Edite MediaWiki:Common.js e altere os textos dentro das variáveis tip nas linhas ~19 e ~24: 

tip = '[INFORMAÇÃO SENSÍVEL - BLOQUEADO PELA CAMARILLA' + (dica ? ' // ' + dica : '') + ']';

Como mudar a cor da tarja?

Edite a seção 14. TARJA DE CENSURA em MediaWiki:Common.css e MediaWiki:Vector-2022.css:

  • Altere background: #0a0a0e na regra .vtm-segredo.is-redacted.

Como adicionar novos campos ao Segredo?

  1. Adicione o atributo no Template:Segredo: data-novo-parametro="".
  2. Leia o atributo em MediaWiki:Common.js dentro de initVtmSecrets(): el.getAttribute('data-novo-parametro').
  3. Atualize a seção <templatedata> na documentação do template.

Categoria:Documentação Categoria:Ajuda

Retrieved from "https://vampiro-a-mascara.loboazul.com.br/index.php?title=Ajuda:Recurso_de_Censura_e_Segredos&oldid=402"