Los auxiliadores (helpers en inglés) se usan para ayudar a insertar elementos rápidamente. Los auxiliadores no se pueden usar en ficheros de código fuente.
/* Modifica la opción por defecto * puedes deshabilitar que la salida sea el enlace completo, * incluso cuando esté activada la opción `relative_link` y viceversa. */ <%- url_for('/css/style.css', {relative: false}) %> // /css/style.css
Retorna la URL de la imagen del gravatar a partir de un email.
Si no especificas el parámetro [options], las opciones por defecto se aplicarán. En otro caso, puedes establecerlo a un número que será transmitido como el parámetro de tamaño a Gravatar. Finalmente, si se establece como un objeto, se convertirá a una cadena de parámetros de consulta para Gravatar.
Carga de archivos CSS. path puede ser una cadena de texto, un array, un objeto o un array de objetos. El valor del directorio raíz /<root>/ es antepuesto mientras la extensión .css es añadido al final de path automáticamente. Se debe usar el tipo objeto para atributos personalizados.
Carga ficheros JavaScript. path puede ser una cadena de texto, un array, un objeto o un array de objetos. El valor del directorio raíz es incluido al inicio /<root>/ mientras que la extensión .js es añadida a path automáticamente. Se debe usar el tipo objeto para atributos personalizados.
/* Defaults to hexo-generator-feed's config if no argument */ <%- feed_tag() %> // <link rel="alternate" href="/atom.xml" title="Hexo" type="application/atom+xml">
Etiquetas condicionales
is_current
Comprueba si el path coincide con la URL de la página actual. Se deben usar las opciones strict para habilitar la coincidencia exacta.
<%- is_current(path, [strict]) %>
is_home
Comprueba si la página actual es la página de inicio.
<%- is_home() %>
is_home_first_page (+6.3.0)
Comprueba si la página actual es la primera o la página de inicio.
<%- is_home_first_page() %>
is_post
Comprueba si la página actual es un artículo (post).
<%- is_post() %>
is_page
Comprueba si la página actual es una página (page).
<%- is_page() %>
is_archive
Comprueba si la página actual es un histórico (archive page en inglés).
<%- is_archive() %>
is_year
Comprueba si la página actual es un histórico anual.
<%- is_year() %>
is_month
Comprueba si la página actual es un histórico mensual.
<%- is_month() %>
is_category
Comprueba si la página actual es una página de categoría. Si se indica una cadena de texto como parámetro, comprueba si la página actual coincide con la categoría dada.
<%- is_category() %> <%- is_category('hobby') %>
is_tag
Comprueba si la página actual es una página de etiqueta (clasificatoria). Si se indica una cadena de texto como parámetro, comprueba si la página actual coincide con la etiqueta dada.
<%- is_tag() %> <%- is_tag('hobby') %>
Manipulación de cadenas de textos
trim
Elimina los espacios de inicio y final de la cadena de texto.
<%- trim(string) %>
strip_html
Filtra todas las etiquetas HTML de una cadena de texto.
<%- strip_html(string) %>
Ejemplos:
<%- strip_html('It\'s not <b>important</b> anymore!') %> // It's not important anymore!
titlecase
Transforma una cadena de texto en un título adecuadamente capitalizado (con estilo inglés)
<%- titlecase(string) %>
Ejemplos:
<%- titlecase('this is an apple') %> # This is an Apple
markdown
Renderiza una cadena de texto con Markdown.
<%- markdown(str) %>
Ejemplos:
<%- markdown('make me **strong**') %> // make me <strong>strong</strong>
Inserta formateada una fecha. date puede ser unidad de tiempo unix, una cadena de texto ISO, un objeto date o un objeto Moment.js. format es el ajuste date_format por defecto.
<%- date(date, [format]) %>
Ejemplos:
<%- date(Date.now()) %> // 2013-01-01
<%- date(Date.now(), 'YYYY/M/D') %> // Jan 1 2013
date_xml
Inserta una fecha en formato XML. date puede ser unidad de tiempo unix, una cadena de texto ISO, un objeto date o un objeto Moment.js.
Inserta una hora con formato. date puede ser unidad de tiempo unix, una cadena de texto ISO, un objeto date o un objeto Moment.js. format es el ajuste time_format por defecto.
Inserta una fecha y hora con formato. date puede ser unidad de tiempo unix, una cadena de texto ISO, un objeto date o un objeto Moment.js. format es el ajuste date_format + time_format por defecto.
<%- full_date(date, [format]) %>
Ejemplos:
<%- full_date(newDate()) %> // Jan 1, 2013 0:00:00
<%- full_date(newDate(), 'dddd, MMMM Do YYYY, h:mm:ss a') %> // Tuesday, January 1st 2013, 12:00:00 am
relative_date
Inserta una marca de tiempo relativa desde el momento actual. date puede ser unidad de tiempo unix, una cadena de texto ISO, un objeto date o un objeto Moment.js.
<%- relative_date(date) %>
Ejemplos:
<%- relative_date(newDate()) %> // a few seconds ago
<%- relative_date(newDate(1000000000000)) %> // 22 years ago
time_tag
Inserta una etiqueta de tiempo. date puede ser unidad de tiempo unix, una cadena de texto ISO, un objeto date o un objeto Moment.js. format es el ajuste date_format por defecto.
Tipo de ordenación. 1, asc por orden ascendente; -1, desc por orden descendente
1
show_count
Muestra el número de artículos para cada categoría
true
style
Estilo para mostrar el listado de categorías. list muestra las categorías en una lista no numerada. Usa false o cualquier otro valor para deshabilitarlo.
list
separator
Separador entre categorías. (Solo funciona si style no es list)
,
depth
Niveles de categorías para ser mostradas. 0 muestra todas las categorías y las distintas subcategorías; -1 es parecido a 0, pero las muestra sin jerarquías; 1 muestra solo las categorías de nivel superior.
0
class
Nombre de clase de la lista de categorías.
category
transform
La función que cambia como se muestra el nombre de la categoría.
Inserta una lista de todas las etiquetas (clasificatorias).
<%- list_tags([options]) %>
Opción
Descripción
Valor por defecto
orderby
Orden de las etiquetas
name
order
Tipo de ordenación. 1, asc por orden ascendente; -1, desc por orden descendente
1
show_count
Muestra el número de artículos para cada etiqueta
true
style
Estilo para mostrar el listado de categorías. list muestra las categorías en una lista no numerada. Usa false o cualquier otro valor para deshabilitarlo.
list
separator
Separador entre categorías. (Solo funciona si style no es list)
,
class
Nombre de clase para el listado de etiquetas (cadena de texto) o personaliza cada clase de etiqueta (objeto, más detalles abajo).
tag
transform
La función que cambia como se muestra el nombre de la etiqueta. Consulta los ejemplos en list_categories.
Tipo. Este valor puede ser yearly (anualmente) o monthly (mensualmente).
monthly
order
Tipo de ordenación. 1, asc por orden ascendente; -1, desc por orden descendente
1
show_count
Muestra el número de artículos para cada histórico
true
format
Formato de fecha
MMMM YYYY
style
Estilo para mostrar el listado de históricos. list muestra los históricos en una lista no numerada. Usa false o cualquier otro valor para deshabilitarlo.
list
separator
Separador entre históricos. (Solo funciona si style no es list)
,
class
Nombre de clase del listado de históricos.
archive
transform
La función que cambia como se muestra el nombre de los históricos. Consulta los ejemplos en list_categories.
list_posts
Inserta un listado de artículos.
<%- list_posts([options]) %>
Opción
Descripción
Valor por defecto
orderby
Orden de los artículos
date
order
Tipo de ordenación. 1, asc por orden ascendente; -1, desc por orden descendente
1
style
Estilo para mostrar el listado de artículos. list muestra los artículos en una lista no numerada. Usa false o cualquier otro valor para deshabilitarlo.
list
separator
Separador entre artículos. (Solo funciona cuando style no es list)
,
class
Nombre de la clase del listado de artículos.
post
amount
Número de artículos a mostrar (0 = ilimitado)
6
transform
La función que cambia como se muestra el nombre de los artículos. Consulta los ejemplos en list_categories.
tagcloud
Inserta una nube de etiquetas clasificatorias.
<%- tagcloud([tags], [options]) %>
Opción
Descripción
Valor por defecto
min_font
Tamaño de fuente mínima
10
max_font
Tamaño de fuente máxima
20
unit
Unidad de tamaño de la fuente
px
amount
Número total de etiquetas
unlimited
orderby
Orden de las etiquetas
name
order
Tipo de ordenación. 1, asc por orden ascendente; -1, desc por orden descendente.
1
color
Colorea la nube de etiquetas
false
start_color
Color inicial. Se puede usar hex (#b700ff), rgba (rgba(183, 0, 255, 1)), hsla (hsla(283, 100%, 50%, 1)) o color keywords. Esta opción solo funciona cuando color es true.
end_color
Color final. Se puede usar hex (#b700ff), rgba (rgba(183, 0, 255, 1)), hsla (hsla(283, 100%, 50%, 1)) o color keywords. Esta opción solo funciona cuando color es true.
class
Prefijo del nombre de la clase de las etiquetas
level
Prefijo del nombre de la clase de las etiquetas. Esta opción solo funciona cuando se establece class.
10
show_count (+6.3.0)
Muestra el número de artículos para cada etiqueta
false
count_class (+6.3.0)
Nombre de clase del contador de etiquetas
count
Ejemplos:
// Default options <%- tagcloud() %>
// Limit number of tags to 30 <%- tagcloud({amount: 30}) %>
Miscelánea
paginator
Inserta un paginador.
<%- paginator(options) %>
Opción
Descripción
Valor por defecto
base
Base de la URL
/
format
Formato de la URL
page/%d/
total
El número de páginas
1
current
Número de página actual
0
prev_text
Texto del enlace a la página anterior. Funciona solo si prev_next es true.
Prev
next_text
Texto del enlace a la página posterior. Funciona solo si prev_next es true.
Next
space
Indicador de omisión (espacio)
&hellp;
prev_next
Muestra los enlaces a las páginas anterior y posterior
true
end_size
El número de páginas mostradas al inicio y al final de cada extremo
1
mid_size
El número de páginas mostradas a cada lado de la página actual, pero sin incluirla
2
show_all
Muestra todas las páginas. Si se establece como verdadero, end_size y mid_size no funcionarán
false
escape
Escapado de etiquetas HTML
true
page_class (+6.3.0)
Nombre de clase de página
page-number
current_class (+6.3.0)
Nombre de clase de página actual
current
space_class (+6.3.0)
Nombre de clase del indicador de omisión (space)
space
prev_class (+6.3.0)
Nombre de clase de página anterior
extend prev
next_class (+6.3.0)
Nombre de clase página posterior
extend next
force_prev_next (+6.3.0)
Fuerza mostrar los enlaces de página anterior y posterior