Add Articles

==Write a new article==

In order to be able to create a new article in the VoIP.ms wiki, please be sure to be logged in ([http://wiki.voip.ms/w/index.php?title=Special:UserLogin&returnto=Welcome login or create account])


'''Step 1:''' Search  article

* Please try searching for the article, some one may have already written a similar one.
** Go to the general search and write the title of your article then press the '''Go''' button as shown:


[[File:Searchtop2.png]]


* Si su artículo no se encuentra, la wiki le mostrará un resultado como el siguiente:


[[File:Createthepage.png]]


'''Step 2:''' Create article:

* Para crear el artículo, solo de clic en el título del artículo no encontrado (encerrado entre comillas) que arrojó el buscador
* Esta acción nos conducirá a la edición de su artículo
* Condiciones a tomar encuenta:
** Es importante que tenga cuidado con la combinación de mayúsculas y minúsculas, porque la frase que aparece como el resultado de ésta búsqueda, será el título de su artículo.
** El guion bajo "_", será convetido en espacio en blanco en los títulos de los artículos o en cualquier lugar de la wiki donde  se usen ligas a contenido o imágenes.

 <nowiki>
E.g:
Texto de búsqueda: PBX_Security
Título final al crear el  artículo: PBX Security
</nowiki>

'''Step 3:''' Redactar articulo

* Es muy importante que lea la sección "formateo de texto en la wiki" para estandarizar los contenidos mostrados.
	 

'''Step 4:''' Guardar Artículo

* Antes de guardar su artículo, recuerde muy bien el título de éste, ya que lo necesitará para ligarlo a la página que habla sobre el tema.
* Presione "Save Page", para guardar los cambios realizados.

==Guide for edit articles==

Para editar algún contenido en la wiki, asegúrese de estar logueado ([http://wiki.voip.ms/w/index.php?title=Special:UserLogin&returnto=Welcome login or create account])


'''Step 1:''' Search article

* Busque su artículo en el buscador general
* Si el artículo aparece en el listado de resultados, dele clic en el título de éste
* Ahora podrá ver el contenido del artículo


'''Step 2:''' Editar el artículo	

* Presione el botón superior de "Editar" para ver el contenido
* Haga los cambios pertinentes


'''Step 3:''' Guardar el artículo
	
* Presione "Save page"

==Wiki Tools==

* La siguiente imagen muestra las herramientas proporcionadas por la wiki, que le permitirán dar un formato estándar a su documento de texto.
Unicamente podrá usar las herramientas para editar un artículo si cuenta con una cuenta de usuario wiki ([http://wiki.voip.ms/w/index.php?title=Special:UserLogin&returnto=Welcome login or create account]).


'''Wiki Tools Bar:''' [[File:Wikitools.png]]


* A continuación explicamos el uso y efecto que tiene cada una de las herramientas:



[[File:Toolboldtext.png]] '''Bold Text Tool:'''


Utilice la herramienta Bold, para remarcar ciertas palabras que el usuario final deba de visualizar con mayor facilidad y darle un carácter de importancia. Seleccione el texto que desee y presione el botón "Bold text".

 <nowiki>
E.g:
Now click on '''Advanced''' button
</nowiki>

El código interno generado por el boton bold text, son 3 comillas simples (<nowiki>'''word'''</nowiki>) en cada lado del texto seleccionado, de ésta manera puede remarcar más palabras en forma manual utilizando simplemente ésta regla de estandarización en el texto del artículo. 

	
[[File:Toolitalictext.png]] '''Italic Text Tool:'''


Utilice la herramienta Italica para resaltar en forma elegane parte del contenido del texto. Seleccione el texto que desee y presione el botón "Italic text".

 <nowiki>
E.g:
Your softphone: ''should be ready to make calls''
</nowiki>
	
El código interno generado por el boton italic text, son 2 comillas simples (<nowiki>''word''</nowiki>) en cada lado del texto seleccionado, de ésta manera puede resaltar más palabras en forma manual utilizando simplemente ésta regla de estandarización en el texto del artículo.



[[File:Toolinternallink.png]] '''Internal Link Tool:'''


Utilice la herramienta Internal Link para enlazar un texto seleccionado a un artículo de la wiki. Seleccione el texto que desee y presione el botón "Internal link", es importante mencionar que el texto seleccionado debe coincidir con el título del artículo al que se quiere enlazar.

 <nowiki>
E.g:
1.- check our [[Softphones]] article (enlace simple) 
2.- check our [[Softphones|description here]] article (enlace con tool tip)
</nowiki>

El código interno generado por el boton Internal link, son corchetes cuadrados (<nowiki>[[word]]</nowiki>) en cada lado del texto seleccionado,
de ésta manera puede enlazar cualquier texto en forma manual utilizando ésta regla de estandarización en el texto del artículo.
	


[[File:Toolexternallink.png]] '''External Link Tool:'''


Utilice la herramienta External Link para enlazar un texto seleccionado a un artículo fuera de la wiki. Seleccione el texto que desee y presione el botón "External link", es importante mencionar que el texto seleccionado debe coincidir con el URL del artículo al que se quiere enlazar.

 <nowiki>
E.g: 
1.- check [http://wikipedia.com] (enlace externo simple)
2.- check [http://wikipedia.com|description] (enlace externo con tool tip)
</nowiki>

El código interno generado por el boton External link, son 2 corchetes cuadrados (<nowiki>[[http://word]]</nowiki>) en cada lado del texto seleccionado, de ésta manera puede enlazar cualquier texto en forma manual utilizando ésta regla de estandarización en el texto del artículo. Debe recordar agregar el prefijo http:// o https:// para referenciar enlaces externos.


[[File:Toollevelheadline.png]] '''Level 2 Headline Tool:'''


Utilice la herramienta Level 2 headline para escribir subtítulos ó que definan un tema a tratar. Seleccione el texto que desee y presione el botón "Level 2 headline".

 <nowiki>
E.g:
==Configuration Details==
</nowiki>

El código interno generado por el boton Level 2 headline, son 2 signos de igual (<nowiki>==subtitle==</nowiki>) en cada lado del texto seleccionado, de ésta manera puede convertir a subtítulo más palabras en forma manual utilizando simplemente ésta regla de estandarización en el texto del artículo.



[[File:Toolembeddedfile.png]] '''Embedded file Tool:'''


Utilice la herramienta Embedded file para enlazar un texto seleccionado a una imagen de la wiki. Seleccione el texto que desee y presione el botón "Embedded file", es importante mencionar que el texto seleccionado debe coincidir con el nombre del archivo al que se quiere enlazar.

 <nowiki>
E.g:
[[File:File.jpg]] to use the full version of the file
[[File:File.png|200px|thumb|left|alt text]] to use a 200 pixel wide rendition in a box in the left margin with 'alt text' as description
</nowiki>

El código interno generado por el boton embedded file, son 2 corchetes cuadrados (<nowiki>[[File:example.jpg]]</nowiki>) 
en cada lado del texto seleccionado, más la etiqueta "File:", de ésta manera puede enlazar cualquier texto a imagen en forma manual 
utilizando ésta regla de estandarización.
	  

* Para agregar una imagen, debe de cargarla previamente en la opción "Upload file" del menu izquierdo "Toolbox". Permitted file types: png, gif, jpg, jpeg.



[[File:Toolfilelink.png]] '''File Link Tool:'''


Utilice la herramienta File link para enlazar un texto seleccionado a un archivo de la wiki que no sea una imagen. Seleccione el texto que desee y presione el botón "File link", es importante mencionar que el texto seleccionado debe coincidir con el nombre del archivo al que se quiere enlazar.

 <nowiki>
E.g:
[[Media:File.ogg]] for directly linking to the file without displaying the file</nowiki>
 
El código interno generado por el boton File link, son 2 corchetes cuadrados (<nowiki>[[Media:example.ogg]]</nowiki>) en cada lado del texto seleccionado, más la etiqueta "Media:", de ésta manera puede enlazar cualquier texto a un archivo en forma manual utilizando ésta regla de estandarización.


	  
[[File:Toolmathematicalformula.png]] '''Mathematical formula (LaTeX) Tool:'''


Utilice la herramienta mathematical formula LaTeX, para escribir formular con un formato adecuado. Seleccione el texto que desee y presione el botón "Mathematical formula".

 <nowiki>
E.g:
<math>x=y/2</math>
</nowiki>

El código interno generado por el boton Mathematical formula, son 2 etiquetas (<nowiki><math>math expression</math></nowiki>) en cada lado del texto seleccionado, de ésta manera puede convertir el texto a formato de fórmula en forma manual, utilizando simplemente ésta regla de estandarización en el texto seleccionado.



[[File:Toolnowiki.png]] '''No Wiki Tool:'''


Utilice la herramienta No wiki, para ignorar cualquier tipo de formato de wiki sobre algún texto en específico. Seleccione el texto que desee y presione el botón "No wiki".

 <nowiki>
E.g:
&lt;nowiki&gt;texto sin formato wiki&lt;/nowiki&gt;
</nowiki>

El código interno generado por el boton no wiki, son 2 etiquetas (&lt;nowiki&gt;texto sin formato wiki&lt;/nowiki&gt;)
en cada lado del texto seleccionado, de ésta manera puede evitar el formato wiki en forma manual, utilizando simplemente ésta regla de estandarización en el texto seleccionado.


[[File:Toolhorizontalline.png]] '''Horizontal Line Tool:'''


Utilice la herramienta Horizontal line, para separar con una línea el contenido de un artículo de wiki. Seleccione algún lugar dentro del contenido del artículo y presione el botón "Horizontal line".

 <nowiki>
E.g:
----
</nowiki>


El código interno generado por el boton horizontal line, son 4 guiones medios (<nowiki>----</nowiki>) en cada lado del texto seleccionado, de ésta manera puede separar con una línea el texto de un artículo wiki en forma manual.



* Formateo Adicional
** Adicional a los formatos ya vistos, puede agregar antes de cada línea de texto escrita un asterisco (<nowiki>*</nowiki>), que le permitirá definir un punto al lado izquierdo. Este formato es comunmente usado para enlistar opciones o características de algún tema.
** También puede usar el doble asterisco (<nowiki>**</nowiki>), cuya interpretación en la wiki es muy parecida, unicamente deja una separación extra entre el margen izquierdo y el texto.


==Guide to upload files==

'''Step 1:''' Login on wiki

* Para tener permiso de subir imágenes, debe de loguearse en la wiki ([http://wiki.voip.ms/w/index.php?title=Special:UserLogin&returnto=Welcome login or create account])
	

'''Step 2:''' Subir imagen

* Vaya a la opción "Tool Box" del menú principal izquierdo, y de click sobre el vínculo "Upload file"
* Seleccione su archivo, dando click en el botón "Browse", tome en cuenta que los tipos de archivos permitidos son: png, gif, jpg, jpeg y el peso máximo por archivo es de 25MB
* Una vez hecho ésto, observará como en el campo "Destination filename:", aparece el nombre del archivo tal cual se podrá utilizar en la wiki. 
** Es muy importante que recuerde éste nombre de archivo, ya que lo utilizará al insertar la imagen en algún artículo posterior.
** Opcionalmente, puede agregar un breve sumario a la imagen si así lo requiere.


Nota: Si la imagen ya existe con el mismo nombre, le aparecerá un mensaje como el siguiente:


 <nowiki>
E.g.
"A file with this name exists already, please check File:example1.jpg if you are not sure if you want to change it."
</nowiki>

Además del previo de la imagen previamente guardada por usted o otro usuario. Si desea reemplazar la imagen solo es necesario guardar la imagen.


'''Step 3:''' Guardar la imagen

* De click en el botón "Upload file"
* Aparecerá el previo de su imagen en pantalla, indicando que el proceso de cargado finalizó correctamente