From b2e82cb9d8566b8c27e8340db556b46563595dc5 Mon Sep 17 00:00:00 2001 From: Dave Tang Date: Tue, 23 Jun 2026 18:04:11 +0900 Subject: Add quickstart and pin versions --- README.md | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 53941df..9095411 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,19 @@ A complete guide to self-hosting Docsify with no external CDN dependencies. We f --- +## Quick Start + +If you just want a working site, run the bundled script from your document root. It performs every step in this guide automatically: it downloads and version-pins all assets, writes `index.html`, creates starter content, and generates a SHA-256 checksum manifest. + +```bash +cd /path/to/your/docroot +bash /path/to/scripts/setup.sh +``` + +Re-running is safe: it refreshes the vendored assets and regenerates `index.html`, but never overwrites your Markdown files (`README.md`, `_sidebar.md`, or any pages you have added). Everything below explains what the script does and how to perform each step by hand. + +--- + ## Prerequisites - Any static web server (Apache, nginx, Caddy, or similar) @@ -374,10 +387,13 @@ Since you are creating these files yourself, you already own them. Just ensure t are readable by your web server's user (e.g. `www-data`, `nginx`, or `caddy`): ```bash -find . -type f -exec chmod 644 {} \; -find . -type d -exec chmod 755 {} \; +find . -path './.*' -prune -o -type f -exec chmod 644 {} \; +find . -path './.*' -prune -o -type d -exec chmod 755 {} \; ``` +The `-path './.*' -prune` clause skips dotfiles and dotdirectories, so if your document +root is a Git repository these commands leave its `.git/` permissions untouched. + --- ## Serving the Site -- cgit v1.3.1