Guia de Estilo - Revision history

Chaser Zaks: /* Arquivos, endereços, URLs, códigos e outros dados de entrada */

2017-06-27T15:51:09Z

Arquivos, endereços, URLs, códigos e outros dados de entrada

← Older revision		Revision as of 08:51, 27 June 2017
Line 329:		Line 329:
	Para exemplos de códigos que ocupem muitas linhas, faça o uso de [[Syntax Highlighting Examples/pt\|como destacar uma sintaxe]].		Para exemplos de códigos que ocupem muitas linhas, faça o uso de [[Syntax Highlighting Examples/pt\|como destacar uma sintaxe]].

	<python> # Olá Mundo! em Python		<syntaxhighlight lang="python"> # Olá Mundo! em Python

	def main():		def main():
Line 335:		Line 335:

	if __name__ == '__main__':		if __name__ == '__main__':
	main()</~~python~~>		main()</syntaxhighlight>

	=== Tabelas ===		=== Tabelas ===

Gianinni Babenco: + Extended Knowledge Base

2011-11-11T16:33:16Z

+ Extended Knowledge Base

← Older revision		Revision as of 09:33, 11 November 2011
Line 3:		Line 3:
	{{KBtip\|Você não é obrigado a seguir este Guia de Estilo para montar as páginas da wiki, mas o guia pode ajudá-lo a se tornar um editor mais eficiente, pois vai se relacionar melhor com os artigos já existentes. Fique a vontade para adotar essas práticas!}} {{TOCright}}		{{KBtip\|Você não é obrigado a seguir este Guia de Estilo para montar as páginas da wiki, mas o guia pode ajudá-lo a se tornar um editor mais eficiente, pois vai se relacionar melhor com os artigos já existentes. Fique a vontade para adotar essas práticas!}} {{TOCright}}

	'''Tem interesse em contribuir para a Extensão da Base de Conhecimento? Por favor leia este guia e obtenha uma melhor compreensão da formatação que estamos aqui utilizando, para elaborar documentos bem estruturados, que não são apenas bem escritos, mas fáceis de ler.'''		'''Tem interesse em contribuir para a [[Extended Knowledge Base\|Extensão da Base de Conhecimento]]? Por favor leia este guia e obtenha uma melhor compreensão da formatação que estamos aqui utilizando, para elaborar documentos bem estruturados, que não são apenas bem escritos, mas fáceis de ler.'''

	Nosso guia de estilo é inspirado pelo sucesso da adoção de simples convenções, tal como acontece na Wikipédia, com o seu [http://pt.wikipedia.org/wiki/Wikip%C3%A9dia:Livro_de_estilo livro de estilo] que ajuda a padronizar os verbetes. Mas aqui inserimos detalhes da experiência do Second Life®. Este guia está aberto à mudanças ao longo do tempo, mas procura dar a você, uma base de consulta em caso de dúvida.		Nosso guia de estilo é inspirado pelo sucesso da adoção de simples convenções, tal como acontece na Wikipédia, com o seu [http://pt.wikipedia.org/wiki/Wikip%C3%A9dia:Livro_de_estilo livro de estilo] que ajuda a padronizar os verbetes. Mas aqui inserimos detalhes da experiência do Second Life®. Este guia está aberto à mudanças ao longo do tempo, mas procura dar a você, uma base de consulta em caso de dúvida.

Gianinni Babenco: /* Tabelas */ Correção

2011-11-11T09:12:41Z

Tabelas: Correção

← Older revision		Revision as of 02:12, 11 November 2011
Line 353:		Line 353:
	\|-		\|-
	\| '''Linha A'''		\| '''Linha A'''
	\| ~~fill~~		\| complete
	\| in		\| estes
	\| ~~these~~		\| campos e

	\|-		\|-
	\| '''Linha B'''		\| '''Linha B'''
	\| ~~values~~		\| ganhe
	\| ~~and~~		\| um
	\| ~~win~~		\| prêmio

	\|}		\|}

Gianinni Babenco: /* Imagens */ Atualização.

2011-11-10T23:37:51Z

Imagens: Atualização.

← Older revision		Revision as of 16:37, 10 November 2011
Line 492:		Line 492:

	Geralmente se envia uma imagem como [http://pt.wikipedia.org/wiki/PNG PNG] e desde que não ocorram perdas, a wiki deve ajustá-la de forma dinâmica.		Geralmente se envia uma imagem como [http://pt.wikipedia.org/wiki/PNG PNG] e desde que não ocorram perdas, a wiki deve ajustá-la de forma dinâmica.

			Não use acentuação, cedilha ou til ao nomear uma imagem. Esta wiki não vai inserir a imagem na página desejada. Uma futura atualização do software da wiki deverá eliminar esta restrição.

	As imagens devem ser inseridas nos artigos com o tamanho de 640 pixels (640px) ou menos, se as dimensões da imagem original forem legíveis para tamanho menores. O exemplo abaixo tende a ser um bom equilíbrio entre visibilidade e conteúdo:		As imagens devem ser inseridas nos artigos com o tamanho de 640 pixels (640px) ou menos, se as dimensões da imagem original forem legíveis para tamanho menores. O exemplo abaixo tende a ser um bom equilíbrio entre visibilidade e conteúdo:

Gianinni Babenco: Ajustes.

2011-11-10T22:30:49Z

Ajustes.

← Older revision		Revision as of 15:30, 10 November 2011
Line 551:		Line 551:
	=== Gabaritos de navegação ===		=== Gabaritos de navegação ===
	{{Navbox/Wiki/pt}}		{{Navbox/Wiki/pt}}
	{{KBcaution\|Esta especificação está sendo desenvolvida. Opte em reutilizar os gabaritos de navegação já existentes da versão em inglês, traduzindo para o português. Caso contrário entre em contato com ~~Linden~~ [[~~Torley~~]], para o uso de novos tipos de gabaritos}}		{{KBcaution\|Esta especificação está sendo desenvolvida. Opte em reutilizar os gabaritos de navegação já existentes da versão em inglês, traduzindo para o português. Caso contrário entre em contato com a [[Project:About/pt#Lindens participantes\|equipe de documentação]], para o uso de novos tipos de gabaritos}}

	Você poderá usar o conjunto de gabaritos existentes em: '''[[Template:Navbox\|navigation templates]]''' que fornecem ligações fáceis entre artigos relacionados, como por exemplo, o gabarito [[Template:Navbox/Wiki/pt]] acima a direita, realiza.		Você poderá usar o conjunto de gabaritos existentes em: '''[[Template:Navbox\|navigation templates]]''' que fornecem ligações fáceis entre artigos relacionados, como por exemplo, o gabarito [[Template:Navbox/Wiki/pt]] acima a direita, realiza.

Gianinni Babenco: /* Vídeos */ Ajuste.

2011-10-29T18:26:20Z

Vídeos: Ajuste.

← Older revision		Revision as of 11:26, 29 October 2011
Line 547:		Line 547:


	'''Nota:''' Para vídeos situados no Youtube, use o gabarito: <nowiki>{{KBvideo\|xxxxx\|425\|344\|type=youtube}}</nowiki> , onde xxxxx é uma string obtida da URL do vídeo. Os valores 425 e 344 definem o tamanho do vídeo. ~~(Veja mais~~ em [[Template:KBvideo]].		'''Nota:''' Para vídeos situados no Youtube, use o gabarito: <nowiki>{{KBvideo\|xxxxx\|425\|344\|type=youtube}}</nowiki> , onde xxxxx é uma string obtida da URL do vídeo. Os valores 425 e 344 definem o tamanho do vídeo. Para maiores detalhe veja em [[Template:KBvideo]].

	=== Gabaritos de navegação ===		=== Gabaritos de navegação ===

Gianinni Babenco: /* Vídeos */ + um parágrafo.

2011-10-29T18:23:56Z

Vídeos: + um parágrafo.

← Older revision		Revision as of 11:23, 29 October 2011
Line 545:		Line 545:

	Veja [http://secondlife.com/video aqui vídeos tutoriais] do Second Life. Necessário se logar no site da Linden lab.		Veja [http://secondlife.com/video aqui vídeos tutoriais] do Second Life. Necessário se logar no site da Linden lab.


			'''Nota:''' Para vídeos situados no Youtube, use o gabarito: <nowiki>{{KBvideo\|xxxxx\|425\|344\|type=youtube}}</nowiki> , onde xxxxx é uma string obtida da URL do vídeo. Os valores 425 e 344 definem o tamanho do vídeo. (Veja mais em [[Template:KBvideo]].

	=== Gabaritos de navegação ===		=== Gabaritos de navegação ===

Gianinni Babenco: Correções.

2011-10-28T13:52:59Z

Correções.

Gianinni Babenco: /* Arquivos, endereços, URLs, códigos e outros dados de entrada */ Eliminando duplo redirecionamento.

2011-09-03T19:10:14Z

Arquivos, endereços, URLs, códigos e outros dados de entrada: Eliminando duplo redirecionamento.

← Older revision		Revision as of 12:10, 3 September 2011
Line 327:		Line 327:
	Coloque URLs longas em linhas separadas, fazendo o uso do código <code><pre></code>.		Coloque URLs longas em linhas separadas, fazendo o uso do código <code><pre></code>.

	Para exemplos de códigos que ocupem muitas linhas, faça o uso de [[~~Como destacar uma sintaxe~~\|como destacar uma sintaxe]].		Para exemplos de códigos que ocupem muitas linhas, faça o uso de [[Syntax Highlighting Examples/pt\|como destacar uma sintaxe]].

	<python> # Olá Mundo! em Python		<python> # Olá Mundo! em Python

Gianinni Babenco: /* Marca registrada */ Edições avançadas na wiki

2011-08-23T19:58:31Z

Marca registrada: Edições avançadas na wiki

← Older revision		Revision as of 12:58, 23 August 2011
Line 615:		Line 615:
	=== Marca registrada ===		=== Marca registrada ===
	Em primeira instância os artigos do Second Life devem ter o símbolo da [http://pt.wikipedia.org/wiki/Marca_registrada marca registrada] junto ao nome. Nossa marca registrada sempre deve ser respeitada e [http://secondlife.com/corporate/brand/trademark/ aqui poderá saber mais sobre o assunto].		Em primeira instância os artigos do Second Life devem ter o símbolo da [http://pt.wikipedia.org/wiki/Marca_registrada marca registrada] junto ao nome. Nossa marca registrada sempre deve ser respeitada e [http://secondlife.com/corporate/brand/trademark/ aqui poderá saber mais sobre o assunto].

			=== Edições avançadas na wiki ===

			A Wiki do Second Life continua crescendo e nós louvamos a participação dos Residentes a ajudar a evoluir os estilos. Deve estar ciente que alguns estilos são muito úteis para outras Wikis, mas elas ainda não se aplicam a nós. Várias questões sobre este assunto estão registrados em [[User:Torley/Code]].

			Por favor, não faça qualquer grande alteração de estilo sem consultar em primeiro lugar, a [[Doc_team\|Equipe de Documentação]]. Estamos aqui para ajudar e ficaríamos feliz em dar uma olhada.

← Older revision		Revision as of 06:52, 28 October 2011
Line 29:		Line 29:
	Em ambos os casos, o primeiro parágrafo do artigo deve responder a uma pergunta não formulada:		Em ambos os casos, o primeiro parágrafo do artigo deve responder a uma pergunta não formulada:

	# Depois que eu li isso, o que devo ser capaz de fazer? (Bastante ~~auto-evidente~~.)		# Depois que eu li isso, o que devo ser capaz de fazer? (Bastante autoevidente.)
	# Depois que eu li isso, o que devo entender melhor?		# Depois que eu li isso, o que devo entender melhor?

Line 76:		Line 76:

	=== Escopo sobre a Base de Conhecimento ===		=== Escopo sobre a Base de Conhecimento ===
	Um problema básico que sempre acontece nas wikis é a proliferação de páginas que contêm assuntos semelhantes ou até mesmo duplicados, porém sem interligação (links) entre elas. Este fato ocorre naturalmente com o crescimento da wiki. Isso acontece devido a falta de existência de um planejamento centralizado, capaz de localizar estas páginas e ~~organiza~~-las.		Um problema básico que sempre acontece nas wikis é a proliferação de páginas que contêm assuntos semelhantes ou até mesmo duplicados, porém sem interligação (links) entre elas. Este fato ocorre naturalmente com o crescimento da wiki. Isso acontece devido a falta de existência de um planejamento centralizado, capaz de localizar estas páginas e organizá-las.

	Quando se trata de documentação do Second Life devemos lembrar, por exemplo, que um [http://pt.wikipedia.org/wiki/FAQ FAQ] sobre o pagamento de uma propriedade deve estar integrado - ou no mínimo, intimamente ligado - ao artigo principal sobre o pagamento de uma propriedade.		Quando se trata de documentação do Second Life devemos lembrar, por exemplo, que um [http://pt.wikipedia.org/wiki/FAQ FAQ] sobre o pagamento de uma propriedade deve estar integrado - ou no mínimo, intimamente ligado - ao artigo principal sobre o pagamento de uma propriedade.
Line 101:		Line 101:
	=== Termos específicos utilizados no Second Life ===		=== Termos específicos utilizados no Second Life ===

	* "inworld" (costumava-se ser escrito como "in-world," mas seguiu o mesmo caminho usado para "[http://pt.wikipedia.org/wiki/E-mail e-mail]" sendo mais utilizado a forma ~~email~~).		* "inworld" (costumava-se ser escrito como "in-world," mas seguiu o mesmo caminho usado para "[http://pt.wikipedia.org/wiki/E-mail e-mail]" sendo mais utilizado a forma e-mail).
	* "rez" ou "rezzed" (não ressed/rezed/res). Não use aqui as maiúsculas.		* "rez" ou "rezzed" (não ressed/rezed/res). Não use aqui as maiúsculas.
	* Sempre inicie as palavras com maiúsculas para "Second Life."		* Sempre inicie as palavras com maiúsculas para "Second Life."
Line 117:		Line 117:
	=== Elementos da interface do usuário ===		=== Elementos da interface do usuário ===

	Seria interessante fazer o uso de alguns termos padrões para ~~aplica~~-los em toda a Base de Conhecimento para se referir a elementos da ''interface do usuário'', muitas vezes denominado de UI ("user interface" em inglês).		Seria interessante fazer o uso de alguns termos padrões para aplicá-los em toda a Base de Conhecimento para se referir a elementos da ''interface do usuário'', muitas vezes denominado de UI ("user interface" em inglês).

	Interface de Usuário são as diversas estruturas pertencentes ao Visualizador, onde o usuário interage.		Interface de Usuário são as diversas estruturas pertencentes ao Visualizador, onde o usuário interage.
Line 151:		Line 151:
	É importante ressaltar que existem vários tipos de diálogos, como a notificação do grupo ou do status de um amigo, que aparecem embaixo a direita por alguns segundos como por exemplo: "uma caixa de notificação aparece no canto inferior direito, informando que um de seus amigos está on-line ".		É importante ressaltar que existem vários tipos de diálogos, como a notificação do grupo ou do status de um amigo, que aparecem embaixo a direita por alguns segundos como por exemplo: "uma caixa de notificação aparece no canto inferior direito, informando que um de seus amigos está on-line ".

	{{KBnote\|No novo Visualizador, nós consideramos simplesmente chamar de notificação, porque apenas notificam ao Residente que alguma coisa aconteceu e que não apresenta o ~~boão~~ Sim/Não, na qual a maioria dos diálogos aparecem.}}		{{KBnote\|No novo Visualizador, nós consideramos simplesmente chamar de notificação, porque apenas notificam ao Residente que alguma coisa aconteceu e que não apresenta o botão Sim/Não, na qual a maioria dos diálogos aparecem.}}

	* '''Abas''' ("Tabs" em inglês) - Dentro das janelas no Second Life, você vai encontrar no alto, algumas abas. Por exemplo:		* '''Abas''' ("Tabs" em inglês) - Dentro das janelas no Second Life, você vai encontrar no alto, algumas abas. Por exemplo:
Line 266:		Line 266:
	*** Selecione '''Mundo''' > '''Sol''' > '''Pôr-do-sol''' para ambientar imediatamente o pôr-do-sol. (pôr-do-sol ou pôr do Sol)		*** Selecione '''Mundo''' > '''Sol''' > '''Pôr-do-sol''' para ambientar imediatamente o pôr-do-sol. (pôr-do-sol ou pôr do Sol)
	* '''Não use negrito''' - Não faça o uso do negrito para os nomes das janelas.		* '''Não use negrito''' - Não faça o uso do negrito para os nomes das janelas.
	* '''Itálico''' - Use o itálico com parcimônia, em situações de EXTREMA ~~ÉNFASE~~ (na qual deverão ser raros de acontecer). E mesmo em raras situações, em textos que acompanham as imagens.		* '''Itálico''' - Use o itálico com parcimônia, em situações de EXTREMA ÊNFASE (na qual deverão ser raros de acontecer). E mesmo em raras situações, em textos que acompanham as imagens.
	* '''Aspas''' - Quando você necessitar especificar algo que o usuário precisa dar a entrada, o coloque entre as aspas. Isso geralmente é aplicável apenas a textos a serem escritos nos campos, e é provavelmente uma rara situação se necessitar especificar uma sequência exata, do que deve ser digitado.		* '''Aspas''' - Quando você necessitar especificar algo que o usuário precisa dar a entrada, o coloque entre as aspas. Isso geralmente é aplicável apenas a textos a serem escritos nos campos, e é provavelmente uma rara situação se necessitar especificar uma sequência exata, do que deve ser digitado.
	* '''Pontuação''' - Evite fazer o uso da pontuação no sentido de abreviar uma palavra. Por exemplo:		* '''Pontuação''' - Evite fazer o uso da pontuação no sentido de abreviar uma palavra. Por exemplo:
Line 310:		Line 310:
	<nowiki>* Considere isso!</nowiki>		<nowiki>* Considere isso!</nowiki>
	<nowiki>* Considere isto!</nowiki>		<nowiki>* Considere isto!</nowiki>
	<nowiki>** Ou use dois asteriscos, mas não ~~exargere~~</nowiki>		<nowiki>** Ou use dois asteriscos, mas não exagere</nowiki>

	Se você está iniciando um longo parágrafo com um asterisco, considere fazer o uso de uma listagem, para que o texto fique melhor formatado.		Se você está iniciando um longo parágrafo com um asterisco, considere fazer o uso de uma listagem, para que o texto fique melhor formatado.