pagecord-cli 0.3.2 → 0.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf505ffa08cc845661d677e1b4e5175ed12151719a68bf6e36e74899aca6c735
-  data.tar.gz: 11c57b10cf54268f70bec8eab14c4daf2ffb3abc3b10183cbe90e6e3a9bb15a5
+  metadata.gz: 19a08d2465d20f5f6b630f2cddd3d1d24c708ce88c4c398b5f9b3bd280627bb0
+  data.tar.gz: f3a94234b517171e5ebbcbd8847f06800dc794f9eb65e1071a0572fc5a658ff1
 SHA512:
-  metadata.gz: 2d6eabb97a9acb6ee7c3f61f7ccc676d7db740b7b2516583218a0902ca8fc5b4950eeb4143b1315e9adce799193f48c72bcfa9d3e625c91130bee6c3df814186
-  data.tar.gz: 194d199f07c81ef3f6d385179e79222a5dac4b0984a2a470ff5f5ac52f0097992b013f264e443fec601ad1dc37e62ff9566a2bb68bccd82d15a2defc11a5f820
+  metadata.gz: 12d357026fc0faeb4056843b460691683df68c87941436961e47fd26e7601befe3d897c741fb0cc9cabc1730c86c0e05ecddbffc67fe9117e7a94f79e1d7bf63
+  data.tar.gz: b9dea1b6cf8f01476551d49d5acfc781b579a20120a25751e2babc6047ad9b1b6d9731b3f47f75d41cacff890bb10c82e2b4ac15ce8123474231e45cdf027f3a

data/README.md

@@ -76,8 +76,9 @@ pagecord post delete TOKEN          # add --permanent to skip the bin
 `pagecord page` takes the same commands. Lists are paged 15 at a time; pass
 `--page N` for more. `--content-file` sends Markdown when the file ends `.md`,
 and HTML otherwise. Other flags: `--title`, `--status draft|published`,
-`--slug`, `--published-at`, `--tags`, `--canonical-url`, `--locale` and
-`--hidden`/`--no-hidden`. `--json` prints the full response.
+`--slug`, `--published-at`, `--tags`, `--canonical-url`, `--link-url` (posts
+only), `--locale` and `--hidden`/`--no-hidden`. `--json` prints the full
+response.
 
 ## Agent skill
 
@@ -165,6 +166,7 @@ Accepted by every command, before or after the command name:
 --published-at TIME
 --tags TAGS
 --canonical-url URL
+--link-url URL
 --hidden
 --locale LOCALE
 ```
@@ -182,11 +184,15 @@ tags:
   - cli
 published_at: 2026-01-02T03:04:05Z
 canonical_url: https://example.com/original
+link_url: https://example.com/an-article
 hidden: false
 locale: en
 ---
 ```
 
+`link_url` makes it a link post: the title links to that address. Use
+`--link-url ""` to turn a link post back into a normal post.
+
 If `title` is omitted, the CLI uses the filename. Use `title:` or
 `title: ""` to publish without a title.
 
@@ -210,9 +216,13 @@ Action Text attachments:
 
 ```markdown
 ![Alt text](photo.jpg)
+![Alt text](my photo.jpg "A caption")
 ![[photo.jpg]]
 ```
 
+The alt text and an optional quoted caption go onto the image. Filenames can
+contain spaces.
+
 Supported local image types are JPEG, PNG, GIF, and WebP. External image URLs
 and HTML `<img>` tags are left alone.
 

data/lib/pagecord_cli/SKILL.md

@@ -51,7 +51,8 @@ pagecord post update TOKEN --content-file post.html --status draft
 ```
 
 `update` changes only the flags given. Other fields: `--slug`,
-`--published-at`, `--tags "a, b"`, `--canonical-url`, `--locale`,
+`--published-at`, `--tags "a, b"`, `--canonical-url`, `--link-url` (makes a
+link post, whose title links to that address), `--locale`,
 `--hidden`/`--no-hidden`. Delete moves a post to the bin unless you pass
 `--permanent`, which can't be undone: confirm with the user first.
 
@@ -64,8 +65,9 @@ pagecord draft notes/idea.md         # save as a draft
 
 The first run writes a `pagecord_token` into the file's front matter, and later
 runs update that same post. Front matter can set `title`, `slug`, `tags`,
-`published_at`, `canonical_url`, `hidden` and `locale`. Local images written as
-`![alt](photo.jpg)` are uploaded.
+`published_at`, `canonical_url`, `link_url`, `hidden` and `locale`. Local images written as
+`![alt](photo.jpg "Caption")` are uploaded with their alt text and
+optional caption.
 
 ## Restyling a blog
 

data/lib/pagecord_cli/cli.rb

@@ -307,6 +307,7 @@ module PagecordCLI
           opts.on("--published-at TIME") { |value| params[:published_at] = value }
           opts.on("--tags TAGS") { |value| params[:tags] = value }
           opts.on("--canonical-url URL") { |value| params[:canonical_url] = value }
+          opts.on("--link-url URL") { |value| params[:link_url] = value }
           opts.on("--[no-]hidden") { |value| params[:hidden] = value }
           opts.on("--locale LOCALE") { |value| params[:locale] = value }
         end.parse!(argv)
@@ -349,6 +350,7 @@ module PagecordCLI
           opts.on("--published-at TIME") { |value| overrides[:published_at] = value }
           opts.on("--tags TAGS") { |value| overrides[:tags] = value }
           opts.on("--canonical-url URL") { |value| overrides[:canonical_url] = value }
+          opts.on("--link-url URL") { |value| overrides[:link_url] = value }
           opts.on("--[no-]hidden") { |value| overrides[:hidden] = value }
           opts.on("--locale LOCALE") { |value| overrides[:locale] = value }
         end.parse!(argv)
@@ -484,6 +486,7 @@ module PagecordCLI
             --published-at TIME
             --tags TAGS
             --canonical-url URL
+            --link-url URL              makes a post a link post: the title links here
             --locale LOCALE
             --hidden, --no-hidden
             --content-file PATH         post/page create and update; Markdown if it ends .md

data/lib/pagecord_cli/image_uploads.rb

@@ -1,10 +1,12 @@
 # frozen_string_literal: true
 
 require "digest"
+require "cgi/escape"
+require "uri"
 
 module PagecordCLI
   class ImageUploads
-    MARKDOWN_IMAGE = /!\[([^\]]*)\]\(([^)]+)\)/
+    MARKDOWN_IMAGE = /!\[([^\]]*)\]\(([^)"]+?)(?:\s+"([^"]*)")?\)/
     OBSIDIAN_IMAGE = /!\[\[([^\]]+)\]\]/
     IMAGE_EXTENSIONS = /\.(jpe?g|png|gif|webp)\z/i
 
@@ -20,8 +22,9 @@ module PagecordCLI
 
     def process
       with_markdown_images = content.gsub(MARKDOWN_IMAGE) do |match|
-        path = Regexp.last_match(2)
-        local_path?(path) ? attachment_tag_for(path) : match
+        alt, path, caption = Regexp.last_match.captures
+        path = decode_path(path)
+        local_path?(path) ? attachment_tag_for(path, alt: alt, caption: caption) : match
       end
 
       with_markdown_images.gsub(OBSIDIAN_IMAGE) do |match|
@@ -32,9 +35,20 @@ module PagecordCLI
 
     private
 
-      def attachment_tag_for(path)
+      def attachment_tag_for(path, alt: nil, caption: nil)
         sgid = cached_sgid(path) || upload(path)
-        %(<action-text-attachment sgid="#{sgid}"></action-text-attachment>)
+        %(<action-text-attachment sgid="#{sgid}"#{attribute("alt", alt)}#{attribute("caption", caption)}></action-text-attachment>)
+      end
+
+      def attribute(name, value)
+        %( #{name}="#{CGI.escapeHTML(value)}") unless value.to_s.empty?
+      end
+
+      # A filename can contain a literal "%", as in 100%.jpg.
+      def decode_path(path)
+        URI.decode_uri_component(path)
+      rescue ArgumentError
+        path
       end
 
       def cached_sgid(path)
@@ -74,7 +88,8 @@ module PagecordCLI
       end
 
       def checksum(path)
-        Digest::SHA256.file(path).hexdigest[0, 16]
+        @checksums ||= {}
+        @checksums[path] ||= Digest::SHA256.file(path).hexdigest[0, 16]
       end
 
       def filename(path)

data/lib/pagecord_cli/post_file.rb

@@ -66,7 +66,7 @@ module PagecordCLI
     def params
       publish_params = { title: title_from_metadata }
 
-      %w[slug published_at canonical_url locale].each do |key|
+      %w[slug published_at canonical_url link_url locale].each do |key|
         value = frontmatter_string(metadata[key])
         publish_params[key.to_sym] = value if value
       end

data/lib/pagecord_cli/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PagecordCLI
-  VERSION = "0.3.2"
+  VERSION = "0.3.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pagecord-cli
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.3.4
 platform: ruby
 authors:
 - Olly Headey