mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-12-27 10:30:28 +00:00
fa61bc53fc
* TW5-es-ES-edition Spanish edition of TW5. A full localisation of TiddlyWiki into castillian spanish (es-ES). * Translation ongoing * Translation ongoing * Translation ongoing * Translation ongoing + TiddlySpot upload * Translation ongoing * Translation ongoing + macro fixes * Translation ongoing * translation ongoing + macro fixes * Translation ongoing * Translation ongoing * Translation ongoing * Translation ongoing * Translation ongoing * translation ongoing * translation ongoing * Translation ongoing * translation ongoing * translation ongoing * translation ongoing * Arreglo plugin * Arreglo plugin * Translation ongoing * Translation ongoing * Translation ongoing * translation ongoing * Add Spanish edition to TW5.com * Reverting forced language plugin load. folder es-ES was provisorily added to the tiddlerStore in order to force the load of the updated language plugin. Finished the translation, and with the updated plugin on place, this folder has no use when the new release comes out.
36 lines
1.8 KiB
Plaintext
36 lines
1.8 KiB
Plaintext
caption: Estilo: Material de referencia
|
|
created: 20141226192500000
|
|
es-title: Guía de estilo para la redacción de material de referencia
|
|
modified: 20160418141821319
|
|
tags: [[Improving TiddlyWiki Documentation]]
|
|
title: Reference Tiddlers
|
|
type: text/vnd.tiddlywiki
|
|
|
|
Los <<.def "tiddlers de referencia">> ofrecen información al lector --presumiblemente de nivel intermedio o experto-- de manera comprensible e interreferenciada.
|
|
|
|
Se estructura en varias subcategorías:
|
|
|
|
;Conceptos
|
|
|
|
* Definidos, juntos forman un glosario
|
|
|
|
;Manual de usuario
|
|
|
|
* Presenta aspectos técnicos de las características de ~WikiText
|
|
|
|
* Se subdivide en: mensajes, operadores, variables, widgets... etc
|
|
|
|
;Manual de desarrollador
|
|
|
|
* Presenta aspectos técnicos de la arquitectura interna de ~TiddlyWiki
|
|
|
|
El material de referencia se redacta en estilo formal que evita referirse al lector y enfoca su atención en el comportamiento de ~TiddlyWiki. Predomina el uso de la voz pasiva y las expresiones impersonales:
|
|
|
|
Reference material is written in a terse, formal style that avoids referring to the reader, and instead focuses on how ~TiddlyWiki itself behaves. The passive voice is often suitable:
|
|
|
|
* <<.word "se especifica la plantilla como tiddler">> mejor que <<.word "especifica la plantilla como tiddler">>
|
|
* <<.word "el widget puede servir para varios fines">> mejor que <<.word "puedes usar el widget para varios fines">>
|
|
* Pero <<.word "este widget tiene varios usos posibles">> es aún mejor, ya que es más conciso y menos retorcido.
|
|
|
|
Al redactar en inglés, se evita el uso de formas verbales contraídas, pero aquellas que terminan en <<.word "n't">>, como (<<.word "aren't">>, <<.word "doesn't">>, <<.word "hasn't">>, <<.word "isn't">>... etc, son aceptables, ya que así es menos probable que en su lectura se pase por alto el <<.word not>> de las formas no contraídas.
|