Podświetlaj polecenia Pythona jako komentarze (podświetlanie składni vima)

Question

Czy można zmodyfikować python.vim (i odpowiedni plik colorscheme), że potrójnie cytowane ciągi bezpośrednio pod instrukcjami klasy i def (aka docstrings) będą podświetlone jako komentarze podczas składni pythona podkreślając pod 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 

Answer 1

można dodać następującą linię:

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

do ~/.vim/after/syntax/python.vim. Możesz utworzyć ten plik, jeśli nie istnieje.

Answer 2

Następujące pracował dla mnie:

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 

Zrobione ze zmodyfikowanym python.vim z here.

Answer 3

PEP 257 nakazuje użycie "" "potrójnych podwójnych cytatów" "" dla docstrings. Nie jest obowiązkowe umieszczanie w documentach "pojedynczych podwójnych cudzysłowów". Jest jedna trudność, że mamy klasowe docstrukcje, funkcje docstrukcji, docstrukcje modułów, docstrukcje atrybutów i dodatkowe docstrukcje. Dlatego zdecydowałem, że łatwiej rozważyć docstring następująco:

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

A potem:

HiLink pythonDocString  Comment 

można zobaczyć przykłady w tym skrypcie (wyszukiwanie pythonDocString): https://github.com/andbar-ru/python-syntax/blob/master/syntax/python.vim