Manual:Short URL/es
Los URL acortados o las reescrituras de URL ocultan las extensiones de archivos php de la dirección de la página. Por favor, tómate unos minutos para diseñar una estructura de URL estable para tu sitio web antes de comenzar, para reducir problemas posteriores.
Introducción
Objetivo
La ruta de instalación por defecto de MediaWiki se ve así:
/var/www/html/mediawiki
(instalado como usuario root)/home/johndoe/public_html/mediawiki
(instalado con un proveedor de alojamiento compartido)
Las direcciones de las páginas predeterminadas de MediaWiki se parecen a estos ejemplos:
https://example.org/w/index.php/Page_title
(versiones recientes de MediaWiki, sin soporte de CGI)https://example.org/w/index.php?title=Page_title
(versiones recientes de MediaWiki, con soporte de CGI)
Usando los métodos descritos en esta página, podemos configurar algo como esto:
https://example.org/wiki/Page_title
Esta es la configuración más común, la misma que en Wikipedia, aunque no es la predeterminada porque requiere modificaciones del lado del servidorhttps://example.org/view/Page_title
https://wiki.example.org/view/Page_title
https://example.org/Page_title
https://wiki.example.org/Page_title
Algunas personas no recomiendan las dos últimas configuraciones. Véase Manual:Wiki in site root directory para encontrar posibles problemas y soluciones.
Ventajas y desventajas
- Ventaja: Los URL acortados ocultan algunos detalles técnicos a los usuarios finales, lo que puede ser deseable para los propietarios del sitio web. Entre otras cosas, esto significa que pueden permanecer estables aunque cambie el software subyacente. (Véase más arriba la diferencia entre la estructura predeterminada de URL de MediaWiki con CGI habilitado o no habilitado.) También son más fáciles de leer, recordar y manipular para los visitantes. Además, los URL acortados ofrecen una ventaja sobre los URL predeterminados para la w:es:optimización para motores de búsqueda, ya que los URL que contienen el carácter
?
pueden recibir un trato menos favorable por parte de los motores de búsqueda a la hora de calcular la clasificación de las páginas (page rank). - Desventaja: Requiere de una configuración, por lo que, dependiendo del entorno de alojamiento que estés utilizando, puede ser difícil de recrear. Sin embargo, como cualquier servidor web de uso generalizado es capaz de configurarse para utilizar URL acortados, la mayoría de los servicios de alojamiento web de pago deberían soportar esta funcionalidad. Cualquier proveedor que no te la ofrezca no merece tu dinero.
Guías
Nuestras guías oficiales para la configuración de URL acortados para diferentes servidores web. Elija la configuración de su servidor web de esta lista. Si no sabe qué software de servidor está utilizando, entonces lo más probable es que sea Apache.
Otras miniguías prácticas
Cualquiera es bienvenido a crear una página de soluciones y listarla a continuación. Procura utilizar un nombre sensato para la página, que encaje con el resto de nombres. Si cada solución única tiene su propia página, los lectores podrán saltarse la complejidad que no quieran. Mantenlo simple, legible, conciso, con una página separada por solución separada.
Para ayudar a los demás a averiguar qué métodos de URL acortados funcionan de verdad, después de haber probado cada método, edita la página e incrementa los contadores worked («funcionó») o didn't_work («no funcionó») de esa guía y añade una breve (o larga, tú decides) descripción de lo que falló haciendo clic en el enlace en tu número.
URL de la forma - ejemplo.com/wiki/Título_de_la_página
Acceso root
Estos métodos requieren que tengas acceso a la configuración del servidor. Si estás en un host compartido, lo más probable es que no. En este caso, tendrás que utilizar un método que no requiera acceso root. Puedes saltar directamente a la herramienta MediaWiki ShortURL Builder («Constructor de URL acortado») y seguir las instrucciones en pantalla. Selecciona I don't have root access («No tengo acceso root») después de introducir la URL de tu wiki.
- wiki/Título_de_la_página -- reescritura Lighttpd--acceso root
x4
- wiki/Título_de_la_página -- Reescritura Cherokee--acceso root
x1
- IIS8.5
x2
x1
- Abyss
(para la guía de Apache, revisa el enlace en la sección Guías).
URL de la forma - ejemplo.com/Título_de_la_página
Cómo crear URL de la forma ejemplo.com/Título_de_la_página
:
- Título_de_la_página - nginx, acceso root, PHP como módulo CGI
x6
- Título_de_la_página -- Windows y Apache sin 403 en páginas especiales
x3
URL de la forma - wiki.ejemplo.com/Título_de_la_página
Cómo crear URL de la forma wiki.ejemplo.com/Título_de_la_página
:
Solución de problemas
Problema del signo et (&)
El problema del signo et (o ampersand) se produce cuando tienes títulos de páginas que contienen símbolos (como &, ?, #, + y /) que, a pesar de estar correctamente codificados en el enlace, no se están pasando correctamente de mod_rewrite al script. Esto da lugar a errores 404 de página no encontrada, ya que el título se corta en el carácter especial. Por ejemplo, al hacer clic en un enlace a «John & Maria's page», se obtendría un 404 porque MediaWiki está buscando una página titulada «John ».
Esto se debe a que los signos et en los nombres en forma larga se tratan como separadores de cadenas de consulta, así que no llegarían al tiempo de ejecución de PHP. Esto está causado por un viejo y problemático error en mod_rewrite.[1]
Solución:
Este problema está causado por la parte ?title=$1
de reglas de escritura tales como /index.php?title=$1
, que es completamente innecesaria y perjudicial.
MediaWiki analiza las rutas directamente desde el REQUEST_URI
, así que reescríbelo todo a /index.php
.
Purgar la caché
Si observas que tus cambios a $wgArticlePath
en LocalSettings.php
no se reflejan en example.com/wiki/Main_Page
, puede ser debido al almacenamiento en caché de los enlaces de MediaWiki según la configuración anterior.
Vaya a example.com/wiki/Main_Page?action=purge
para forzar a MediaWiki a regenerar los enlaces almacenados en caché.
También puedes:
- Ejecutar la consulta de MySQL "
TRUNCATE objectcache;
", o - Asegurarte de que
$wgCacheEpoch
esté actualizado (si$wgInvalidateCacheOnLocalSettingsChange
está habilitado, todo lo que tienes que hacer es editar LocalSettings.php para purgarlo)
Redirigir al visitante de tu dominio a tu wiki
Nuestras guías oficiales para la configuración de URL acortados incluyen recomendaciones sobre cómo apuntar de la raíz de tu sitio a tu wiki usando tu configuración de URL acortado.
Por ejemplo, nuestra guía de Apache recomienda usar esto para apuntar a la raíz de tu sitio a tu wiki:
RewriteRule ^/*$ %{DOCUMENT_ROOT}/w/index.php [L]
Nótese que no recomendamos hacer una redirección HTTP a la ruta de tu wiki o a la página principal directamente. Al redirigir directamente a la página principal, partes de las variables de la configuración de la página de tu wiki se incorporarán a la configuración del servidor. Y redirigir a la ruta wiki, resultará en dos redirecciones. Simplemente reescribe la ruta raíz a MediaWiki y se encargará de la redirección 301 a la página principal.
Si estás utilizando VirtualHosts, ¡coloca las reglas de reescritura en la declaración del host virtual!
Mover una wiki de /wiki a /w
Un error común de los principiantes es instalar la propia MediaWiki (el código fuente, no el URL acortado) en /wiki
en lugar de /w
.
Una vez instalada se darían cuenta del error al tratar de configurar los URL acortados (lo cual se volvería difícil, ya que la ruta virtual entra en conflicto con la ruta real).
Hay un manual para mover una wiki en general, sin embargo, eso es demasiado complicado si todo lo que se necesita es cambiar el directorio de instalación (y permanecer en el mismo servidor, la misma base de datos y el mismo nombre de ordenador).
Esto es lo que tienes que hacer:
- Haz una copia de seguridad de
LocalSettings.php
y cualquier otro archivo de configuración que hayas creado (como tu.htaccess
). - Cambia el nombre del directorio de instalación de MediaWiki en su servidor de
/wiki
a/w
. - Establece
$wgScriptPath
enLocalSettings.php
como"/w"
y elimina (o comenta) cualquier definición de$wgArticlePath
(esta variable se modificará de nuevo al configurar los URL acortados, más adelante) - En este punto, tu wiki debería estar funcionando normalmente en
example.org/w
- Ahora sigue la guía habitual para configurar URL acortados.
- Realiza algunas pruebas en tu wiki para asegurarte de que no haya nada roto. Edita una página, visita algunas páginas diferentes, etc. Si algo parece anormal, revierte los cambios restaurando tu copia de seguridad de
LocalSettings.php
y otros archivos relevantes que puedas haber cambiado durante la configuración de URL acortados y renombra tu directorio de nuevo a/wiki
.
Nota para los usuarios con alojamiento compartido: muchos planes de alojamiento compartido ofrecen un administrador de aplicaciones para instalar, actualizar y realizar copias de seguridad automáticamente de aplicaciones como MediaWiki. Si tu plan tiene esto y deseas seguir usando estas funciones, debes comunicarte con su soporte técnico e informarles que acabas de cambiar manualmente tu directorio de instalación de MediaWiki.
Trucos
Véase también
- Explicación de qué son los módulos CGI
- $wgUsePathInfo - ajuste de configuración que define si se utilizan URLs 'bonitas' o no
- Notas sobre colocar la instalación de tu wiki en el directorio raíz del sitio
- $wgActionPaths - ajuste de configuración que puede usar para definir URLs 'bonitas' para otras acciones, como editar o historial
- Limpiar URLs RFC - propone "URLs más limpios para editar, previsualizar apariencias, etc."
Enlaces externos
- Módulo de Apache mod_rewrite - reescribe los URLs solicitados sobre la marcha
- MediaWiki Short URL Builder Tool - Una herramienta que puede generar automáticamente una configuración de URL acortado de manera más confiable que las configuraciones en estas páginas de manual.
- URL como UI de Jakob Nielsen sobre la importancia de los URLs persistentes y aprovechables.
Referencias
- ↑ mod_rewrite de Bugzilla para el error del signo et, parcialmente resuelto para algunos usuarios, pero sólo después de 13 años