vim python-2.7 vim-syntax-highlighting

vim python mode



Resalte las cadenas de documentación de Python como comentarios(resaltado de sintaxis VIM) (3)

¿Es posible modificar python.vim (y el archivo de esquema de colores correspondiente) de manera que las cadenas con comillas triples justo debajo de las declaraciones de clase y definición (también conocidas como cadenas de documentación) se resaltarán como comentarios durante el resaltado de sintaxis de python bajo vim?

class URLopener: """Class to open URLs. This is a class rather than just a subroutine because we may need more than one set of global protocol-specific options. Note -- this is a base class for those who don''t want the automatic handling of errors type 302 (relocated) and 401 (authorization needed).""" def addheader(self, *args): """Add a header to be used by the HTTP interface only e.g. u.addheader(''Accept'', ''sound/basic'')""" # sample comment


Lo siguiente me funcionó:

syn region pythonDocstring start=+^/s*[uU]/?[rR]/?"""+ end=+"""+ keepend excludenl contains=pythonEscape,@Spell,pythonDoctest,pythonDocTest2,pythonSpaceError syn region pythonDocstring start=+^/s*[uU]/?[rR]/?''''''+ end=+''''''+ keepend excludenl contains=pythonEscape,@Spell,pythonDoctest,pythonDocTest2,pythonSpaceError

Tomado de un python.vim modificado desde here .


PEP 257 prescribe el uso de "" "comillas dobles" "" para las cadenas de documentación. No es obligatorio incluir "comillas simples triples" o "comillas dobles simples" en las cadenas de documentación. Hay una dificultad que tenemos las cadenas de documentación de la clase, las cadenas de documentación de la función, las cadenas de documentación del módulo, las cadenas de documentación de atributos y las cadenas de documentación adicionales. Por eso decidí que es más fácil considerar la cadena de documentación de la siguiente manera:

syn region pythonDocString start=+^/s*"""+ end=+"""+ keepend contains=...

Y entonces:

HiLink pythonDocString Comment

Puede ver ejemplos en este script (busque pythonDocString): https://github.com/andbar-ru/python-syntax/blob/master/syntax/python.vim


Puedes añadir la siguiente línea:

syn region Comment start=/"""/ end=/"""/

a su ~ / .vim / after / syntax / python.vim. Puedes crear este archivo si no existe.