Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Add `hexdoc_format` filter to wrap a literal string in FormatTree

Abierto Apto para principiantes
  • ¿Algo no está bien?
#90 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
72/100
Tipo de issue
Nueva funcionalidad
Claridad
Bien especificado
Estado de actividad
Estancado
Stack tecnológico
python
Área
documentation

Línea de trabajo

Busca en el código dónde se definen los filtros de Jinja, probablemente en un módulo de plantillas. Encuentra la clase FormatTree para entender su constructor. Implementa el filtro hexdoc_format para envolver la cadena de entrada en una instancia de FormatTree, siguiendo el patrón de los filtros existentes. Ejecuta la suite de pruebas del proyecto para verificar el cambio.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

enhancement

Example use case:

bookofhexxy.welcome.content: "The $(l:{hex_book_url})Hex Casting book/$ can be viewed here, with content from several $(l:https://pypi.org/project/hexdoc/)hexdoc/$-compatible addons."

{# current workaround (produces a warning message) #}
{{ fmt.styled(_f(
  _("bookofhexxy.welcome.content").format(hex_book_url=hex_book_url)
)) }}

{# with this feature #}
{{ fmt.styled(hexdoc_format(
  _("bookofhexxy.welcome.content").format(hex_book_url=hex_book_url)
)) }}
Lenguaje dominante
Python
Estrellas
7
Forks
10
Sin PR fusionados en 30 d

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de hexdoc-dev/hexdoc

Todos los issues de hexdoc-dev/hexdoc

Issues similares

Más issues de Python

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.