rstpad

RSTPAD

Редактор реструктурированного текста с живым предварительным просмотром.

Содержимое

• Функции
• Известные ограничения
• Детали реализации
• Компиляция
  • Предварительные условия
  • Построить конфигурацию
  • Развертывание Windows
  • OS X развертывание
  • Другие платформы

Функции

• ПРЕДВАРИТЕЛЬНЫЙ ПРЕДУПРЕЖДЕНИЕ С AUTOSCROLL
• настраиваемая ориентация (горизонтальная / вертикальная)
• Поиск и заменить
• Панель инструментов с общими элементами:
  • заголовки
  • Смелый, курсив
  • встроенный код
  • Кодовые блоки
  • горизонтальное правило
  • списки
  • связь
  • изображение
• Вставка выделенных кодовых блоков (пигменты)
  • Автозаполнение для известных имен Lexer
• Встроенные страницы помощи
  • Шпаргалка синтаксиса
  • Директивы
• Экспорт в PDF

Известные ограничения

• Только UTF-8 документы

Детали реализации

• Приложение содержит встроенный интерпретатор Python
  • Библиотеки Python расположены в каталоге / пакете приложения
• Библиотека Docutils используется для преобразования RST в HTML на лету
  • Отчет выполняется в отдельном потоке
  • Ресурсы/Предварительный просмотр/DOCUTILS_EXTENSIONS.PY Переопределяет некоторые методы писателя HTML для вставки дополнительных тегов и атрибутов
• Вывод HTML отображается с использованием QT Webengine
  • Внешние ссылки делегируются Qdesktopservices
  • AutoScroll реализован в JavaScript
  • Предварительный просмотр «заморожен» во время загрузки и автоматической прокрутки, чтобы обеспечить плавные переходы (ранее используется рамка для продолжительности)

Компиляция

Предварительные условия

• QT 5.8 & QT Creator
• Python 2.7 (32 -битный или 64 -битный в зависимости от используемого компилятора)
• Пигменты (протестированы с 2,1,3)
• Docutils (протестировано с 0,13, ревизия 7975)

Построить конфигурацию

Примечание

• Пути, используемые ниже (например, c:/python ), являются просто примерами. Используйте реальные пути :)
• Используйте прямые черты на всех путях. Опустить следы.
• Примечания и примеры OS X предполагают, что Python 2.7 был установлен с использованием Homebrew. Ваши пути могут варьироваться.

Скопируйте rstpad.local.pro.dist , назвать это rstpad.local.pro и установите следующие переменные:

• PYTHON_LINK
  • Флаги питона линкеров
  • Windows: -LC:/python/libs -lpython27
  • ОС X: Используйте утилиту Python-Config для определения флагов линкеров:
    • python2.7-config --ldflags
• PYTHON_INCLUDE_PATH
  • Путь к каталогу, содержащий файлы заголовков Python
    • Windows: C:/python/include
    • OS X: /usr/include/python2.7
• PYTHON_SYS_PATH
  • Путь к каталогу, содержащему:
    • libs.zip - Стандартная библиотека Python как архив Zip
    • pygments , docutils - библиотечные каталоги (они не могут быть внутри libs.zip )
    • Любые модули .pyd , .dll и .
  • .pyc -файлы должны быть исключены

Развертывание Windows

1. Используйте инструмент развертывания Windows с помощью BIRINAL для получения необходимых DLL.

   Пример: windeployqt.exe --release --no-translations rstpad.exe

2. Найдите и скопируйте правильный файл python27.dll , иначе приложение не будет работать на машинах без установки Python 2.7.

   • Возможные локации зависят от того, как вы установили Python и на его версии:
     • C: Windows System Python27.dll
     • C: Windows syswow64 python27.dll
   • Убедитесь, что вы используете правильную версию (32 против 64 бит)

OS X развертывание

Используйте инструмент развертывания Mac для преобразования полученного приложения в файл .dmg :

 macdeployqt rstpad.app -dmg

Другие платформы

Еще не тестируется. Ты сам по себе :)