diff --git a/plugins/push-md/docs/README.md b/plugins/push-md/docs/README.md index bc16e554..971336c3 100644 --- a/plugins/push-md/docs/README.md +++ b/plugins/push-md/docs/README.md @@ -18,6 +18,37 @@ It is intentionally static so it can be opened directly in a browser while the public site target is still undecided. The page positions Push MD as WordPress-as-source-of-truth for Git, agents, and Markdown workflows. +The social share card source lives next to the landing page: + +```text +plugins/push-md/docs/landing/social-card.html +``` + +To regenerate the Twitter/X and Open Graph card image, start a local static +server from the repository root: + +```bash +php -S 127.0.0.1:8876 -t plugins/push-md/docs/landing +``` + +Then capture the card at the expected social-preview size: + +```bash +'/Applications/Google Chrome.app/Contents/MacOS/Google Chrome' \ + --headless \ + --disable-gpu \ + --hide-scrollbars \ + --force-device-scale-factor=1 \ + --window-size=1200,630 \ + --screenshot=plugins/push-md/docs/landing/assets/push-md-social-card.png \ + http://127.0.0.1:8876/social-card.html +``` + +If Chrome is installed elsewhere, replace the binary path with the local +Chrome or Chromium executable. The generated +`plugins/push-md/docs/landing/assets/push-md-social-card.png` file is the image +referenced by the landing page's `og:image` and `twitter:image` tags. + ## What Push MD Does Push MD exposes supported WordPress content as a Git Smart HTTP remote at: diff --git a/plugins/push-md/docs/landing/assets/push-md-logo-full.png b/plugins/push-md/docs/landing/assets/push-md-logo-full.png new file mode 100644 index 00000000..d37cb8b3 Binary files /dev/null and b/plugins/push-md/docs/landing/assets/push-md-logo-full.png differ diff --git a/plugins/push-md/docs/landing/assets/push-md-logo.png b/plugins/push-md/docs/landing/assets/push-md-logo.png new file mode 100644 index 00000000..1a4c4f9d Binary files /dev/null and b/plugins/push-md/docs/landing/assets/push-md-logo.png differ diff --git a/plugins/push-md/docs/landing/assets/push-md-social-card.png b/plugins/push-md/docs/landing/assets/push-md-social-card.png new file mode 100644 index 00000000..b794a651 Binary files /dev/null and b/plugins/push-md/docs/landing/assets/push-md-social-card.png differ diff --git a/plugins/push-md/docs/landing/index.html b/plugins/push-md/docs/landing/index.html index cd923825..4ed43370 100644 --- a/plugins/push-md/docs/landing/index.html +++ b/plugins/push-md/docs/landing/index.html @@ -5,6 +5,19 @@ Push MD - WordPress as the Git remote for agents + + + + + + + + + + + + + @@ -12,7 +25,7 @@
- + Push MD - Download plugin + + + Download plugin +
@@ -35,7 +54,13 @@

# Markdown in Git. WordPress i revisions, rejects stale pushes, and lets WordPress render the site.

- Download plugin + + + Download plugin + Read docs
@@ -125,6 +150,18 @@

Agents complete WordPress work through Git.

  • [x] Carry site guidance in AGENTS.md and SKILL.md.
  • [x] Push only after WordPress accepts the change.
    • +
    +

    Agent skills depend on WordPress Guidelines.

    +
      +
    1. Install and activate the Gutenberg plugin.
      2. +
    2. Open the Gutenberg Experiments page and turn on the Guidelines experiment.
      3. +
    +

    + Once WordPress Guidelines are enabled, Push MD exposes skills as + wp_guideline/skills/{slug}/SKILL.md and adds the usual agent + entry points for local tools. +

    +
    @@ -188,6 +225,17 @@

    ### Does this work with any Git client?

    +
    +

    ### How do agent skills become available?

    +

    + Push MD stores agent skills as WordPress Guidelines. Today, that means the + site needs the Gutenberg plugin installed and active, with the Guidelines + experiment turned on from the Gutenberg Experiments page. After that, skills + appear in the checkout under wp_guideline/skills/{slug}/SKILL.md, + with generated aliases such as AGENTS.md for agent discovery. +

    +
    +

    ### What happens when someone edits in WP-Admin?

    diff --git a/plugins/push-md/docs/landing/landing.css b/plugins/push-md/docs/landing/landing.css index 97c48da2..73737709 100644 --- a/plugins/push-md/docs/landing/landing.css +++ b/plugins/push-md/docs/landing/landing.css @@ -84,24 +84,20 @@ pre { .brand { display: inline-flex; align-items: center; - gap: 10px; + gap: 12px; color: var(--ink); font-weight: 780; text-decoration: none; white-space: nowrap; } -.brand-mark { - display: inline-grid; - place-items: center; - width: 38px; - height: 38px; - border: 1px solid rgba(31, 29, 25, 0.18); - border-radius: 8px; - background: var(--ink); - color: #ffffff; - font-size: 11px; - letter-spacing: 0; +.brand-logo { + display: block; + flex: 0 0 auto; + width: 50px; + height: 50px; + object-fit: contain; + filter: drop-shadow(0 5px 12px rgba(31, 29, 25, 0.18)); } .site-nav { @@ -129,6 +125,7 @@ pre { display: inline-flex; align-items: center; justify-content: center; + gap: 8px; min-height: 42px; padding: 10px 16px; border: 1px solid transparent; @@ -139,6 +136,13 @@ pre { transition: transform 0.16s ease, box-shadow 0.16s ease, background 0.16s ease; } +.button-icon { + flex: 0 0 auto; + width: 16px; + height: 16px; + fill: currentColor; +} + .button:hover, .button:focus { transform: translateY(-1px); @@ -661,6 +665,31 @@ pre { font-weight: 800; } +.setup-note { + margin-top: 22px; + padding: 2px 0 2px 18px; + border-left: 3px solid var(--hash); + color: var(--muted); +} + +.setup-note p, +.setup-note ol { + max-width: 980px; + margin: 10px 0 0; +} + +.setup-note .setup-note-title { + margin-top: 0; + color: var(--ink); + font-weight: 780; +} + +.setup-note ol { + display: grid; + gap: 6px; + padding-left: 22px; +} + .file-map { display: grid; margin-top: 24px; @@ -808,24 +837,12 @@ pre { } @media (max-width: 1120px) { - html { - scroll-padding-top: 138px; - } - - section[id] { - scroll-margin-top: 138px; - } - .site-header { - flex-wrap: wrap; + gap: 16px; } .site-nav { - order: 3; - width: 100%; - justify-content: flex-start; - overflow-x: auto; - padding-bottom: 2px; + gap: 18px; } .hero, @@ -843,6 +860,28 @@ pre { } } +@media (max-width: 900px) { + html { + scroll-padding-top: 138px; + } + + section[id] { + scroll-margin-top: 138px; + } + + .site-header { + flex-wrap: wrap; + } + + .site-nav { + order: 3; + width: 100%; + justify-content: flex-start; + overflow-x: auto; + padding-bottom: 2px; + } +} + @media (max-width: 720px) { body { background-size: 100% 30px; diff --git a/plugins/push-md/docs/landing/social-card.html b/plugins/push-md/docs/landing/social-card.html new file mode 100644 index 00000000..948c5001 --- /dev/null +++ b/plugins/push-md/docs/landing/social-card.html @@ -0,0 +1,359 @@ + + + + + + Push MD social share card + + + +

    +
    +
    + + my-wordpress-website + trunk / WordPress remote +
    +
    +
    +
    + Push MD logo +
    +

    Push MD

    +

    Git-shaped WordPress publishing

    +
    +
    +

    # WordPress as the Git remote for agents

    +

    Clone posts as Markdown, pull WP-Admin edits, and push your changes with any git client.

    +
    +
    + edit: page/home.md + Agent updated Markdown locally. + $ git diff -- page/home.md + @@ + - Old CTA copy + + Keep WordPress in charge + $ git push origin trunk + remote: checked WordPress permissions + remote: created WordPress revision #185 + +
    +
    +
    +
    + +