Difference between revisions of "Redactar"

From Asociación de Robótica UC3M
Jump to navigation Jump to search
(Replaced content with "__NOTITLE__ ---- '''Por favor rediríjanse a NUEVO TUTORIAL: https://github.com/asrob-uc3m/tutoriales/blob/master/writing/redactar.md''' ----")
 
(26 intermediate revisions by the same user not shown)
Line 1: Line 1:
Para redactar, existen dos herramientas populares: [https://es.wikipedia.org/wiki/Microsoft_Word Microsoft Word], y [http://es.wikipedia.org/wiki/LaTeX LaTeX]. Microsoft Word es más visual, y LaTeX se parece más a programar. Una ventaja de LaTeX es que es Open Source, por tanto, si falla algo, puede ser difícil, pero tienes la posibilidad de arreglarlo.
+
__NOTITLE__
  
Nota para UC3M: Existe mucha documentación en Campus Global, y en UC3M/Biblioteca (incluida [http://asrob.uc3m.es/images/d/d2/RubricaPFC.pdf Matriz de Criterios de Evaluación de PFCs de la UC3M]
+
----
, y hoja Excel para presupuestos (?)).
 
  
== Plantillas ==
+
'''Por favor rediríjanse a NUEVO TUTORIAL: https://github.com/asrob-uc3m/tutoriales/blob/master/writing/redactar.md'''
  
* [[media:PlantillaTFG.zip|TFG LaTeX (UC3M)]]. Tutorial para éste: [[LaTeX para TFG en Ubuntu|Ubuntu TFG LaTeX (UC3M)]].
+
----
 
 
* [[media:Master_template.zip|Master LaTeX (UC3M)]]. [[media:Portada juan.pptx|Portada Master PPTX (UC3M)]].
 
 
 
== Índice ==
 
* Una profundidad de índice admisible es hasta 3 subniveles (sección 2.3.4), aunque luego en el documento se desglosen más (sección 2.3.4.c).
 
* Cantidad de páginas por capítulo compensado (no tiene sentido que un capítulo sea de 80 páginas y otro de 3).
 
* Aquí un ejemplo de índice:
 
# Introducción (con introducción, objetivos, estructura del documento)
 
# [[#Estado_del_arte|Estado del arte]] A+B+C
 
# Arquitectura global
 
# Desarrollo A
 
# Desarrollo B
 
# Desarrollo C
 
# Experimentos y resultados
 
# Conclusiones y líneas futuras (con conclusiones y líneas futuras)
 
** [[#Bibliograf.C3.ADa|Bibliografía]]
 
** Anexos (sí: presupuesto)(posible: partes relevantes de datasheets)(no códigos fuentes completos, mejor proporcionar URL en documento).
 
 
 
== Estado del arte ==
 
* El estado del arte de un documento científico debería consistir en referencias a documentos científicos que componen la [[#Bibliograf.C3.ADa|Bibliografía]], tanto por que sean útiles o porque posteriormente se debata que se hayan superado. También debería servir para explicar alternativas software o hardware, como apoyo para justificar decisiones de diseño que se tomen más adelante en el documento.
 
 
 
== Formato ==
 
* Respecto a títulos de documento/capítulo/secciones: "Esto es un título en español". "This Is A Title In English". Ninguno acaba en punto.
 
* Como norma general, ceñirse a las plantillas, sin modificar márgenes ni introducir excesivos modificadores de formato. La inclusión de ciertos paquetes de LaTeX también pueden crear conflictos.
 
* Texto justificado (no alineado a izquierda).
 
* Evitar faltas de ortografía/gramática.
 
* Evitar faltas en la puntuación: espacio después de punto, etc. Cuidado en mayúsculas/minúsculas.
 
* Evitar la reutilización de frases completas de otros documentos (copia+pega). Incluso las licencias más abiertas piden que se cite la fuente original.
 
* Utilizar frases cortas. Como regla general, se puede pensar "no más de un concepto por frase, tal vez más de una frase para explicar un solo concepto".
 
* Coherencia interna. Ejemplo 1: MTi debe aparecer siempre como MTi, no MTI a veces. Ejemplo 2: Un algoritmo es siempre un algoritmo, no pasa a ser un método o infraestructura en un mismo documento.
 
<!-- * Sin redundancia, salvo que sea por coherencia interna (que ocurrirá muchas veces). -->
 
* Evitar extranjerismos sin referenciar (p.e. si el docuemento está en español, como mínimo poner pie de página ante anglicismos).
 
* Respecto a citas bibliográficas:
 
** La regla general es citar la referencia sólo la primera vez que aparece. Excepciones: no se introduce en el resumen/abstract (sí en la introducción); se puede volver a citar cuando ha pasado un cierto número de páginas (p.ej. capítulos diferentes).
 
** Se deja un espacio entre la palabra y la referencia, como se hace en esta frase [1]. Es recomendable, además, que esta frase pueda leerse habiendo omitido la referencia (p.antiejemplo: léase [3] y [16]).
 
* Respecto a ecuaciones:
 
** Referencias entre paréntesis (no corchetes).
 
 
 
== Figuras ==
 
* Centradas.
 
* Sin deformar (conservar proporciones originales).
 
* Texto explicativo debajo y también centrado.
 
* Figuras siempre referenciadas. Si es posible, cerca de la propia figura, y antes de aparecer.
 
* Figuras vectoriales. Siempre que se pueda (logotipos, diagramas de flujo, etc) crear y utilizar imágenes de tipo vectorial. Estas imágenes no se pixelan con cambios de zoom. Se recomienda Inkscape como la alternativa libre referencia (existe Corel como modalidad de pago). Para generar diagramas, tanto yEd (freeware) como Dia (libre) son buneas opciones. Powerpoint también puede exportar a formatos vectoriales. El formato vectorial editable más recomendable es el .svg de Inkscape, o los propios de cada programa. Para incrustar en documentos LaTeX (pdflatex), se recomienda exportar a PDF. Para incrustar en documentos Word, se recomienda exportar a EMF (o WMF si sale mal). Aquí un enlace con logos en vectorial: https://svn.code.sf.net/p/asrob/svn/admin/Logos/
 
* Un buscador para imágenes libres: http://search.creativecommons.org/
 
 
 
== Tablas ==
 
* Centradas.
 
* Texto explicativo normalmente encima y también centrado.
 
 
 
== Bibliografía ==
 
* Es necesario que todos los elementos de la bibliografía estén referenciados.
 
* El orden de los elementos debe ser el de aparición en el documento (ciertos autores prefieren orden alfabético).
 
* Tratar de evitar bibliografía del que solo se disponga una URL (foros, webs...). En caso de ser realmente necesario, es obligatorio poner la fecha de acceso: "(último acceso 22 de febrero de 2011)".
 
* En lugar de foros o webs, tratar de utilizar bibliografía científica: preferiblemente "Journals", o "Proceedings of Conferences" si no.
 
* Para localizar bibliografía científica, utiliza buscadores como [http://scholar.google.es Google Académico] o [http://ieeexplore.ieee.org/Xplore/guesthome.jsp?reload=true IEEExplore] que dispongan de la opción de '''importar citas a BibTex''' o semejante. Esto se activa en Google Académico hacia el final de la siguiente [http://scholar.google.es/scholar_preferences?hl=es&as_sdt=0,5 página de configuración].
 
 
 
== Úlitmos consejos ==
 
* ¡Releer el documento entero mínimo una vez!
 
 
 
== Más enlaces de interés ==
 
* Consejos generales para la [[Presentar| presentación de un documento]].
 
* [[File:Formatobasicopararedactareportes.pdf]]
 

Latest revision as of 20:25, 4 June 2018