rawdog-md
Outils de site statique Markdown vers HTML simples de niveau Caveman avec une configuration minimale.
Inspiré de motherfuckingwebsite.com, utilise Go Template et HTML sous le capot.
Caractéristiques
- Facile à installer, à personnaliser et à déployer rapidement.
- Pas de dépendances/code framework gonflés.
- Minification pour HTML, CSS, JS, SVG, JSON et XML
- Prend en charge la coloration syntaxique SANS JavaScript avec CSS personnalisable.
- Prend en charge l'intégration de vidéos YouTube, Twitter et Bilibili prêtes à l'emploi.
- Serveur de rechargement en direct pour le développement local.
- Divers modèles de démarrage pour démarrer immédiatement
? Vous voudrez peut-être l'utiliser si :
- Vous souhaitez vous concentrer sur la création de votre site au lieu d’apprendre l’outil.
- Vous souhaitez créer des sites Web avec Markdown et HTML/CSS personnalisés.
- Vous préférez une configuration simple sans installations inutiles.
? Concepts de base
- Configuration minimale : rawdog-md est conçu pour être utilisé avec une configuration minimale. Choisissez un modèle de démarrage et commencez immédiatement à rédiger vos articles en markdown.
- Avis : Cet outil n'est pas destiné à être un générateur de sites statiques à usage général. Il est destiné à être utilisé pour un cas d’utilisation très spécifique, à savoir un site statique avec quelques pages modèles simples. Si vous voulez quelque chose de plus général et de plus avancé, consultez Hugo ou Jekyll.
- Apportez votre propre style : rawdog-md fournit le style minimal. Cependant, il est très facile à ajuster car il ne s’agit que d’un simple fichier CSS et HTML.
- Multiplateforme : Vous pouvez l'utiliser sous Windows, Linux et MacOS.
Installation
rawdog-md est disponible sur Windows, Linux et MacOS. Vous pouvez l'installer via les gestionnaires de packages, manuellement ou le créer à partir des sources.
Fenêtres
Installer via PowerShell (cliquez pour développer)
- Ouvrez PowerShell en tant qu'administrateur
- Exécutez cette commande
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
iex (irm https://raw.githubusercontent.com/dwiandhikaap/rawdog-md/main/.installer/powershell/install.ps1)
- Fait! Vous pouvez maintenant l'utiliser comme commande
rawd
dans votre terminal.
Installer via Scoop
- Installer Scoop
- Installer rawdog-md
scoop install https://raw.githubusercontent.com/dwiandhikaap/rawdog-md/main/.installer/scoop/rawdog-md.json
- Fait! Vous pouvez maintenant l'utiliser comme commande
rawd
dans votre terminal.
Comment désinstaller :
scoop uninstall rawdog-md
Installer manuellement
- Accédez à la dernière page de version
- Téléchargez celui avec le nom de fichier
rawd-{version}-windows-amd64.zip
- Extrayez le fichier zip où vous le souhaitez
- Ajoutez le dossier extrait à votre PATH. Si vous ne savez pas comment faire, consultez ce guide
- Fait! Vous pouvez maintenant l'utiliser comme commande
rawd
dans votre terminal.
Linux
Installer via Bash (Cliquez pour agrandir)
- Exécutez cette commande dans votre terminal
curl -fsSL https://raw.githubusercontent.com/dwiandhikaap/rawdog-md/main/.installer/bash/install.sh | bash
- Fait! Vous pouvez maintenant l'utiliser comme commande
rawd
dans votre terminal.
Installer manuellement
- Accédez à la dernière page de version
- Copiez l'URL de celui avec le nom de fichier
rawd-{version}-linux-{architecture}.tar.gz
- Exécutez cette commande dans votre terminal
wget {copied-url} -O rawd.tar.gz
tar -xvf rawd.tar.gz
sudo mv rawd /usr/local/bin
rm rawd.tar.gz
- Fait! Vous pouvez maintenant l'utiliser comme commande
rawd
dans votre terminal.
MacOS
Installer via Bash (Cliquez pour agrandir)
- Exécutez cette commande dans votre terminal
curl -fsSL https://raw.githubusercontent.com/dwiandhikaap/rawdog-md/main/.installer/bash/install.sh | bash
- Fait! Vous pouvez maintenant l'utiliser comme commande
rawd
dans votre terminal.
Installer manuellement
- Accédez à la dernière page de version
- Copiez l'URL de celui avec le nom de fichier
rawd-{version}-darwin-{architecture}.tar.gz
- Exécutez cette commande dans votre terminal
wget {copied-url} -O rawd.tar.gz
tar -xvf rawd.tar.gz
sudo mv rawd /usr/local/bin
rm rawd.tar.gz
- Fait! Vous pouvez maintenant l'utiliser comme commande
rawd
dans votre terminal.
Construire à partir des sources
Construire en utilisant Go (Cliquez pour agrandir)
Installer Aller
Installer rawdog-md
go install github.com/dwiandhikaap/rawdog-md
Cela installera le binaire en tant que rawdog-md
au lieu de rawd
si vous souhaitez le changer en rawd
, vous pouvez renommer le fichier binaire dans votre répertoire Go bin.
Consultez cette référence pour plus d’informations sur go install
.
Fait!
Usage
Créez un nouveau projet et choisissez un modèle prédéfini
Il vous demandera le nom du projet et le modèle que vous souhaitez utiliser.
Ensuite, allez dans le répertoire du projet
Démarrer le serveur de développement
Ouvrez votre navigateur et accédez à http://localhost:3000
Pour créer une nouvelle publication, créez un nouveau fichier dans le répertoire pages
. Vous pouvez utiliser Markdown, Go Template ou HTML.
Pour modifier le modèle, accédez au répertoire template
.
Chaque fois que vous enregistrez vos modifications, le serveur reconstruit le site et actualise le navigateur.
Lorsque vous avez terminé, créez le site
? Contribuer
Les demandes de tirage sont les bienvenues. Pour les changements majeurs, veuillez d'abord ouvrir un ticket pour discuter de ce que vous souhaitez changer.