Add linting and convert a few files

phillc · phillc · commit a312ef600113 · 2025-09-09T20:09:25.000-04:00
diff --git a/.markdownlint.yml b/.markdownlint.yml
@@ -0,0 +1,3 @@
+MD013: false
+MD033: false
+MD038: false
diff --git a/.vscode/extensions.json b/.vscode/extensions.json
@@ -0,0 +1,5 @@
+{
+    "recommendations": [
+        "davidanson.vscode-markdownlint"
+    ]
+}
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -0,0 +1,11 @@
+{
+    "editor.codeActionsOnSave": {
+        "source.fixAll.markdownlint": true
+    },
+    "markdownlint": {
+        "lintWorkspaceGlobs": [
+            "**/*.{md,markdown}",
+            "!themes/**"
+        ]
+    }
+}
diff --git a/README.md b/README.md
@@ -1,2 +1,4 @@
+# README
+
 git submodule update --init
-hugo server --disableFastRender --buildDrafts --buildFuture
+hugo server --disableFastRender --buildDrafts --buildFuture
diff --git a/config/_default/markup.toml b/config/_default/markup.toml
@@ -14,6 +14,9 @@
 
 [highlight]
   noClasses = false
+  lineNos = true
+  anchorLineNos = true
+  guessSyntax = true
 
 [tableOfContents]
   startLevel = 2
diff --git a/config/_default/params.toml b/config/_default/params.toml
@@ -11,7 +11,7 @@ autoSwitchAppearance = true
 
 enableA11y = false
 enableSearch = false
-enableCodeCopy = true
+enableCodeCopy = false
 
 replyByEmail = false
 
diff --git a/content/posts/2008-06-25-purpose-website.markdown b/content/posts/2008-06-25-purpose-website.markdown
@@ -17,4 +17,3 @@ Yes I like to share, discuss, and debate many technological things, however anot
 This serves that purpose well.
 
 This blog is obviously not complete. I will finish it over time, but it does share the same code with another website, so any improvements will reflect on both.
-
diff --git a/content/posts/2008-07-05-making-django-version-control-friendly.markdown b/content/posts/2008-07-05-making-django-version-control-friendly.markdown
@@ -18,13 +18,12 @@ This file will go under version control.
 
 Now, in your settings.py, add the line
 
-{{< highlight python >}}
+```python
 from settings_local import *
-{{< / highlight >}}
+```
 
 (I added the line to the very bottom of my settings.py)
 
 So, now when a working copy of the project is grabbed, the person behind it can copy settings_local.py.dist to settings_local.py. Inside settings_local.py the environment's details are placed. This file will be ignored from version control.
 
 With this setup, you can add an application or middle ware to settings.py for easy distributing through version control, and it will not affect a workspace's local variables.
-
diff --git a/content/posts/2008-07-07-developed-directory-structure.markdown b/content/posts/2008-07-07-developed-directory-structure.markdown
@@ -17,12 +17,12 @@ Here is what I have come up with.
 
 - projects/  
 -- project 1/  
---- apps/      
+--- apps/
 ---- non reusable app 1/  
 ---- non reusable app 2/  
--- project 2/             
--- project 3/             
----apps                   
+-- project 2/
+-- project 3/
+---apps
 ---- non reusable app 3/  
 
 - common/  
@@ -44,9 +44,9 @@ Then for each virtual host, I add to the python path the projects folder, then r
 
 That works for apache, but then to get manage.py to work (it doesn't work because none of the python paths are set for it), I edit "/etc/environment" and add the line
 
-{{< highlight bash >}}
+```bash
 PYTHONPATH="/home/username/projects:/home/username/common:/home/username/external"
-{{< / highlight >}}
+```
 
 Bingo, now manage.py works.
 
diff --git a/content/posts/2008-07-08-structure-inside-project.markdown b/content/posts/2008-07-08-structure-inside-project.markdown
@@ -11,38 +11,40 @@ Previously, my template folder and my media folder were in different parent dire
 
 Inside my settings.py I have this:
 
-{{< highlight python >}}
+```python
 import os, sys
 PROJECT_ROOT = os.path.dirname(__file__)
-sys.path.insert(0, os.path.join(PROJECT_ROOT, 'apps')) 
-{{< / highlight >}}
+sys.path.insert(0, os.path.join(PROJECT_ROOT, 'apps'))
+```
 
 The first two lines figure out the directory that the settings.py lives in
 The third line inserts my apps folder to the python path (this works great with my [django directory structure](http://kapsh.com/blog/2008/jul/01/developed-directory-structure/))
 
 Now, the next step for me was to move my template and media directories around. My directory structure for a project is as follows:
 
+```text
 -project  
---media   
----css    
----js     
+--media
+---css
+---js
 ---images  
 --templates  
 ---application template directory 1  
 ---application template directory 2  
----base.html                         
---apps                               
----app1                              
----app2                              
---settings.py                        
+---base.html
+--apps
+---app1
+---app2
+--settings.py
 --settings_local.py
+```
 
 So as you can see, my templates folder is in the same directory as my settings.py. My media folder is too. In order to avoid making this a variable too:
 
-{{< highlight python >}}
+```python
 MEDIA_ROOT = os.path.join(PROJECT_ROOT, 'media')
 
 TEMPLATE_DIRS = (
      os.path.join(PROJECT_ROOT, 'templates'),
 )
-{{< / highlight >}}
+```
diff --git a/content/posts/2008-09-19-automatic-static-media-folder.markdown b/content/posts/2008-09-19-automatic-static-media-folder.markdown
@@ -7,15 +7,14 @@ Added another shortcut...
 I had a config variable in my settings_local file to specify where the media folder was in order to have django static serve it.
 
 This is much easier.
-<!--more-->>
 
 urls.py:
 
-{{< highlight python >}}
+```python
 if DEBUG:
     import os
     media_root = os.path.join(PROJECT_ROOT, 'media')
     urlpatterns += patterns ('',
         (r'^media/(?P<path>.*)$', 'django.views.static.serve', {'document_root': media_root}),
     )
-{{< / highlight >}}
+```
diff --git a/content/posts/2009-06-16-xserver-xorgconf-4850-x2-dual-monitor.markdown b/content/posts/2009-06-16-xserver-xorgconf-4850-x2-dual-monitor.markdown
@@ -12,31 +12,31 @@ Took many, many hours trying to finding this solution. I ended up being able to
 
 Here is what I did:
 
-{{< highlight bash >}}
+```bash
 dpkg-reconfigure xserver-xorg
 aticonfig --initial -f --adapter=all
 aticonfig --cfa --adapater=all
 aticonfig --add-pairmode=<your width>x<your height>+<your width 2>x<your height 2>
-{{< / highlight >}}
+```
 
 Also had to add
 
-{{< highlight bash >}}
+```bash
 Option "EnableRandR12" "false"
-{{< / highlight >}}
+```
 
 to each device section and
 
-{{< highlight bash >}}
+```bash
 EnableRandR12=Sfalse
-{{< / highlight >}}
+```
 
 to the [AMDPCSROOT/SYSTEM/DDX] section of /etc/ati/amdpcsdb ([source](http://ubuntuforums.org/showthread.php?p=7144148)) in order to disable RandR 1.2
 
 xorg.conf
 
-{{< highlight bash >}}
-
+<!-- markdownlint-disable MD010 -->
+```bash
 # xorg.conf (X.Org X Window System server configuration file)
 #
 # This file was generated by dexconf, the Debian X Configuration tool, using
@@ -127,7 +127,7 @@ Section "Screen"
 		Modes      "1280x1024_75.00"
 	EndSubSection
 EndSection
-{{< / highlight >}}
-
+```
+<!-- markdownlint-enable MD010 -->
 
 This probably is a solution for the 4870 X2, or any other X2 based board.
diff --git a/content/posts/2009-08-18-e-text-editor.markdown b/content/posts/2009-08-18-e-text-editor.markdown
@@ -6,13 +6,11 @@ date: 2009-08-18
 Was attempting to compile e-text editor on ubuntu 9.10 (yea yea, I know... my right to complain about broken packages disappears since its alpha) just to try it out, but had a sick number of errors ranging from "Cannot compile wxWidgets" to "Cannot compile WebKit".
 
 Finally, after trying multiple ways of compiling wxWidgets, I figured out the real error was
-<!--more-->>
 
-{{< highlight bash >}}
+```bash
 "./include/wx/gsocket.h:40: error: using typedef-name ‘GSocket’ after ‘class’"
-{{< / highlight >}}
-    
-    
+```
+
 So I applied a patch I found at [http://trac.wxwidgets.org/ticket/10883](http://trac.wxwidgets.org/ticket/10883) to the wxwidgets folder. and it suddenly worked.
 
 edit: I turned out that I also had to update glib. glib version 2.20 did it for me.
diff --git a/content/posts/2009-08-19-cucumber-selenium-and-authlogic.markdown b/content/posts/2009-08-19-cucumber-selenium-and-authlogic.markdown
@@ -7,78 +7,77 @@ slug: cucumber-selenium-and-authlogic
 I had some Issues with cucumber/selenium working properly with authlogic. After much searching, I've figured out how to get it all to work properly.
 
 I would get an error like:
-<!--more-->>
 
-{{< highlight bash >}}
+```Cucumber
 When I follow "Manage pages"                          # features/step_definitions/webrat_steps.rb:19
   ed out after 5000ms (Selenium::CommandError)
   /opt/local/lib/ruby/1.8/timeout.rb:62:in `timeout'
   /opt/local/lib/ruby/1.8/timeout.rb:93:in `timeout'
   (eval):2:in `/^I follow "([^\"]*)"$/'
   features/plain/admin_page.feature:8:in `When I follow "Manage pages"'
-{{< / highlight >}}
+```
 
 Initially, to setup authlogic to work with regular webrat tests, I had to put the following in my env.rb:
 
-
-{{< highlight ruby >}}
+```ruby
 require "authlogic/test_case"
 
 Before do
   activate_authlogic
 end
-{{< / highlight >}}
+```
 
 After getting it working with webrat, I decided I wanted to test some of my javascript and AJAX with selenium, so I followed [this guide](http://wiki.github.com/aslakhellesoy/cucumber/setting-up-selenium)
 
 The database_cleaner gem had to be added because you can't use
 
-{{< highlight ruby >}}
+```ruby
 Cucumber::Rails.use_transactional_fixtures
-{{< / highlight >}}
+```
 
 with selenium, so it had to be removed from the env.rb and placed in the plain.rb. As a result, this ended up in my enhanced.rb
 
-{{< highlight ruby >}}
+```ruby
   require 'database_cleaner'
   Before do
     # truncate your tables here, since you can't use transactional fixtures*
     DatabaseCleaner.strategy = :truncation
     DatabaseCleaner.clean
   end
-{{< / highlight >}}
+```
+
 and this ended up in my plain.rb
 
-{{< highlight ruby >}}
+```ruby
 require 'database_cleaner'
 DatabaseCleaner.strategy = :truncation
 DatabaseCleaner.clean
-{{< / highlight >}}
+```
 
 Originally, I had it just in my enhanced.rb as an After block instead of Before, but after further contemplation, I realized that if something goes terribly wrong with the selenium tests, then the database would have bad data in it... So might as well clean it before hand.
 
 Finally, my problem with authlogic + seleniu, was how I wrote my test. The way it was erroring out made it look like something completely different (the selenium timeout error), but after I watched it a couple times closely, I determined that the test was being sent to the next page before the "button press" was executed.
 
 Here is the beginning of my test that failed:
 
-{{< highlight ruby >}}
+```bash
   Scenario: Visit Add Page page
     Given I am logged in
     And I am on "the admin page"
     When I follow "Manage pages"
     And I follow "New Page"
-{{< / highlight >}}
+```
 
 With a little help from [a post on stack overflow](http://stackoverflow.com/questions/966052/cucumber-selenium-fails-randomly/966998#966998), I got it to work with the following:
 
-{{< highlight ruby >}}
+```ruby
 def user
   @user ||= Factory.create(:user)
 end
 
 def login
   user
-  fill_in "Email", :with => @user.email 
+  fill_in "Email", :with => @user.email
   fill_in "Password", :with => @user.password
   click_button "Login"
 
@@ -100,13 +99,12 @@ end
 When /^I login$/ do
   login
 end
-{{< / highlight >}}
+```
 
 Notice I had to add the if selenium line in order to get it to work in webrat.
 
 Something tells me there is a better way to do it... probably overriding the click_button method when selenium is loaded... but I don't know it well enough quite yet to venture that far, I'll probably try it soon though.
 
-
 Edit: oh, its a thing with webrat... but installing the newest version didn't fix it for me, then I actually read the [ticket...](https://webrat.lighthouseapp.com/projects/10503/tickets/226-not-waiting-for-page-load-with-selenium) I'll stick with my current solution for now.
 
 Edit2: Actually the issue is in the visit method, if you can believe that. click_button works fine, as it waits for the page to load before clicking, but the visit method is sent so fast, that because of the way my test is set up, we are sent to the next page either before the login button is pressed, or before the request gets a chance to process... I don't feel like investigating which one it exactly is, because the solution is the same... wait for the next page to load.
diff --git a/content/posts/2009-08-28-ruby-multi-dimensional-array-helper.markdown b/content/posts/2009-08-28-ruby-multi-dimensional-array-helper.markdown
@@ -6,9 +6,8 @@ date: 2009-08-28
 I needed something to help me get through a multi-dimensional array. So I extended the Array class.
 
 Grab expects an array of coordinates.
-<!--more-->>
 
-{{< highlight ruby >}}
+```ruby
 class Array
   def grab(position)
     value = self.fetch(position.first)
@@ -18,11 +17,12 @@ class Array
     raise(IndexError, "Multi Dimensional Array not deep enough")
   end
 end
-{{< / highlight >}}
+```
 
 Then I can do this:
 
-{{< highlight ruby >}}
+<!-- markdownlint-disable MD010 -->
+```ruby
 >> [[1,2,3],"asdf",[[11,22,33],5,6,7]].grab([2,0,0])
 => 11
 >> [[1,2,3],"asdf",[[11,22,33],5,6,7]].grab([2,0,2])
@@ -36,4 +36,5 @@ IndexError: Not an array.
 >> [[1,2,3],"asdf",[[11,22,33],5,6,7]].grab([1])
 => "asdf"
 >> 
-{{< / highlight >}}
+```
+<!-- markdownlint-enable MD010 -->
diff --git a/content/posts/2009-10-14-javascript-state-machine.markdown b/content/posts/2009-10-14-javascript-state-machine.markdown
diff --git a/content/posts/2010-06-06-v8-js-ubuntu-scons-error.markdown b/content/posts/2010-06-06-v8-js-ubuntu-scons-error.markdown
diff --git a/content/posts/2013-08-15-javascript-frameworks.markdown b/content/posts/2013-08-15-javascript-frameworks.markdown
diff --git a/content/posts/2015-02-06-skull-review/index.markdown b/content/posts/2015-02-06-skull-review/index.markdown
diff --git a/content/posts/2015-07-21-page-specific-javascript-with-the-rails-asset-pipeline.markdown b/content/posts/2015-07-21-page-specific-javascript-with-the-rails-asset-pipeline.markdown
diff --git a/content/posts/2019-09-04-single-page-app-refresh-strategy.markdown b/content/posts/2019-09-04-single-page-app-refresh-strategy.markdown
diff --git a/content/posts/2025-08-01-youre-building-products-not-just-tools.markdown b/content/posts/2025-08-01-youre-building-products-not-just-tools.markdown

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+MD013: false`
	`2`	`+MD033: false`
	`3`	`+MD038: false`
-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +{
 +    "recommendations": [
 +        "davidanson.vscode-markdownlint"
 +    ]
 +}
Original file line number	Diff line number	Diff line change
`@@ -17,4 +17,3 @@ Yes I like to share, discuss, and debate many technological things, however anot`
`17`	`17`	`This serves that purpose well.`
`18`	`18`
`19`	`19`	`This blog is obviously not complete. I will finish it over time, but it does share the same code with another website, so any improvements will reflect on both.`
`20`		`-`