В Python класс метод получает класс как неявный первый аргумент. Класс экземпляра объекта неявно передается как первый аргумент. Это может быть полезно, когда вы хотите, чтобы этот метод являлся фабрикой класса, поскольку он получает фактический класс (который называется методом) в качестве первого аргумента, можно создать экземпляр правого класса, даже если это также относится к подклассам.
Статический метод - это просто функция, определенная внутри класса. Он ничего не знает о классе или экземпляре, на который он был вызван, и получает только аргументы, которые были переданы без какого-либо неявного первого аргумента. Пример:
class Test(object):
def foo(self, a):
print "testing (%s,%s)"%(self,a)
@classmethod
def foo_classmethod(cls, a):
print "testing foo_classmethod(%s,%s)"%(cls,a)
@staticmethod
def foo_staticmethod(a):
print "testing foo_staticmethod(%s)"%a
test = Test()
staticmethods используются для группировки функций, которые имеют некоторое логическое соединение с классом в классе.
С
**-\\-region** <region_name>
он должен работать.
Это параметр конфигурации в Sphinx, который включен по умолчанию: параметр html_use_smartypants
( http://sphinx-doc.org/config.html?highlight=dash#confval-html_use_smartypants ).
Если вы отключите эту опцию, вам придется использовать символ Unicode '-', если вы хотите включить тире.
Чтобы добавить две тире, добавьте следующее:
.. include:: <isotech.txt>
|minus|\ |minus|\ region
Обратите внимание на обратную косую черту и пробел. Это позволяет избежать пробела между знаками минус и именем параметра.
Вам нужно включить только isotech.txt
один раз на страницу.
С помощью этого решения вы можете сохранить а также писать две тире в каждой части текста, который вам нужен. Не только в списках опций или литералах.
В Sphinx 1.6 html_use_smartypants
устарели , и уже нет необходимости устанавливать html_use_smartypants = False
в вашем conf.py
или в качестве аргумента sphinx-build
. Вместо этого вы должны использовать smart_quotes = False
.
Если вы хотите использовать преобразования, ранее предоставленные html_use_smartypants
, вместо этого рекомендуется использовать smart_quotes
, например, smart_quotes = True
.
Обратите внимание, что на момент написания этой статьи читайте контакты Docs sphinx==1.5.3
, которые не поддерживают параметр smart_quotes
. До тех пор вам нужно будет продолжать использовать html_use_smartypants
.