Diferencia entre revisiones de «Criterios»
m |
|||
(No se muestran 39 ediciones intermedias de 3 usuarios) | |||
Línea 1: | Línea 1: | ||
__NOINDEX__ | __NOINDEX__ | ||
− | ==Criterio | + | |
+ | ==Criterio de Redacción== | ||
+ | Es importante no usar lenguaje coloquial y hablar en primera persona del plural "Nosotros" La idea es dejar de hablar del SIU y hablar de nosotros.<br /> | ||
+ | Ejemplo:<br /> | ||
+ | "El SIU desarrolla aplicaciones para..." '''INCORRECTO'''<br /> | ||
+ | "Desarrollamos aplicaciones para..." '''CORRECTO'''<br /> | ||
+ | |||
+ | Otro de los cambios importantes es cambiar la manera en la que nos referimos a los usuarios, intentar que el trato sea más ameno. Para evitar el voseo, que es muy propio de CABA también recomendamos escribir en plural.<br /> | ||
+ | Ejemplo: "Es importante que tengan en cuenta que antes de migrar la base de datos tendrán que hacer un back up de la información"<br /> | ||
+ | También es válido: "Una vez migrada la base es necesario actualizar la versión de apache y por último ejecutar..."<br /> | ||
+ | <br /> | ||
+ | |||
+ | |||
+ | ==Criterios 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. | 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 tablas=== | ||
===Sobre las imágenes=== | ===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:<br> | ||
+ | |||
+ | '''<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. <BR> | ||
+ | Ejemplo:<BR> | ||
+ | |||
+ | '''GUA_selector_de_alumnos.png''' y si se crea una segunda versión: '''GUA_selector_de_alumnos_v2.png''' <br> | ||
+ | |||
+ | 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.<br/> | ||
+ | Cuando se trate de imágenes institucionales del SIU, las mismas deben leerse directametne desde acá: http://www.siu.edu.ar/rd/ | ||
+ | |||
+ | === Sobre los documentos de Google Docs === | ||
+ | |||
+ | Para embeber un documento de Google Docs en una página de la wiki deben, en primer lugar, publicar el documento -> Archivo -> Publicar en la web -> Insertar - Contenido publicado y configuración - Iniciar publicación. | ||
+ | <br> | ||
+ | Ahí copian el código que les va a brindar Google, del cual solo se va a utilizar la parte de la URL que se encuentra entre comillas: | ||
+ | <br><br> | ||
+ | '''Ejemplo de código de Google''' <br> | ||
+ | <nowiki> | ||
+ | <iframe src="https://docs.google.com/document/d/1WI7YcUFIrPDS6phQcXlubYFAjGxkLOQXWo1AiZlc3mU/pub?embedded=true"></iframe> | ||
+ | </nowiki> | ||
+ | <br><br> | ||
+ | '''Ejemplo de código que utilizaríamos en la wiki''' <br> | ||
+ | <nowiki> | ||
+ | {{#iDisplay:https://docs.google.com/document/d/1WI7YcUFIrPDS6phQcXlubYFAjGxkLOQXWo1AiZlc3mU/pub?embedded=true|100%|1000}} | ||
+ | </nowiki> | ||
+ | <br><br> | ||
+ | El 100% corresponde al ancho del iframe (ocupará el 100% de la página) y el 1000 es la altura en píxeles. Ese último término debe ajustarse de acuerdo al largo del documento (es aproximadamente 800 por cada página de extensión). | ||
+ | |||
+ | === Sobre el código === | ||
+ | |||
+ | Para escribir código hay varias maneras: | ||
+ | <nowiki><source lang="php" enclose="div"> | ||
+ | </source></nowiki> | ||
+ | <br>Se ve así | ||
+ | <source lang="php" enclose="div"> | ||
+ | acá el código | ||
+ | </source> | ||
− | Si | + | otra manera, si te interesa destacar algo en el código: |
+ | |||
+ | <nowiki><syntaxhighlight lang="php" highlight="1-10"> | ||
+ | Donde en highlight="x-x" marcamos qué líneas queremos destacar | ||
+ | </syntaxhighlight> </nowiki> | ||
+ | <br> | ||
+ | Se ve así | ||
+ | <syntaxhighlight lang="php" highlight="1-10"> | ||
+ | Donde en highlight="x-x" marcamos qué líneas queremos destacar | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | Si querés escribir código y que mediawiki no lo interprete como tal tenés que usar las etiquetas | ||
+ | |||
+ | <nowiki><nowiki></nowiki></nowiki> | ||
+ | |||
+ | |||
+ | En caso de que el recuadro flotante se superponga con otro objeto (por ejemplo, la tabla de contenidos), la solución más simple es delimitar su ancho de la siguiente manera: | ||
+ | <pre><source lang="php" enclose="div" style="width: 450px;">Contenido</source></pre> | ||
+ | |||
+ | Se va a ver así: | ||
+ | <source lang="php" enclose="div" style="width: 450px;">Contenido</source> | ||
− | |||
=== Sobre los videos === | === 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: | 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: | ||
− | + | ||
− | < | + | <pre><youtube>ID del video</youtube></pre> |
+ | |||
+ | === 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: | ||
+ | |||
+ | <pre><!-- Contenido del comentario --></pre> | ||
+ | |||
+ | === 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: | ||
+ | |||
+ | <pre>__NOTOC__</pre> | ||
+ | |||
+ | === 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. | ||
+ | |||
+ | <pre><span style="float: right; margin: 0 0 15px 15px;">{{TOClimit|2}}</span></pre> | ||
+ | |||
+ | === 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 | ||
+ | <pre>{| 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 >]] | ||
+ | |}</pre> | ||
+ | |||
+ | COMO SE VE | ||
+ | http://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.11.0/Migracion/Desde_sistemas_externos/Migracion/Calendario_Academico | ||
+ | |||
+ | |||
+ | === Resaltar texto para novedades de versión === | ||
+ | |||
+ | Es posible resaltar un texto que indica un cambio respecto de la documentación de la versión anterior del módulo. Este texto adquirirá un formato determinado que se diferenciará del resto. La particularidad es que mediante este procedimiento, cuando se clona el contenido de la documentación para generar el contenido de la versión siguiente, se quita automáticamente el resaltado de los comentarios de la versión anterior. Es decir, si en la versión 3.10.3 por ejemplo había un paso resaltado, en la nueva versión ese paso no estará más resaltado porque se asume que ya no es nuevo. Para que ésto sea posible, el resaltado debe tener el siguiente formato: | ||
+ | <pre> | ||
+ | <span class='comentarios_nueva_version'>Contenido a resaltar</span><!-- comentarios_nueva_version --> | ||
+ | </pre> | ||
+ | Es importante que luego del tag de cierre se incluya el comentario correspondiente para que el script de migración logre identificar fácilmente el resaltado. | ||
+ | |||
+ | |||
+ | === Purgar caché de una página === | ||
+ | |||
+ | Para purgar caché de una página, basta con agregar <strong>?action=purge</strong> al final de la URL en cuestión. | ||
+ | |||
+ | [[Archivo:EjemploGanacias2016|Ganancias]] |
Revisión actual del 13:37 31 may 2024
Sumario
- 1 Criterio de Redacción
- 2 Criterios Generales
- 2.1 Sobre las url
- 2.2 Sobre las tablas
- 2.3 Sobre las imágenes
- 2.4 Sobre los documentos de Google Docs
- 2.5 Sobre el código
- 2.6 Sobre los videos
- 2.7 Comentarios en el código
- 2.8 Quitar la tabla de contenidos
- 2.9 Limitar niveles de la tabla de contenido
- 2.10 Links anterior y siguiente al pie
- 2.11 Resaltar texto para novedades de versión
- 2.12 Purgar caché de una página
Criterio de Redacción
Es importante no usar lenguaje coloquial y hablar en primera persona del plural "Nosotros" La idea es dejar de hablar del SIU y hablar de nosotros.
Ejemplo:
"El SIU desarrolla aplicaciones para..." INCORRECTO
"Desarrollamos aplicaciones para..." CORRECTO
Otro de los cambios importantes es cambiar la manera en la que nos referimos a los usuarios, intentar que el trato sea más ameno. Para evitar el voseo, que es muy propio de CABA también recomendamos escribir en plural.
Ejemplo: "Es importante que tengan en cuenta que antes de migrar la base de datos tendrán que hacer un back up de la información"
También es válido: "Una vez migrada la base es necesario actualizar la versión de apache y por último ejecutar..."
Criterios 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 los documentos de Google Docs
Para embeber un documento de Google Docs en una página de la wiki deben, en primer lugar, publicar el documento -> Archivo -> Publicar en la web -> Insertar - Contenido publicado y configuración - Iniciar publicación.
Ahí copian el código que les va a brindar Google, del cual solo se va a utilizar la parte de la URL que se encuentra entre comillas:
Ejemplo de código de Google
<iframe src="https://docs.google.com/document/d/1WI7YcUFIrPDS6phQcXlubYFAjGxkLOQXWo1AiZlc3mU/pub?embedded=true"></iframe>
Ejemplo de código que utilizaríamos en la wiki
{{#iDisplay:https://docs.google.com/document/d/1WI7YcUFIrPDS6phQcXlubYFAjGxkLOQXWo1AiZlc3mU/pub?embedded=true|100%|1000}}
El 100% corresponde al ancho del iframe (ocupará el 100% de la página) y el 1000 es la altura en píxeles. Ese último término debe ajustarse de acuerdo al largo del documento (es aproximadamente 800 por cada página de extensión).
Sobre el código
Para escribir código hay varias maneras:
<source lang="php" enclose="div">
</source>
Se ve así
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>
En caso de que el recuadro flotante se superponga con otro objeto (por ejemplo, la tabla de contenidos), la solución más simple es delimitar su ancho de la siguiente manera:
<source lang="php" enclose="div" style="width: 450px;">Contenido</source>
Se va a ver así:
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 >]] |}
Resaltar texto para novedades de versión
Es posible resaltar un texto que indica un cambio respecto de la documentación de la versión anterior del módulo. Este texto adquirirá un formato determinado que se diferenciará del resto. La particularidad es que mediante este procedimiento, cuando se clona el contenido de la documentación para generar el contenido de la versión siguiente, se quita automáticamente el resaltado de los comentarios de la versión anterior. Es decir, si en la versión 3.10.3 por ejemplo había un paso resaltado, en la nueva versión ese paso no estará más resaltado porque se asume que ya no es nuevo. Para que ésto sea posible, el resaltado debe tener el siguiente formato:
<span class='comentarios_nueva_version'>Contenido a resaltar</span><!-- comentarios_nueva_version -->
Es importante que luego del tag de cierre se incluya el comentario correspondiente para que el script de migración logre identificar fácilmente el resaltado.
Purgar caché de una página
Para purgar caché de una página, basta con agregar ?action=purge al final de la URL en cuestión.