Criterios

De SIU
Saltar a: navegación, buscar


Criterio generales

Tratá de usar todo como viene por defecto. La idea es que la wiki sea homogénea, si querés hacer algo distinto lo vemos.

Sobre las url

siempre escribirlas en minúsculas. No usar acentos. El nombre del sistema siempre hay que escribirlo con siu- delante, siu-sistema.

Sobre las tablas

Sobre las imágenes

Si creés que la imagen podría aparecer en otra página de la wiki o en otra página cualquiera, no la subas a la wiki pedile al área de diseño que te la hostee, de esa manera nos aseguramos que haya una única imagen en todos lados y en caso de se necesario reemplazarla sólo reemplazamos un archivo. Lo mismo para los logos, si vas poner un logo del sistema usá el mismo que está en la portada. Tanto las imágenes como cualquier archivo que subas a la wiki debe respetar la siguiente nomenclatura:

<tres primeras letras del nombre del sistema en mayúsculas>_nombre de la imagen todo en minúscula separado cada palabra con _

En el caso de que sea una nueva versión del mismo archivo, se deberá agregar al final antepuesto por "_" la letra "v" acompañada del número de versión.
Ejemplo:

GUA_selector_de_alumnos.png y si se crea una segunda versión: GUA_selector_de_alumnos_v2.png

En el caso de que haya que volver a cargar una misma versión de una imagen, deberá eliminarse la versión cargada y volver a subirla.
Cuando se trate de imágenes institucionales del SIU, las mismas deben leerse directametne desde acá: http://www.siu.edu.ar/rd/


Sobre el código

Para escribir código hay varias maneras: <source lang="php" enclose="div"> </source>
Se ve así

acá el código

otra manera, si te interesa destacar algo en el código:

<syntaxhighlight lang="php" highlight="1-10"> Donde en highlight="x-x" marcamos qué líneas queremos destacar </syntaxhighlight>
Se ve así

Donde en highlight="x-x" marcamos qué líneas queremos destacar

Si querés escribir código y que mediawiki no lo interprete como tal tenés que usar las etiquetas

<nowiki></nowiki>

Sobre los videos

Los videos hay que hosteaslos en Youtube, en la página del SIU y embeberlos en la wiki, para embeberlo hay que usar la siguiente sintaxis:

<youtube>ID del video</youtube>

Comentarios en el código

Para agregar comentarios en el código y que no sean invisibles para el usuario común, la sintaxis es la siguiente:

<!-- Contenido del comentario -->

Quitar la tabla de contenidos

Si aparece de forma automática una tabla de contenidos en una página que no lo amerita, lo mejor es definir que dicha página no tenga TOC. Para ello la sintaxis es la siguiente:

__NOTOC__

Limitar niveles de la tabla de contenido

Mediante la plantilla TOClimit, se puede limitar cuántos niveles de títulos y subtítulos se muestran en las tablas de contenidos. En el siguiente ejemplo cuyo parámetro es 2, se muestran hasta 2 niveles de títulos (o sea ==). Los títulos de tercer nivel (es decir ===) ya no se mostrarán. El resto del código es para alinear a la derecha y darle margen a la TOC.

<span style="float: right; margin: 0 0 15px 15px;">{{TOClimit|2}}</span>

Links anterior y siguiente al pie

En las páginas donde hay que seguir pasos, puede resultar útil agregar links del tipo "anterior" y "siguiente" al pie del contenido. Para que dichos links queden alineados y ordenados, la mejor forma es hacerlo mediante una tabla. Aquí va un ejemplo:

CODIGO

{| style="width:100%;"
|-
| [[SIU-Guarani/Version3.11.0/Migracion/Desde sistemas externos/Migracion/Actividades|< Migrar Actividades]] || align="right" | [[SIU-Guarani/Version3.11.0/Migracion/Desde sistemas externos/Migracion/Personas|Migrar Personas >]]
|}

COMO SE VE http://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.11.0/Migracion/Desde_sistemas_externos/Migracion/Calendario_Academico