semvec/pypi-packages huggingface dataset:
vkr-build 0.1.2
Автоматизированное решение вёрстки курсовых/дипломных работ.
License: MIT
Requires Python: <4.0,>=3.12

# vkr-build

Автоматизированное решение вёрстки курсовых/дипломных работ в соответствие с ГОСТом на базе движка [WeasyPrint](https://weasyprint.org/). Позволяет сосредоточиться на содержании, а не на деталях оформления.

### Особенности 

- Markdown или HTML в качестве языка разметки;  
- Поддержка многофайловой структуры проекта;
- Простая кастомизация;
- Работает "из коробки" на большинстве платформ; 

### Примеры работ 

- [Комплексный пример со всеми возможностями](./examples/demo/) ([PDF](./examples/demo/output.pdf))
- [Реальный ВКР по юриспруденции](./examples/simple-full) ([PDF](./examples/simple-full/ВКР%20Влад.pdf)) 

### Поддержка 

Сквозной нумерации всех фигур (рисунков, таблиц), заголовков до третьего уровня, приложений. Генерация оглавления. 

Поддерживаемые элементы:
- [x] Заголовки 
- [x] Списки
- [x] Блоки кода
- Сноски
  - [x] inline html 
  - [ ] markdown сноски
- Фигуры
  - [x] Рисунки
  - [x] Таблицы
- [ ] Цитаты

## Установка 

#### Зависимости 

- Python 3.12+
- [pandoc](https://pandoc.org/)

```
pip install --upgrade vkr-build
```

Собранные пакеты можно также найти на [странице релизов](https://github.com/dx3mod/vkr.build/releases).


## Использование 

#### Конфигурационный файл

```toml
# document.toml

files = [
  # Последовательность файлов
]

# Путь до скомпилированного PDF-файла
output = 'output.pdf'

# Путь до пользовательских стилей
css = 'custom.css' 

# Префикс для названия глав
chapter_prefix = 'Глава '

# Заголовок для оглавления 
toc_title = 'Оглавление'
```

#### Переменные CSS

```css
:root {
  /* Начала подсчёта страниц, включая заголовок. */
  --start-page: 2;

  /* Расположение подзаголовков. */
  --subheader-align: center;

  /* https://developer.mozilla.org/en-US/docs/Web/CSS/list-style-type */

  /* Шрифт кода. */
  --font-mono: monospace;

   /* Режим переноса фигур (рис, таблиц). По-умолчанию, если они не помещаются
      на страницу, то переходят на новую. */
  --figure-break-inside: avoid;
}
```

#### Markdown

Сноски. 
```markdown
Приятно, граждане<footnote>Тут находится inline-сноска.</footnote>, наблюдать, 
как тщательные исследования конкурентов функционально разнесены на независимые элементы.
```

## Для разработчика 

To-Do

- По хорошему заменить pandoc на что-то нативное, но это сложно (нужен pandoc-like markdown конвертор) 
- Добавить больше стилей
aws-ops-alpha 0.2.1
A devops best practices for AWS projects. Designed for production-ready, multi-environments deployment projects
License: MIT
Requires Python: >=3.8


.. image:: https://readthedocs.org/projects/aws-ops-alpha/badge/?version=latest
    :target: https://aws-ops-alpha.readthedocs.io/en/latest/
    :alt: Documentation Status

.. image:: https://github.com/MacHu-GWU/aws_ops_alpha-project/actions/workflows/main.yml/badge.svg
    :target: https://github.com/MacHu-GWU/aws_ops_alpha-project/actions?query=workflow:CI

.. .. image:: https://codecov.io/gh/MacHu-GWU/aws_ops_alpha-project/branch/main/graph/badge.svg
    :target: https://codecov.io/gh/MacHu-GWU/aws_ops_alpha-project

.. image:: https://img.shields.io/pypi/v/aws-ops-alpha.svg
    :target: https://pypi.python.org/pypi/aws-ops-alpha

.. image:: https://img.shields.io/pypi/l/aws-ops-alpha.svg
    :target: https://pypi.python.org/pypi/aws-ops-alpha

.. image:: https://img.shields.io/pypi/pyversions/aws-ops-alpha.svg
    :target: https://pypi.python.org/pypi/aws-ops-alpha

.. image:: https://img.shields.io/badge/Release_History!--None.svg?style=social
    :target: https://github.com/MacHu-GWU/aws_ops_alpha-project/blob/main/release-history.rst

.. image:: https://img.shields.io/badge/STAR_Me_on_GitHub!--None.svg?style=social
    :target: https://github.com/MacHu-GWU/aws_ops_alpha-project

------

.. .. image:: https://img.shields.io/badge/Link-Document-blue.svg
    :target: https://aws-ops-alpha.readthedocs.io/en/latest/

.. .. image:: https://img.shields.io/badge/Link-API-blue.svg
    :target: https://aws-ops-alpha.readthedocs.io/en/latest/py-modindex.html

.. image:: https://img.shields.io/badge/Link-Install-blue.svg
    :target: `install`_

.. image:: https://img.shields.io/badge/Link-GitHub-blue.svg
    :target: https://github.com/MacHu-GWU/aws_ops_alpha-project

.. image:: https://img.shields.io/badge/Link-Submit_Issue-blue.svg
    :target: https://github.com/MacHu-GWU/aws_ops_alpha-project/issues

.. image:: https://img.shields.io/badge/Link-Request_Feature-blue.svg
    :target: https://github.com/MacHu-GWU/aws_ops_alpha-project/issues

.. image:: https://img.shields.io/badge/Link-Download-blue.svg
    :target: https://pypi.org/pypi/aws-ops-alpha#files


Welcome to ``aws_ops_alpha`` Documentation
==============================================================================
.. image:: https://aws-ops-alpha.readthedocs.io/en/latest/_static/aws_ops_alpha-logo.png
    :target: https://aws-ops-alpha.readthedocs.io/en/latest/

A devops best practices for AWS projects. Designed for production-ready, multi-environments deployment projects.


.. _install:

Install
------------------------------------------------------------------------------

``aws_ops_alpha`` is released on PyPI, so all you need is to:

.. code-block:: console

    $ pip install aws-ops-alpha

To upgrade to latest version:

.. code-block:: console

    $ pip install --upgrade aws-ops-alpha