fix permalink being mistakenly set to /the-article/index.md

instead of using the baseURL. This was caused by the config.yaml
not being loaded.

Author: maelvls

README.md

@@ -8,7 +8,7 @@
 - [Usage](#usage)
 - [Use it](#use-it)
   - [List your dev.to articles](#list-your-devto-articles)
-  - [Preview the Markdown content that will be pushed to dev.to](#preview-the-markdown-content-that-will-be-pushed-to-devto)
+  - [Transformations](#transformations)
   - [Push one blog post to dev.to](#push-one-blog-post-to-devto)
   - [Push all blog posts to dev.to](#push-all-blog-posts-to-devto)
 - [Notes](#notes)
@@ -117,57 +117,6 @@ Finally, you can push to DEV:
     success: ./content/cloth-impossible.md pushed to https://dev.to/maelvls/cloth-impossible-95dc
     success: ./content/powder-farmer.md pushed to https://dev.to/maelvls/powder-farmer-6a18
 
-TRANSFORMATIONS
-The Markdown for Hugo posts and dev.to articles have slight differences.
-Before pushing to dev.to, hudevto does some transformations to the Markdown
-file. To see the transformations before pushing the Hugo post to dev.to, use one of:
-
-    % hudevto diff ./debug-k8s/index.md
-
-The transformations are:
-
-1. ABSOLUTE MARKDOWN IMAGES: the relative image links are absolutified since
-   dev.to needs the image path to be absolute (the base URL itself is not
-   required).
-
-   The following Hugo Markdown snippet:
-
-     ![wireshark](wireshark.png)
-
-    becomes:
-
-      ![wireshark](/debug-k8s/wireshark.png)
-                   <--(1)--->
-
-    where (1) is the article's Hugo permalink to the ./debug-k8s/index.md post.
-    Note that the ![]() tag must span a single line. Otherwise, it won't be
-    transformed.
-
-2. ABSOLUTE HTML IMG TAGS: unlike with Markdown images, the <img> HTML tags
-   need to be absolute and needs to contain the base URL. For example, the
-   following HTML:
-
-        <img src="wireshark.png">
-
-    gets transformed to:
-
-        <img src="https://maelvls/debug-k8s/wireshark.png">
-
-    The <img> tag must be on a single line, and the "src" value must end with
-	one of the following extensions: png, PNG, jpeg, JPG, jpg, gif, GIF, svg,
-	SVG.
-
-3. SHORTCODES: Hugo shortcodes for embedding (like for embedding a Youtube video)
-   are turned into Liquid tags that dev.to knows about.
-4. ANCHOR IDS: Hugo and Devto have different anchor ID syntaxes.
-
-OPTIONS
-  -apikey string
-    	The API key for Dev.to. You can also set DEVTO_APIKEY instead.
-  -debug
-    	Print debug information such as the HTTP requests that are being made in curl format.
-  -root string
-    	Root directory of the Hugo project.
 ```
 
 ## Use it
@@ -181,8 +130,9 @@ export DEVTO_APIKEY=$(lpass show dev.to -p)
 
 ### List your dev.to articles
 
-This is useful because I have dev.to configured with the RSS feed of my
-blog so that dev.to automatically creates a draft of each of my new posts.
+This is useful because I have dev.to configured with the RSS feed of my blog so
+that dev.to automatically creates a draft of each of my new posts. Note that you
+don't need to set up RSS mirroring in order to use `hudevto`.
 
 ```sh
 % hudevto devto list
@@ -195,12 +145,24 @@ blog so that dev.to automatically creates a draft of each of my new posts.
 317339: published at https://dev.to/maelvls/learning-kubernetes-controllers-496j (Learning Kubernetes Controllers)
 ```
 
-### Preview the Markdown content that will be pushed to dev.to
+### Transformations
 
-I use the `hudevto preview` command because I do some transformations and I need a way to preview the changes to make sure the Markdown and front matter make sense. The transformations are:
+The Markdown for Hugo posts and dev.to articles have slight differences. Before
+pushing to dev.to, `hudevto` does some transformations to the Markdown file. To
+see the transformations before pushing the Hugo post to dev.to, you can use:
 
-- Generate a new front matter which is used by dev.to for setting the dev.to post title and canonical URL;
-- Change the Hugo "tags" into Liquid tags, such as:
+```sh
+hudevto preview ./content/2020/avoid-gke-lb-using-hostport/index.md
+hudevto diff ./content/2020/avoid-gke-lb-using-hostport/index.md
+```
+
+Here are the transformations that are made:
+
+- **Front matter:** Updates the Markdown front matter. The front matter is used
+  to configure the Devto post title and canonical URL.
+- **Shortcodes:** the Hugo shortcodes are transformed into shortcodes that
+  Devto knows about (called "Liquid tags"). For example, the following
+  Hugo shortcode:
 
   ```md
   {{< youtube 30a0WrfaS2A >}}
@@ -212,11 +174,12 @@ I use the `hudevto preview` command because I do some transformations and I need
   {% youtube 30a0WrfaS2A %}
   ```
 
-- Add the base URL of the post to the markdown images so that images are not
-  broken. ONLY WORKS if your images are stored along side your blog post, such
-  as:
+- **Absolute Markdown images:** Markdown image links are transformed to
+  absolute URLs using the base URL of the post. That way, images keep working
+  in Dev.to. ONLY WORKS if your images are stored along side your blog post,
+  such as:
 
-  ```sh
+  ```console
   % ls --tree ./content/2020/avoid-gke-lb-using-hostport
   ./content/2020/avoid-gke-lb-using-hostport
   ├── cost-load-balancer-gke.png
@@ -226,8 +189,9 @@ I use the `hudevto preview` command because I do some transformations and I need
   └── packet-routing-with-akrobateo.png
   ```
 
-- The relative image links are "absolutified". This is needed so that Devto can
-  access the images. For example, the following post:
+- **Absolute HTML `<img>` tags:** The relative image links are "absolutified".
+  This is needed so that Devto can access the images. For example, the following
+  post:
 
   <https://maelvls.dev/you-should-write-comments/index.md>
 
@@ -296,9 +260,10 @@ I use the `hudevto preview` command because I do some transformations and I need
   Only the following image extensions are converted: png, PNG, jpeg, JPG, jpg,
   gif, GIF, svg, SVG.
 
-- The GitHub-style anchor IDs are converted to Devto anchor IDs. This is because
-  GitHub-style anchor IDs, which is what Hugo produces, are different from the
-  ones produced by Devto. For example, take the following Markdown:
+- **Anchor IDs**: The GitHub-style anchor IDs are converted to Devto anchor IDs.
+  This is because GitHub-style anchor IDs, which is what Hugo produces, are
+  different from the ones produced by Devto. For example, take the following
+  Markdown:
 
   ```markdown
   [`go get -u` vs. `go.mod` (= _*Problem*_)](#go-get--u-vs-gomod--_problem_)

go.mod

@@ -1,6 +1,6 @@
 module github.com/maelvls/hudevto
 
-go 1.23.0
+go 1.23.5
 
 toolchain go1.24.2
 
@@ -61,6 +61,13 @@ require (
 	github.com/bep/mclib v1.20400.20402 // indirect
 	github.com/bep/simplecobra v0.6.0 // indirect
 	github.com/cespare/xxhash/v2 v2.3.0 // indirect
+	github.com/charmbracelet/colorprofile v0.3.0 // indirect
+	github.com/charmbracelet/fang v0.2.0 // indirect
+	github.com/charmbracelet/lipgloss/v2 v2.0.0-beta.1 // indirect
+	github.com/charmbracelet/x/ansi v0.8.0 // indirect
+	github.com/charmbracelet/x/cellbuf v0.0.13 // indirect
+	github.com/charmbracelet/x/exp/charmtone v0.0.0-20250603201427-c31516f43444 // indirect
+	github.com/charmbracelet/x/term v0.2.1 // indirect
 	github.com/cpuguy83/go-md2man/v2 v2.0.6 // indirect
 	github.com/dustin/go-humanize v1.0.1 // indirect
 	github.com/fatih/color v1.18.0 // indirect
@@ -83,8 +90,15 @@ require (
 	github.com/inconshreveable/mousetrap v1.1.0 // indirect
 	github.com/jmespath/go-jmespath v0.4.0 // indirect
 	github.com/kylelemons/godebug v1.1.0 // indirect
+	github.com/lucasb-eyer/go-colorful v1.2.0 // indirect
+	github.com/maelvls/undent v1.0.0 // indirect
 	github.com/magefile/mage v1.15.0 // indirect
 	github.com/makeworld-the-better-one/dither/v2 v2.4.0 // indirect
+	github.com/muesli/cancelreader v0.2.2 // indirect
+	github.com/muesli/mango v0.2.0 // indirect
+	github.com/muesli/mango-cobra v1.2.0 // indirect
+	github.com/muesli/mango-pflag v0.1.0 // indirect
+	github.com/muesli/roff v0.1.0 // indirect
 	github.com/oasdiff/yaml v0.0.0-20250309154309-f31be36b4037 // indirect
 	github.com/oasdiff/yaml3 v0.0.0-20250309153720-d2182401db90 // indirect
 	github.com/olekukonko/errors v0.0.0-20250405072817-4e6d85265da6 // indirect
@@ -96,6 +110,7 @@ require (
 	github.com/spf13/cobra v1.9.1 // indirect
 	github.com/spf13/fsync v0.10.1 // indirect
 	github.com/tetratelabs/wazero v1.9.0 // indirect
+	github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect
 	github.com/yuin/goldmark-emoji v1.0.6 // indirect
 	go.opencensus.io v0.24.0 // indirect
 	go.opentelemetry.io/auto/sdk v1.1.0 // indirect
@@ -175,7 +190,7 @@ require (
 	github.com/pelletier/go-toml/v2 v2.2.4 // indirect
 	github.com/perimeterx/marshmallow v1.1.5 // indirect
 	github.com/pmezard/go-difflib v1.0.0 // indirect
-	github.com/rivo/uniseg v0.4.3 // indirect
+	github.com/rivo/uniseg v0.4.7 // indirect
 	github.com/rogpeppe/go-internal v1.14.1 // indirect
 	github.com/rwcarlsen/goexif v0.0.0-20190401172101-9e8deecbddbd // indirect
 	github.com/sanity-io/litter v1.5.8 // indirect

go.sum

@@ -277,6 +277,20 @@ github.com/cespare/xxhash v1.1.0/go.mod h1:XrSqR1VqqWfGrhpAt58auRo0WTKS1nRRg3ghf
 github.com/cespare/xxhash/v2 v2.1.1/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
 github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs=
 github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
+github.com/charmbracelet/colorprofile v0.3.0 h1:KtLh9uuu1RCt+Hml4s6Hz+kB1PfV3wi++1h5ia65yKQ=
+github.com/charmbracelet/colorprofile v0.3.0/go.mod h1:oHJ340RS2nmG1zRGPmhJKJ/jf4FPNNk0P39/wBPA1G0=
+github.com/charmbracelet/fang v0.2.0 h1:F2sK2Zjy9kRYz/xUSF1o89DNj2BHKpxVKT7TA21KZi0=
+github.com/charmbracelet/fang v0.2.0/go.mod h1:TPpME1GkB6/4uR4wXmPnugTCkqRLgZkWSH+aMds6454=
+github.com/charmbracelet/lipgloss/v2 v2.0.0-beta.1 h1:D9AJJuYTN5pvz6mpIGO1ijLKpfTYSHOtKGgwoTQ4Gog=
+github.com/charmbracelet/lipgloss/v2 v2.0.0-beta.1/go.mod h1:tRlx/Hu0lo/j9viunCN2H+Ze6JrmdjQlXUQvvArgaOc=
+github.com/charmbracelet/x/ansi v0.8.0 h1:9GTq3xq9caJW8ZrBTe0LIe2fvfLR/bYXKTx2llXn7xE=
+github.com/charmbracelet/x/ansi v0.8.0/go.mod h1:wdYl/ONOLHLIVmQaxbIYEC/cRKOQyjTkowiI4blgS9Q=
+github.com/charmbracelet/x/cellbuf v0.0.13 h1:/KBBKHuVRbq1lYx5BzEHBAFBP8VcQzJejZ/IA3iR28k=
+github.com/charmbracelet/x/cellbuf v0.0.13/go.mod h1:xe0nKWGd3eJgtqZRaN9RjMtK7xUYchjzPr7q6kcvCCs=
+github.com/charmbracelet/x/exp/charmtone v0.0.0-20250603201427-c31516f43444 h1:IJDiTgVE56gkAGfq0lBEloWgkXMk4hl/bmuPoicI4R0=
+github.com/charmbracelet/x/exp/charmtone v0.0.0-20250603201427-c31516f43444/go.mod h1:T9jr8CzFpjhFVHjNjKwbAD7KwBNyFnj2pntAO7F2zw0=
+github.com/charmbracelet/x/term v0.2.1 h1:AQeHeLZ1OqSXhrAWpYUtZyX1T3zVxfpZuEQMIQaGIAQ=
+github.com/charmbracelet/x/term v0.2.1/go.mod h1:oQ4enTYFV7QN4m0i9mzHrViD7TQKvNEEkHUMCmsxdUg=
 github.com/chaseadamsio/goorgeous v2.0.0+incompatible/go.mod h1:6QaC0vFoKWYDth94dHFNgRT2YkT5FHdQp/Yx15aAAi0=
 github.com/cheekybits/is v0.0.0-20150225183255-68e9c0620927/go.mod h1:h/aW8ynjgkuj+NQRlZcDbAbM1ORAbXjXX77sX7T289U=
 github.com/chzyer/logex v1.1.10/go.mod h1:+Ywpsq7O8HXn0nuIou7OrIPyXbp3wmkHB+jjWRnGsAI=
@@ -600,6 +614,10 @@ github.com/kyokomi/emoji/v2 v2.2.13 h1:GhTfQa67venUUvmleTNFnb+bi7S3aocF7ZCXU9fSO
 github.com/kyokomi/emoji/v2 v2.2.13/go.mod h1:JUcn42DTdsXJo1SWanHh4HKDEyPaR5CqkmoirZZP9qE=
 github.com/leodido/go-urn v1.2.0/go.mod h1:+8+nEpDfqqsY+g338gtMEUOtuK+4dEMhiQEgxpxOKII=
 github.com/lib/pq v1.10.2/go.mod h1:AlVN5x4E4T544tWzH6hKfbfQvm3HdbOxrmggDNAPY9o=
+github.com/lucasb-eyer/go-colorful v1.2.0 h1:1nnpGOrhyZZuNyfu1QjKiUICQ74+3FNCN69Aj6K7nkY=
+github.com/lucasb-eyer/go-colorful v1.2.0/go.mod h1:R4dSotOR9KMtayYi1e77YzuveK+i7ruzyGqttikkLy0=
+github.com/maelvls/undent v1.0.0 h1:m29cCHf2xKL7xedFEV5kPLYhp9D5XWv9Fhk5HkShZ+E=
+github.com/maelvls/undent v1.0.0/go.mod h1:GJliZCA6UKzN0V/GkJUuICibJ73iRxI1D1G7fxRq9q4=
 github.com/magefile/mage v1.14.0/go.mod h1:z5UZb/iS3GoOSn0JgWuiw7dxlurVYTu+/jHXqQg881A=
 github.com/magefile/mage v1.15.0 h1:BvGheCMAsG3bWUDbZ8AyXXpCNwU9u5CB6sM+HNb9HYg=
 github.com/magefile/mage v1.15.0/go.mod h1:z5UZb/iS3GoOSn0JgWuiw7dxlurVYTu+/jHXqQg881A=
@@ -646,6 +664,18 @@ github.com/modern-go/reflect2 v0.0.0-20180701023420-4b7aa43c6742/go.mod h1:bx2lN
 github.com/mohae/deepcopy v0.0.0-20170929034955-c48cc78d4826 h1:RWengNIwukTxcDr9M+97sNutRR1RKhG96O6jWumTTnw=
 github.com/mohae/deepcopy v0.0.0-20170929034955-c48cc78d4826/go.mod h1:TaXosZuwdSHYgviHp1DAtfrULt5eUgsSMsZf+YrPgl8=
 github.com/montanaflynn/stats v0.6.3/go.mod h1:wL8QJuTMNUDYhXwkmfOly8iTdp5TEcJFWZD2D7SIkUc=
+github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA=
+github.com/muesli/cancelreader v0.2.2/go.mod h1:3XuTXfFS2VjM+HTLZY9Ak0l6eUKfijIfMUZ4EgX0QYo=
+github.com/muesli/mango v0.1.0 h1:DZQK45d2gGbql1arsYA4vfg4d7I9Hfx5rX/GCmzsAvI=
+github.com/muesli/mango v0.1.0/go.mod h1:5XFpbC8jY5UUv89YQciiXNlbi+iJgt29VDC5xbzrLL4=
+github.com/muesli/mango v0.2.0 h1:iNNc0c5VLQ6fsMgAqGQofByNUBH2Q2nEbD6TaI+5yyQ=
+github.com/muesli/mango v0.2.0/go.mod h1:5XFpbC8jY5UUv89YQciiXNlbi+iJgt29VDC5xbzrLL4=
+github.com/muesli/mango-cobra v1.2.0 h1:DQvjzAM0PMZr85Iv9LIMaYISpTOliMEg+uMFtNbYvWg=
+github.com/muesli/mango-cobra v1.2.0/go.mod h1:vMJL54QytZAJhCT13LPVDfkvCUJ5/4jNUKF/8NC2UjA=
+github.com/muesli/mango-pflag v0.1.0 h1:UADqbYgpUyRoBja3g6LUL+3LErjpsOwaC9ywvBWe7Sg=
+github.com/muesli/mango-pflag v0.1.0/go.mod h1:YEQomTxaCUp8PrbhFh10UfbhbQrM/xJ4i2PB8VTLLW0=
+github.com/muesli/roff v0.1.0 h1:YD0lalCotmYuF5HhZliKWlIx7IEhiXeSfq7hNjFqGF8=
+github.com/muesli/roff v0.1.0/go.mod h1:pjAHQM9hdUUwm/krAfrLGgJkXJ+YuhtsfZ42kieB2Ig=
 github.com/muesli/smartcrop v0.3.0 h1:JTlSkmxWg/oQ1TcLDoypuirdE8Y/jzNirQeLkxpA6Oc=
 github.com/muesli/smartcrop v0.3.0/go.mod h1:i2fCI/UorTfgEpPPLWiFBv4pye+YAG78RwcQLUkocpI=
 github.com/neurosnap/sentences v1.0.6/go.mod h1:pg1IapvYpWCJJm/Etxeh0+gtMf1rI1STY9S7eUCPbDc=
@@ -694,6 +724,8 @@ github.com/prometheus/client_model v0.0.0-20190812154241-14fe0d1b01d4/go.mod h1:
 github.com/rivo/uniseg v0.2.0/go.mod h1:J6wj4VEh+S6ZtnVlnTBMWIodfgj8LQOQFoIToxlJtxc=
 github.com/rivo/uniseg v0.4.3 h1:utMvzDsuh3suAEnhH0RdHmoPbU648o6CvXxTx4SBMOw=
 github.com/rivo/uniseg v0.4.3/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=
+github.com/rivo/uniseg v0.4.7 h1:WUdvkW8uEhrYfLC4ZzdpI2ztxP1I582+49Oc5Mq64VQ=
+github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=
 github.com/rogpeppe/fastuuid v1.2.0/go.mod h1:jVj6XXZzXRy/MSR5jhDC/2q6DgLz+nrA6LYCDYWNEvQ=
 github.com/rogpeppe/go-internal v1.3.0/go.mod h1:M8bDsm7K2OlrFYOpmOWEs/qY81heoFRclV5y23lUDJ4=
 github.com/rogpeppe/go-internal v1.6.1/go.mod h1:xXDCJY+GAPziupqXw64V24skbSoqbTEfhy4qGm1nDQc=
@@ -781,6 +813,8 @@ github.com/ugorji/go v1.2.7/go.mod h1:nF9osbDWLy6bDVv/Rtoh6QgnvNDpmCalQV5urGCCS6
 github.com/ugorji/go/codec v1.1.7/go.mod h1:Ax+UKWsSmolVDwsd+7N3ZtXu+yMGCf907BLYF3GoBXY=
 github.com/ugorji/go/codec v1.2.7 h1:YPXUKf7fYbp/y8xloBqZOw2qaVggbfwMlI8WM3wZUJ0=
 github.com/ugorji/go/codec v1.2.7/go.mod h1:WGN1fab3R1fzQlVQTkfxVtIBhWDRqOviHU95kRgeqEY=
+github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e h1:JVG44RsyaB9T2KIHavMF/ppJZNG9ZpyihvCd0w101no=
+github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e/go.mod h1:RbqR21r5mrJuqunuUZ/Dhy/avygyECGrLceyNeo4LiM=
 github.com/yuin/goldmark v1.1.25/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
 github.com/yuin/goldmark v1.1.27/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
 github.com/yuin/goldmark v1.1.32/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=

logutil/logutil.go

@@ -23,18 +23,18 @@ func Debugf(format string, a ...interface{}) {
 	if !EnableDebug {
 		return
 	}
-	fmt.Fprintf(os.Stderr, "%s: ", Gray("debug"))
-	fmt.Fprintf(os.Stderr, format+"\n", a...)
+	_, _ = fmt.Fprintf(os.Stderr, "%s: ", Gray("debug"))
+	_, _ = fmt.Fprintf(os.Stderr, format+"\n", a...)
 }
 
 // Prints to stderr.
 func Errorf(format string, a ...interface{}) {
-	fmt.Fprintf(os.Stderr, "%s: ", Red("error"))
-	fmt.Fprintf(os.Stderr, format+"\n", a...)
+	_, _ = fmt.Fprintf(os.Stderr, "%s: ", Red("error"))
+	_, _ = fmt.Fprintf(os.Stderr, format+"\n", a...)
 }
 
 // Prints to stderr.
 func Infof(format string, a ...interface{}) {
-	fmt.Fprintf(os.Stderr, "%s: ", Yel("info"))
-	fmt.Fprintf(os.Stderr, format+"\n", a...)
+	_, _ = fmt.Fprintf(os.Stderr, "%s: ", Yel("info"))
+	_, _ = fmt.Fprintf(os.Stderr, format+"\n", a...)
 }