@songmu/mdhq 0.0.4 → 0.0.5

package/README.md

@@ -21,6 +21,7 @@ mdhq get https://example.com/article
 mdhq get https://example.com/article https://example.com/another-article
 cat urls.txt | mdhq get
 mdhq get --update https://example.com/article
+mdhq get --assets https://example.com/article
 mdhq get --no-assets https://example.com/article
 mdhq get --json --header 'Cookie: session=value' https://example.com/article
 mdhq list
@@ -102,7 +103,8 @@ const saved = await getPage({
 
 `convertHtml` performs extraction without fetching or writing files.
 `getPage` fetches, converts, optionally localizes images, adds frontmatter,
-and saves the document. Set `assets: false` or use `--no-assets` to keep
+and saves the document. Use `--assets` or `--no-assets` to override the
+configured asset behavior. Set `assets: false` or use `--no-assets` to keep
 absolute image URLs without creating `_assets`.
 
 Saved frontmatter uses Obsidian Web Clipper-compatible names such as `title`,

package/dist/cli.js

@@ -65,6 +65,7 @@ export function createProgram(io = process) {
         .description("Fetch and save web pages.")
         .argument("[urls...]")
         .option("--root <path>", "storage root")
+        .option("--assets", "download images")
         .option("--no-assets", "do not download images")
         .option("--update", "update an existing page")
         .option("--user-agent <value>", "HTTP User-Agent")
@@ -91,7 +92,7 @@ export function createProgram(io = process) {
                 const result = await getPage({
                     url,
                     ...(options.root ? { root: options.root } : {}),
-                    ...(options.assets === false ? { assets: false } : {}),
+                    ...(options.assets !== undefined ? { assets: options.assets } : {}),
                     update: options.update ?? false,
                     ...(options.userAgent ? { userAgent: options.userAgent } : {}),
                     headers: parseHeaders(options.header),

package/docs/configuration.md

@@ -106,10 +106,11 @@ Otherwise configuration overrides the built-in default.
 The CLI `--user-agent` option is passed as `GetPageOptions.userAgent` and
 therefore overrides configuration `userAgent`.
 
-The CLI `--no-assets` option passes `GetPageOptions.assets: false` and
-therefore overrides configuration `assets`. When asset localization is
-disabled, image destinations remain absolute URLs, the result contains no
-asset entries, and mdhq does not create `_assets`.
+The CLI `--assets` and `--no-assets` options pass
+`GetPageOptions.assets: true` and `GetPageOptions.assets: false`,
+respectively, and therefore override configuration `assets`. When asset
+localization is disabled, image destinations remain absolute URLs, the result
+contains no asset entries, and mdhq does not create `_assets`.
 
 Generic CLI `--header` values and library `headers` values are appended after
 mdhq creates its `Accept` and User-Agent headers. A generic `User-Agent` or

package/docs/specification.md

@@ -506,10 +506,11 @@ For images:
 
 Asset localization is enabled by default. It can be disabled with the
 top-level configuration field `assets: false`, library option
-`GetPageOptions.assets: false`, or CLI option `--no-assets`. The library
-option and CLI option take precedence over configuration. When disabled,
-HTTP(S) image destinations are kept as absolute URLs, the result `assets`
-array is empty, and `_assets` is not created.
+`GetPageOptions.assets: false`, or CLI option `--no-assets`. The CLI options
+`--assets` and `--no-assets` explicitly enable or disable localization and
+take precedence over configuration, as does the library option. When
+disabled, HTTP(S) image destinations are kept as absolute URLs, the result
+`assets` array is empty, and `_assets` is not created.
 
 mdhq does not rewrite ordinary links to other locally stored Markdown
 files.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@songmu/mdhq",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Save web pages as Markdown in a ghq-inspired filesystem layout.",
   "type": "module",
   "bin": {