Как остановить Sphinx от испускания символов Unicode в man-страницах? [Дубликат]

В 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 используются для группировки функций, которые имеют некоторое логическое соединение с классом в классе.

7
задан Tshepang 8 March 2013 в 11:09
поделиться

4 ответа

С

**-\\-region**  <region_name>

он должен работать.

1
ответ дан jfbu 28 August 2018 в 18:13
поделиться

Это параметр конфигурации в Sphinx, который включен по умолчанию: параметр html_use_smartypants ( http://sphinx-doc.org/config.html?highlight=dash#confval-html_use_smartypants ).

Если вы отключите эту опцию, вам придется использовать символ Unicode '-', если вы хотите включить тире.

3
ответ дан Joseph 28 August 2018 в 18:13
поделиться

Чтобы добавить две тире, добавьте следующее:

.. include:: <isotech.txt>

|minus|\ |minus|\ region

Обратите внимание на обратную косую черту и пробел. Это позволяет избежать пробела между знаками минус и именем параметра.

Вам нужно включить только isotech.txt один раз на страницу.

С помощью этого решения вы можете сохранить а также писать две тире в каждой части текста, который вам нужен. Не только в списках опций или литералах.

0
ответ дан Montecarlo 28 August 2018 в 18:13
поделиться

В 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.

0
ответ дан Steve Piercy 28 August 2018 в 18:13
поделиться
Другие вопросы по тегам:

Похожие вопросы: