rawdog md

Rawdog-MD

Простой инструмент статического сайта на уровне пещерного человека, преобразованный из Markdown в HTML, с минимальной настройкой.

Вдохновленный motherfuckingwebsite.com, использует шаблон Go и HTML.

Функции

• Легко установить, настроить и быстро развернуть.
• Никаких раздутых зависимостей и кода фреймворка.
• Минимизация HTML, CSS, JS, SVG, JSON и XML
• Поддерживает подсветку синтаксиса БЕЗ JavaScript с помощью настраиваемого CSS.
• Поддерживает встраивание видео YouTube, Twitter и Bilibili прямо из коробки.
• Сервер живой перезагрузки для локальной разработки.
• Различные стартовые шаблоны, чтобы сразу приступить к работе

? Возможно, вы захотите использовать это, если:

• Вы хотите сосредоточиться на создании своего сайта, а не на изучении инструмента.
• Вы хотите создавать веб-сайты с использованием Markdown и специального HTML/CSS.
• Вы предпочитаете простую настройку без ненужных установок.

? Основные понятия

• Минимальная конфигурация : rawdog-md предназначен для использования с минимальной конфигурацией. Выберите стартовый шаблон и сразу же начните писать свои посты в уценке.
• Мнение : Этот инструмент не предназначен для использования в качестве генератора статических сайтов общего назначения. Он предназначен для использования в очень специфическом случае: статический сайт с несколькими простыми шаблонными страницами. Если вам нужно что-то более общее и более продвинутое, обратите внимание на Хьюго или Джекилла.
• Используйте свой собственный стиль : rawdog-md обеспечивает минимальный стиль. Однако его очень легко настроить, поскольку это всего лишь простой файл CSS и HTML.
• Кроссплатформенность : вы можете использовать его в Windows, Linux и MacOS.

Установка

rawdog-md доступен в Windows, Linux и MacOS. Вы можете установить его через менеджеры пакетов, вручную или собрать из исходного кода.

Окна

Установка через PowerShell (нажмите, чтобы развернуть)

1. Откройте PowerShell от имени администратора.
2. Запустите эту команду

   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
   iex (irm https://raw.githubusercontent.com/dwiandhikaap/rawdog-md/main/.installer/powershell/install.ps1)

3. Сделанный! Теперь вы можете использовать его как команду rawd в своем терминале.

Установить через Scoop

1. Установить Совок
2. Установите rawdog-md

   scoop install https://raw.githubusercontent.com/dwiandhikaap/rawdog-md/main/.installer/scoop/rawdog-md.json

3. Сделанный! Теперь вы можете использовать его как команду rawd в своем терминале.

Как удалить:

scoop uninstall rawdog-md

Установить вручную

1. Перейти на страницу последнего выпуска
2. Загрузите файл с именем rawd-{version}-windows-amd64.zip
3. Распакуйте zip-файл в любое удобное для вас место.
4. Добавьте извлеченную папку в свой PATH. Если вы не знаете как, посмотрите это руководство
5. Сделанный! Теперь вы можете использовать его как команду rawd в своем терминале.

Линукс

Установить через Bash (нажмите, чтобы развернуть)

1. Запустите эту команду в своем терминале

   curl -fsSL https://raw.githubusercontent.com/dwiandhikaap/rawdog-md/main/.installer/bash/install.sh | bash

2. Сделанный! Теперь вы можете использовать его как команду rawd в своем терминале.

Установить вручную

1. Перейти на страницу последнего выпуска
2. Скопируйте URL-адрес файла с именем rawd-{version}-linux-{architecture}.tar.gz
3. Запустите эту команду в своем терминале

   wget {copied-url} -O rawd.tar.gz
   tar -xvf rawd.tar.gz
   sudo mv rawd /usr/local/bin
   rm rawd.tar.gz

4. Сделанный! Теперь вы можете использовать его как команду rawd в своем терминале.

MacOS

Установить через Bash (нажмите, чтобы развернуть)

1. Запустите эту команду в своем терминале

   curl -fsSL https://raw.githubusercontent.com/dwiandhikaap/rawdog-md/main/.installer/bash/install.sh | bash

2. Сделанный! Теперь вы можете использовать его как команду rawd в своем терминале.

Установить вручную

1. Перейти на страницу последнего выпуска
2. Скопируйте URL-адрес файла с именем rawd-{version}-darwin-{architecture}.tar.gz
3. Запустите эту команду в своем терминале

   wget {copied-url} -O rawd.tar.gz
   tar -xvf rawd.tar.gz
   sudo mv rawd /usr/local/bin
   rm rawd.tar.gz

4. Сделанный! Теперь вы можете использовать его как команду rawd в своем терминале.

Сборка из исходного кода

Сборка с использованием Go (нажмите, чтобы развернуть)

1. Установить Го

2. Установите rawdog-md

   go install github.com/dwiandhikaap/rawdog-md

   При этом двоичный файл будет установлен как rawdog-md вместо rawd Если вы хотите изменить его на rawd , вы можете переименовать двоичный файл в каталоге Go bin.

   См. эту ссылку для получения дополнительной информации о go install .

3. Сделанный!

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

1. Создайте новый проект и выберите предустановленный шаблон.

   rawd init

   Он запросит у вас имя проекта и шаблон, который вы хотите использовать.

2. Затем перейдите в каталог проекта

    cd < your-project-name >

3. Запустите сервер разработки

   rawd watch

4. Откройте браузер и перейдите по адресу http://localhost:3000

5. Чтобы создать новое сообщение, создайте новый файл в каталоге pages . Вы можете использовать Markdown, Go Template или HTML.

6. Чтобы отредактировать шаблон, перейдите в каталог template .

7. Каждый раз, когда вы сохраняете изменения, сервер перестраивает сайт и обновляет браузер.

8. Когда вы закончите, создайте сайт

   rawd build

? Содействие

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