Интеграция формы подписки на рассылку новостей в mkdocs

Question

Я знаю, что mkdocs должен быть статическим сайтом без сторонних интеграций / форм.

Мне нужно добавить форму подписки на новостную рассылку на странице, сгенерированной mkdocs.

Как я могу это сделать? Там, кажется, 0% информации об этом онлайн.

Answer 1

MkDocs использует Markdown, и Markdown может принимать необработанный HTML и передавать его без изменений. Поэтому включите HTML-форму на одной из ваших страниц Markdown. Возможно, что-то вроде этого:

Some Markdown text.

<form action="http://someothersite.com/" method="post">
    <P>
    <label for="name">Name: </label> <input type="text" id="name"><br>
    <label for="email">Email: </label> <input type="text" id="email"><br>
    <input type="submit" value="Send">
    </P>
</form>

More Markdown text.

Конечно, поскольку MkDocs является статическим сайтом, он не сможет обработать отправку формы. Поэтому форму необходимо будет отправить в какой-либо другой сервис и / или скрипт, отличный от MkDocs. Информацию о том, как отправить вашу форму в отдельную службу, смотрите в ответах на POSTing Form Cross Domain.