Введение

Typora QCloud Cos — это плагин для Typora, разработанный на Python. Он позволяет автоматически загружать изображения из Typora в облачное хранилище Tencent.

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

• Поддержка загрузки локальных и сетевых изображений (путём копирования и вставки в Typora).
• Распознавание формата изображения по его байтовому потоку.
• Использование MD5 для предотвращения повторной загрузки одного и того же изображения.
• Простота настройки: всего 3 шага.
• Компактность: размер плагина составляет всего 21 КБ.
• Открытость исходного кода: предоставляется UML-диаграмма классов, что упрощает понимание кода для тех, кто знаком с Python.

Зачем это нужно?

Загрузка изображений из Typora на Tencent Cloud Object Storage (COS) и получение их внешних ссылок позволяют отделить хранение Markdown-текста от хранения изображений, обеспечивая возможность просмотра Markdown в любом месте и корректное отображение изображений.

Typora (https://www.typora.io/)

Цены на Tencent Cloud Object Storage (https://cloud.tencent.com/product/cos/pricing)

Как использовать?

Видеоинструкции:

• bilibili (https://www.bilibili.com/video/BV14k4y117Wd/);
• youtube (https://www.youtube.com/watch?v=iODN7TYASiY&ab_channel=ziboliao).

Шаг 1. Установка Python и плагина:

1. Скачайте и установите Python, убедившись, что вы отметили опцию «Add Python to PATH» во время установки.
2. Установите плагин typora_cos:

# Использование зеркала Али ПайПай
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

# Установка typora_cos
pip install -U typora_cos

Шаг 2. Создание конфигурационного файла и его настройка:

1. Выполните команду для создания конфигурационного файла, затем откройте его в текстовом редакторе:

python -m typora_cos.qcloud --init

# Создан конфигурационный файл, продолжайте настройку: C:\Users\liaoz\.typora_cos\config.xml

2. Получите значения SecretId и SecretKey на странице https://console.cloud.tencent.com/cam/capi.
3. Создайте хранилище COS и получите имя хранилища bucket и регион region на странице https://console.cloud.tencent.com/cos5/bucket.
4. При создании хранилища выберите опцию «Публичное чтение, частное письмо».

Шаг 3 (необязательно). Тестирование в командной строке:

Выполните следующие команды для проверки работы плагина:

python -m typora_cos.qcloud https://www.python.org/static/img/python-logo.png

# Успешно загружено:
# https://test-1253318070.cos.ap-nanjing.myqcloud.com/7cbb8b7f3ec73ce6716fedaa4d63f6ce.png

python -m typora_cos.qcloud C:\Users\liaoz\Pictures\mc.jpg

# Успешно загружено:
# https://test-1253318070.cos.ap-nanjing.myqcloud.com/739d7e571980d16ad192ff72e4f2d5d9.jpeg

Шаг 4 (последний шаг). Настройка в Typora:

В Typora перейдите в меню «Файл», затем «Настройки», «Пользовательские команды» и добавьте команду python -m typora_cos.qcloud.

Известные проблемы:

• URL сетевых изображений не должен содержать параметры запроса (& символ).

Дизайн

Если вас интересует исходный код, посетите репозитории проекта:

• https://gitee.com/liaozb1996/typroa_qcloud_cos;
• https://github.com/liaozb1996/typora-qcloud-cos.

Процесс работы:

1. Введите один или несколько путей.
2. Преобразуйте пути в байтовые потоки.
3. Абстрагируйте байтовые потоки в объекты файлов хранилища.
4. Выполните операцию загрузки и верните URL.

Используемые шаблоны проектирования: стратегия + простой фабричный метод, фасад, простой фабричный метод.

Другие аспекты: конфигурация и код разделены.