Merge branch 'mattcone:master' into master

Author: Neutree

.github/workflows/tests.yml

@@ -4,20 +4,11 @@ jobs:
   test-links:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-ruby@v1
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@ec02537da5712d66d4d50a0f33b7eb52773b5ed1
         with:
-          ruby-version: '2.7'
-      - uses: actions/cache@v2
-        with:
-          path: vendor/bundle
-          key: ${{ runner.os }}-gems-${{ hashFiles('**/Gemfile.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-gems-
-      - name: Install dependencies
-        run: |
-          gem install bundler
-          bundle config path vendor/bundle
-          bundle install --jobs 4 --retry 3
+          ruby-version: '3.2.1'
+          bundler-cache: true
+      - run: bundle install
       - name: Run tests
         run: bundle exec rake test

.gitignore

@@ -3,6 +3,7 @@ _site/
 .bundle/
 .git-metadata/
 .jekyll-cache/
+deploy.sh
 
 # =========================
 # Operating System Files

.ruby-version

@@ -1 +1 @@
-2.7.2
+3.2.2

Gemfile.lock

@@ -1,30 +1,44 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.1)
+    Ascii85 (1.1.0)
+    addressable (2.8.6)
       public_suffix (>= 2.0.2, < 6.0)
+    afm (0.2.2)
+    async (2.7.0)
+      console (~> 1.10)
+      fiber-annotation
+      io-event (~> 1.1)
+      timers (~> 4.1)
     colorator (1.1.0)
-    concurrent-ruby (1.1.10)
+    concurrent-ruby (1.2.2)
+    console (1.23.3)
+      fiber-annotation
+      fiber-local
     em-websocket (0.5.3)
       eventmachine (>= 0.12.9)
       http_parser.rb (~> 0)
-    ethon (0.15.0)
+    ethon (0.16.0)
       ffi (>= 1.15.0)
     eventmachine (1.2.7)
-    ffi (1.15.5)
+    ffi (1.16.3)
+    fiber-annotation (0.2.0)
+    fiber-local (1.0.0)
     forwardable-extended (2.6.0)
-    html-proofer (4.4.0)
+    hashery (2.1.2)
+    html-proofer (5.0.8)
       addressable (~> 2.3)
-      mercenary (~> 0.3)
+      async (~> 2.1)
       nokogiri (~> 1.13)
-      parallel (~> 1.10)
+      pdf-reader (~> 2.11)
       rainbow (~> 3.0)
       typhoeus (~> 1.3)
       yell (~> 2.0)
       zeitwerk (~> 2.5)
     http_parser.rb (0.8.0)
-    i18n (1.12.0)
+    i18n (1.14.1)
       concurrent-ruby (~> 1.0)
+    io-event (1.4.0)
     jekyll (4.2.2)
       addressable (~> 2.4)
       colorator (~> 1.0)
@@ -53,39 +67,47 @@ GEM
       rexml
     kramdown-parser-gfm (1.1.0)
       kramdown (~> 2.0)
-    liquid (4.0.3)
-    listen (3.7.1)
+    liquid (4.0.4)
+    listen (3.8.0)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     mercenary (0.4.0)
-    mini_portile2 (2.8.0)
-    nokogiri (1.13.8)
-      mini_portile2 (~> 2.8.0)
+    mini_portile2 (2.8.5)
+    nokogiri (1.16.0)
+      mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
-    parallel (1.22.1)
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
+    pdf-reader (2.12.0)
+      Ascii85 (~> 1.0)
+      afm (~> 0.2.1)
+      hashery (~> 2.0)
+      ruby-rc4
+      ttfunk
     posix-spawn (0.3.15)
-    public_suffix (5.0.0)
-    racc (1.6.0)
+    public_suffix (5.0.4)
+    racc (1.7.3)
     rainbow (3.1.1)
-    rake (13.0.6)
+    rake (13.1.0)
     rb-fsevent (0.11.2)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
-    rexml (3.2.5)
+    rexml (3.2.6)
     rouge (3.30.0)
+    ruby-rc4 (0.1.5)
     safe_yaml (1.0.5)
     sassc (2.4.0)
       ffi (~> 1.9)
     terminal-table (2.0.0)
       unicode-display_width (~> 1.1, >= 1.1.1)
-    typhoeus (1.4.0)
+    timers (4.3.5)
+    ttfunk (1.7.0)
+    typhoeus (1.4.1)
       ethon (>= 0.9.0)
     unicode-display_width (1.8.0)
-    webrick (1.7.0)
+    webrick (1.8.1)
     yell (2.2.2)
-    zeitwerk (2.6.0)
+    zeitwerk (2.6.12)
 
 PLATFORMS
   ruby
@@ -99,4 +121,4 @@ DEPENDENCIES
   webrick (~> 1.7)
 
 BUNDLED WITH
-   2.2.15
+   2.4.19

LICENSE.txt

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022 Matt Cone
+Copyright (c) 2024 Matt Cone
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -21,10 +21,6 @@ It can be helpful to preview changes on your computer before opening a pull requ
 
 See [this page](https://github.com/mattcone/markdown-guide/wiki/Markdown-tool-directory) for information about adding applications to the [Markdown tools directory](https://www.markdownguide.org/tools/).
 
-## Deployment
-
-Pull requests merged to the master branch are automatically deployed to the production website.
-
 ## License
 
 The content of this project itself is licensed under the [Creative Commons Attribution-ShareAlike 4.0 International license](https://creativecommons.org/licenses/by-sa/4.0/), and the underlying source code used to format and display that content is licensed under the [MIT license](LICENSE.txt).

Rakefile

@@ -8,13 +8,15 @@ task :test do
     :check_internal_hash => false,
     :enforce_https => false,
     :only_4xx => true,
-    :ignore_urls => ['https://ghost.org/',
+    :ignore_urls => ['https://emojipedia.org/',
+                    'https://ghost.org/',
                     'https://ghost.org/faq/using-the-editor/#using-markdown',
                     'https://get.todoist.help/hc/en-us/articles/205195102',
                     'https://twitter.com/settermjd/status/1126099562345705472',
                     'https://twitter.com/datamorgan/status/1109518506125451264',
                     'https://support.discord.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline-',
-                    %r{https://dpaste.com/*}],
+                    %r{https://dpaste.com/*},
+                    %r{https://www.reddit.com/*}],
     :url_swap => { %r{https://www.markdownguide.org} => '' },
     :typhoeus => {
       :ssl_verifypeer => false,

_basic-syntax/links.md

@@ -155,12 +155,39 @@ Markdown applications don't agree on how to handle spaces in the middle of a URL
         <code class="highlighter-rouge">
         [link](https://www.example.com/my%20great%20page)<br><br>
 
-        &lt;a href="https://www.example.com/my great page"&gt;link&lt;/a&gt;
+        &lt;a href="https://www.example.com/my great page"&gt;link&lt;/a&gt;<br><br>
         </code>
       </td>
       <td>
         <code class="highlighter-rouge">
-        [link](https://www.example.com/my great page)
+        [link](https://www.example.com/my great page)<br><br>
+        </code>
+      </td>
+    </tr>
+  </tbody>
+</table>
+
+Parentheses in the middle of a URL can also be problematic. For compatibility, try to URL encode the opening parenthesis (`(`) with `%28` and the closing parenthesis (`)`) with `%29`. Alternatively, if your Markdown application [supports HTML](#html), you could use the `a` HTML tag. 
+
+<table class="table table-bordered">
+  <thead class="thead-light">
+    <tr>
+      <th>✅&nbsp; Do this</th>
+      <th>❌&nbsp; Don't do this</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>
+        <code class="highlighter-rouge">
+        [a novel](https://en.wikipedia.org/wiki/<wbr>The_Milagro_Beanfield_War_%28novel%29)<br><br>
+
+        &lt;a href="https://en.wikipedia.org/wiki/<wbr>The_Milagro_Beanfield_War_(novel)"&gt;a novel&lt;/a&gt;<br><br>
+        </code>
+      </td>
+      <td>
+        <code class="highlighter-rouge">
+        [a novel](https://en.wikipedia.org/wiki/<wbr>The_Milagro_Beanfield_War_(novel))
         </code>
       </td>
     </tr>

_config.yml

@@ -43,4 +43,4 @@ kramdown:
   auto_ids:       true
   toc_levels:     1..3
 
-exclude: ["vendor", "Gemfile", "Gemfile.lock", "README.md", "LICENSE.txt", "Rakefile", "netlify.toml"]
+exclude: ["vendor", "Gemfile", "Gemfile.lock", "README.md", "LICENSE.txt", "Rakefile", "netlify.toml", "deploy.sh", "redirects.conf"]

_data/tools.yml

@@ -3,7 +3,7 @@
 
 headings:
   name: Headings
-  link: /basic-syntax#headings
+  link: /basic-syntax/#headings
 
 paragraphs:
   name: Paragraphs
@@ -15,27 +15,27 @@ line-breaks:
 
 bold:
   name: Bold
-  link: /basic-syntax#bold
+  link: /basic-syntax/#bold
 
 italic:
   name: Italic
-  link: /basic-syntax#italic
+  link: /basic-syntax/#italic
 
 blockquotes:
   name: Blockquotes
-  link: /basic-syntax#blockquotes-1
+  link: /basic-syntax/#blockquotes-1
 
 ordered-lists:
   name: Ordered Lists
-  link: /basic-syntax#ordered-lists
+  link: /basic-syntax/#ordered-lists
 
 unordered-lists:
   name: Unordered Lists
-  link: /basic-syntax#unordered-lists
+  link: /basic-syntax/#unordered-lists
 
 code:
   name: Code
-  link: /basic-syntax#code
+  link: /basic-syntax/#code
 
 horizontal-rules:
   name: Horizontal Rules