Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Mensaje de error con pospell #1150

Open
eamanu opened this issue Nov 21, 2020 · 8 comments
Open

Mensaje de error con pospell #1150

eamanu opened this issue Nov 21, 2020 · 8 comments

Comments

@eamanu
Copy link
Contributor

@eamanu eamanu commented Nov 21, 2020

Buenas!
Estoy viendo que pospel en el build de #1144 da este mensaje que se reproduce localmente:

<rst-doc>:1: (ERROR/3) RFC number must be a number greater than or equal to 1; "RFC 2045 section 6.8 <2045#section-6.8>" is invalid. while parsing: Los datos codificados tendrán líneas nuevas cada 76 caracteres según :rfc:`RFC 2045 section 6.8 <2045#section-6.8>`, que era la especificación estándar de facto base64 cuando se escribió la especificación XML-RPC.

Esa línea se introdujo acá: ee86f03

@cmaureir
Copy link
Collaborator

@cmaureir cmaureir commented Nov 21, 2020

Pues realmente no puedo encontrar cual es el error

#: ../Doc/library/xmlrpc.client.rst:336                                                             
msgid ""                                                                                            
"The encoded data will have newlines every 76 characters as per :rfc:`RFC "                         
"2045 section 6.8 <2045#section-6.8>`, which was the de facto standard base64 "                        
"specification when the XML-RPC spec was written."                                                     
msgstr ""                                                                                              
"Los datos codificados tendrán líneas nuevas cada 76 caracteres según :rfc:"                           
"`RFC 2045 section 6.8 <2045#section-6.8>`, que era la especificación "                                                                                
"estándar de facto base64 cuando se escribió la especificación XML-RPC."
eamanu added a commit to eamanu/python-docs-es that referenced this issue Nov 21, 2020
Tal como se ve en python#1150
Por algún motivo pospell lanza un error en la línea de RFC.

Se marca ese PR como fuzzy para que pospell no lance el mensaje de
error.
@eamanu
Copy link
Contributor Author

@eamanu eamanu commented Nov 22, 2020

Por lo que pude investigar sería un problema en la documentación de Python rfc espera un número no una frase. debería ser algo así

:rfc:`2045`

Esto se repite en muy pocas partes de la documentación; http://paste.debian.net/1173766

cmaureir pushed a commit that referenced this issue Nov 23, 2020
Tal como se ve en #1150
Por algún motivo pospell lanza un error en la línea de RFC.

Se marca ese PR como fuzzy para que pospell no lance el mensaje de
error.
@mondeja
Copy link
Contributor

@mondeja mondeja commented Nov 23, 2020

He abierto un issue en Sphinx para que se acepten roles RFC con links apuntando a secciones de un RFC.

@mondeja
Copy link
Contributor

@mondeja mondeja commented Nov 24, 2020

Parece que es un error lanzado por pospell. Creo que lo mejor es esperar a #1061 para volver a probar.

@eamanu
Copy link
Contributor Author

@eamanu eamanu commented Nov 24, 2020

@mondeja con la nueva version de pospell no tenemos ese error?

@mondeja
Copy link
Contributor

@mondeja mondeja commented Nov 24, 2020

Pues seguimos teniéndolo. He estado investigando más a fondo y parece que es un bug con docutils, que no es capaz de interpretar roles RFC con textos largos. He abierto un issue en sourceforge, a ver si se soluciona.

@eamanu
Copy link
Contributor Author

@eamanu eamanu commented Nov 24, 2020

Para mi es la documentación de python la que aplica mal el :rfc:. Consulté pero todavía no tengo novedades.

@mondeja
Copy link
Contributor

@mondeja mondeja commented Nov 24, 2020

Definitivamente se produce en pospell, pero dentro del parsing con docutils. Puedes probar el siguiente ejemplo mínimo reproducible y verás el mensaje de error:

import docutils.parsers.rst
import docutils.frontend
from docutils.utils import new_document

components = (docutils.parsers.rst.Parser,)
parser = docutils.parsers.rst.Parser()
settings = docutils.frontend.OptionParser(
    components=components
).get_default_values()
document = new_document("<rst-doc>", settings=settings)

content = ("Los datos codificados tendrán líneas nuevas cada 76 caracteres según "
           ":rfc:`RFC 2045 section 6.8 <2045#section-6.8>`, que era la especificación "
           "estándar de facto base64 cuando se escribió la especificación XML-RPC.")
parser.parse(content, document)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
3 participants
You can’t perform that action at this time.