как преобразовать текстовый документ в файл html через цепочку pando c -> sphinx и сохранить вкладки примеров кода документа - PullRequest
0 голосов
/ 26 мая 2020

Я хотел бы создать HTML сайт из текстового документа о python программировании. Я использую документ цепочки слов -> [pandoc] -> первый файл -> [sphinx] -> html site. Все работает нормально, за исключением примеров кода python: все вкладки потеряны, а все строки кода выровнены по левому краю, что делает код неразборчивым.

Что я могу сделать, чтобы решить эту проблему? Я бы предпочел действовать с исходным текстовым документом, чем с промежуточным файлом реструктурированного текста.

Как воспроизвести проблему (требуется знание word, pando c, sphinx, реструктурированный текст):

a ) создать текстовый документ [example.docx] с программой python в нем. Python код требует вкладок. Например:

Python code example :

# ----------------------------------
def affiche(chaine):
    # affiche chaine
    print("chaine=%s" % chaine)


# ----------------------------------
def afficheType(variable):
    # affiche le type de variable
    print("type[%s]=%s" % (variable, type(variable)))


# ----------------------------------
def f1(param):
    # ajoute 10 à param
    return param + 10


# ----------------------------------
def f2():
    # rend 3 valeurs
    return "un", 0, 100


# -------------------------------- programme principal ------------------------------------
# ceci est un commentaire
# variable utilisée sans avoir été déclarée
nom = "dupont"

# un affichage écran
print("nom=%s" % nom)

# une liste avec des éléments de type différent
liste = ["un", "deux", 3, 4]

b) с помощью консоли введите следующую команду

pando c -f docx -t rst -i example.docx - t example.rst

c) введите следующие команды:

sphinx-quickstart

make html

d) полученный html выглядит так:

html produced from the word document

Мы видим, что все строки функции affiche выровнены по левому краю. Это неверно для кода python;

1 Ответ

2 голосов
/ 27 мая 2020

Для тех, кто заинтересован, я нашел решение: я дал коду стиль слова [Исходный код], и теперь html выглядит так:

enter image description here

...