Программа предназначена для того, чтобы авторы могли скачать свои данные с сайта «Блог-сайд».

Программа создаёт папки на основе классификации случайных записей сайта и скачивает соответствующие черновики. Формат статей — md. Программа поддерживает офлайн-статьи, включая изображения в них.

На сайте «Блог-сайд» есть функция резервного копирования, но скачанный файл представляет собой xml, который трудно читать и разделять на статьи.

Содержание

1. Использование.
   • Конфигурация.
   • Зависимости.
   • Запуск.
   • Функции.
2. Для разработчиков.
   • Документация.

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

Конфигурация

Перед запуском программы необходимо настроить config.ini:

• Переименуйте файл config.ini.example в config.ini.
• Войдите в браузер и отметьте «Запомнить меня».
• После входа в браузере нажмите F12, найдите Cookie и скопируйте значение .Cnblogs.AspNetCore.Cookies в файл config.ini.
• Заполните остальные поля по мере необходимости. Сохраните файл в кодировке UTF-8.

После включения автономного режима ссылки на изображения в случайных записях будут автоматически заменены на локальные ссылки.

Зависимости

pip install httpx

Запуск

После настройки программы и установки зависимости запустите её из командной строки:

python main.py

Вы увидите вывод:

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

Функции

Скачанные файлы называются заголовками случайных записей, а специальные символы /:*?"<>| заменяются пробелами. Файлы кодируются в формате UTF-8.

Программа различает, является ли случайная запись публичной, черновой или нет, и добавляет [непубличный] или [черновик] к имени файла.

Программа работает только в Windows и не адаптирована для других систем.

Если вы удалите статью на сайте «Блог-сайт», программа не удалит соответствующую локальную статью.

В файле .CnblogsDownloaderFlag.json хранится время последнего запуска программы. Если статьи на сайте не обновлялись, программа не будет повторно загружать их.

Как только программа решит загрузить случайную запись, она перезапишет эту запись и все связанные с ней изображения.

Изображения в кодовых блоках также загружаются, если они имеют действительные ссылки, например:

Это черновик.
```
<img src="https://github.com/Charles94jp/cnblogs-blogger-downloader/blob/master/img/logo.png?raw=true">
```
Тогда изображение в этом блоке кода также будет загружено.

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

Открытая документация API сайта «Блог-сайт»: https://api.cnblogs.com/help.

Однако этого недостаточно, и вам нужно подать заявку на разрешение API. Поэтому я составил несколько важных документов API на основе сетевого общения: cnblogs-apiDoc / lib/cnblogs_api.py.

Структура проекта

.
├── docs                                   Документация проекта, GitHub Pages
├── img                                    Изображение readme
├── lib                      
│    ├── cnblogs-apiDoc.md                     Документация интерфейса блога
│    └── cnblogs_api.py                        Библиотека HTTP-интерфейсов блога
├── sphinx                                  Создание документации проекта
│     ├── source
│     │     ├── _static
│     │     ├── _templates
│     │     ├── lib
│     │     ├── cnblogs_downloader.rst
│     │     ├── conf.py                            Конфигурация sphinx
│     │     ├── favicon.ico
│     │     ├── index.rst
│     │     └── main.rst
│     ├── Makefile
│     └── make.bat
├── LICENSE                                 Лицензия проекта
├── cnblogs_downloader.py                    Основная логика программы
├── config.ini.example                       Файл конфигурации примера
├── main.py                                  Точка входа программы
└── readme.md                                Файл самоописания

Документация

Документация проекта: https://charles94jp.github.io/cnblogs-blogger-downloade.

Обратите внимание, что docs/lib/cnblogs-apiDoc.html typora.css и docs/.nojekyll были добавлены вручную.

Лицензия

Открытый исходный код проекта лицензирован под GPL-3.0 License / LICENSE.