rawdog md

rawdog-md

Einfache, statische Markdown-zu-HTML-Site-Tools auf Caveman-Niveau mit minimaler Konfiguration.

Inspiriert von motherfuckingwebsite.com, verwendet Go Template und HTML unter der Haube.

Merkmale

• Einfach einzurichten, anzupassen und schnell bereitzustellen.
• Keine aufgeblähten Abhängigkeiten/Framework-Code.
• Minimierung für HTML, CSS, JS, SVG, JSON und XML
• Unterstützt Syntaxhervorhebung OHNE JavaScript mit anpassbarem CSS.
• Unterstützt das standardmäßige Einbetten von YouTube-, Twitter- und Bilibili-Videos.
• Live-Reload-Server für lokale Entwicklung.
• Verschiedene Starter-Vorlagen für den sofortigen Einstieg

? Möglicherweise möchten Sie dies verwenden, wenn:

• Sie möchten sich auf die Erstellung Ihrer Website konzentrieren, anstatt sich mit dem Tool vertraut zu machen.
• Sie möchten Websites mit Markdown und benutzerdefiniertem HTML/CSS erstellen.
• Sie bevorzugen eine einfache Einrichtung ohne unnötige Installationen.

? Kernkonzepte

• Minimale Konfiguration : rawdog-md ist für die Verwendung mit minimaler Konfiguration konzipiert. Wählen Sie eine Startervorlage und beginnen Sie sofort mit dem Schreiben Ihrer Beiträge im Markdown.
• Meinung : Dieses Tool ist nicht als allgemeiner statischer Site-Generator gedacht. Es soll für einen ganz bestimmten Anwendungsfall verwendet werden, nämlich eine statische Site mit einigen einfachen Seitenvorlagen. Wenn Sie etwas Allzweckigeres und Fortgeschritteneres suchen, schauen Sie sich Hugo oder Jekyll an.
• Bringen Sie Ihr eigenes Styling mit : rawdog-md sorgt für das minimale Styling. Die Anpassung ist jedoch sehr einfach, da es sich lediglich um eine einfache CSS- und HTML-Datei handelt.
• Plattformübergreifend : Sie können es unter Windows, Linux und MacOS verwenden.

Installation

rawdog-md ist für Windows, Linux und MacOS verfügbar. Sie können es über Paketmanager oder manuell installieren oder aus dem Quellcode erstellen.

Windows

Installation über PowerShell (zum Vergrößern anklicken)

1. Öffnen Sie PowerShell als Administrator
2. Führen Sie diesen Befehl aus

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

3. Erledigt! Sie können es jetzt als rawd -Befehl in Ihrem Terminal verwenden.

Über Scoop installieren

1. Scoop installieren
2. Installieren Sie rawdog-md

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

3. Erledigt! Sie können es jetzt als rawd -Befehl in Ihrem Terminal verwenden.

So deinstallieren Sie:

scoop uninstall rawdog-md

Manuell installieren

1. Gehen Sie zur Seite mit der neuesten Version
2. Laden Sie die Datei mit dem Dateinamen rawd-{version}-windows-amd64.zip herunter
3. Extrahieren Sie die ZIP-Datei an einem beliebigen Ort
4. Fügen Sie den extrahierten Ordner zu Ihrem PATH hinzu. Wenn Sie nicht wissen wie, schauen Sie sich diese Anleitung an
5. Erledigt! Sie können es jetzt als rawd -Befehl in Ihrem Terminal verwenden.

Linux

Über Bash installieren (zum Vergrößern anklicken)

1. Führen Sie diesen Befehl in Ihrem Terminal aus

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

2. Erledigt! Sie können es jetzt als rawd -Befehl in Ihrem Terminal verwenden.

Manuell installieren

1. Gehen Sie zur Seite mit der neuesten Version
2. Kopieren Sie die URL der Datei mit dem Dateinamen rawd-{version}-linux-{architecture}.tar.gz
3. Führen Sie diesen Befehl in Ihrem Terminal aus

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

4. Erledigt! Sie können es jetzt als rawd -Befehl in Ihrem Terminal verwenden.

MacOS

Über Bash installieren (zum Vergrößern anklicken)

1. Führen Sie diesen Befehl in Ihrem Terminal aus

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

2. Erledigt! Sie können es jetzt als rawd -Befehl in Ihrem Terminal verwenden.

Manuell installieren

1. Gehen Sie zur Seite mit der neuesten Version
2. Kopieren Sie die URL der Datei mit dem Dateinamen rawd-{version}-darwin-{architecture}.tar.gz
3. Führen Sie diesen Befehl in Ihrem Terminal aus

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

4. Erledigt! Sie können es jetzt als rawd -Befehl in Ihrem Terminal verwenden.

Aus dem Quellcode erstellen

Mit Go erstellen (Zum Vergrößern anklicken)

1. Installieren Sie Go

2. Installieren Sie rawdog-md

   go install github.com/dwiandhikaap/rawdog-md

   Dadurch wird die Binärdatei als rawdog-md anstelle von rawd installiert. Wenn Sie sie in rawd ändern möchten, können Sie die Binärdatei in Ihrem Go-bin-Verzeichnis umbenennen.

   Weitere Informationen zu go install finden Sie in dieser Referenz.

3. Erledigt!

Verwendung

1. Erstellen Sie ein neues Projekt und wählen Sie eine voreingestellte Vorlage

   rawd init

   Sie werden nach dem Projektnamen und der Vorlage gefragt, die Sie verwenden möchten.

2. Gehen Sie dann in das Projektverzeichnis

    cd < your-project-name >

3. Starten Sie den Entwicklungsserver

   rawd watch

4. Öffnen Sie Ihren Browser und gehen Sie zu http://localhost:3000

5. Um einen neuen Beitrag zu erstellen, erstellen Sie eine neue Datei im pages . Sie können Markdown, Go Template oder HTML verwenden.

6. Um die Vorlage zu bearbeiten, wechseln Sie in das template .

7. Jedes Mal, wenn Sie Ihre Änderungen speichern, erstellt der Server die Site neu und aktualisiert den Browser.

8. Wenn Sie fertig sind, erstellen Sie die Site

   rawd build

? Mitwirken

Pull-Anfragen sind willkommen. Bei größeren Änderungen öffnen Sie bitte zunächst ein Problem, um zu besprechen, was Sie ändern möchten.