Default Markdown Formatting in Pelican 3.7.1

Posted on 2017-10-12 17:05 in Blog • Tagged with blog

There are bunch of great resources for Markdown formatting. This post is primarily for my own benefit, as a quick reference on how to use the formatting for the handful that I use regularly.

Pelican Style Guide

Markdown Extensions

Basic Text Formatting

Style Syntax Example
Bold ** text ** text
Italic * text * text
Underline <u> text </u> text
Strikethrough <del> text </del> text

Headings

# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5

Heading 1

Heading 2

Heading 3

Heading 4

Heading 5

Links

Raw Link: https://www.google.com

https://www.google.com

Text Link

[Displayed Text](https://www.google.com)
Displayed Text

Text Link with Alt Text

[Displayed Text](https://www.google.com "alt text")
Displayed Text

Direct link

reference links Text [1]: https://www.google.com "google"

Tables

| Header Left | Header Right |
|---------------|--------------|
| Cell Left | Cell Right |

Header Left Header Right
Cell Cell Right

Code

Inline code is encased with back-ticks.

`in-line-code`

in-line-code

Code blocks are identified by three back-ticks, followed by the language for syntax formatting.

```java
public class Code {
public static void main(String[] args){
return;
}
}

```java
public class Code {
    public static void main(String[] args){
        return;
    }
}

No Formatting

  a <pre>  b </pre> c  

Continue reading

New Site Management Platform

Posted on 2017-10-04 16:00 in Blog • Tagged with blog

My blog has its genesis in 2010, almost 8 years ago. Early on, I was very active posting little tidbits of knowledge and interesting facts that I had learned. As time passed, I got wrapped up in other activities and posting to the blog fee by the wayside. Eventually, my most common action on the blog was logging in to reject spam comments and upgrade the Wordpress installation.

I had selected Wordpress early on because of the ease of management, and plefora of themes to choose from. As time passed, even that became neglected.

Recently, I received notice from my webhost that I had exceeded my storage allowance. I found this curious, as I had not made any changes in months. It turns out the problem was related to the size of the email boxes I didn’t know I had, and the auto-generated visitor status reports that were being made monthly. Clearing out all those unused stuff, I was surprised to learn I was still consuming over 30MB space simply with the Wordpress installation.

I decided it was about time I made a change on the blog. I wanted to eliminate the overhead of ensuring that Wordpress was up to date. Additionally, I wanted to shrink the installation size of the site on my host to further reduce the likelihood of running out of space against. Finally, I wanted to play with a new piece of technology.

I decided to move to a static content site, selecting Pelican as the generator of the content. Converting the data from Wordpress to Pelican was straightforward. A quick export from Wordpress, import into Pelican, and then massaging of the article metadata; everything was back up and running in a snap.

That being said, there are still a few activities I need to complete:

  • fix broken image links in old posts
  • find a theme that I like
  • consolidate and simplify tags and "slugs"
  • fix code links or host on GitHub (preferred)

Continue reading

A home at last!

Posted on 2010-03-31 22:35 in Blog • Tagged with blog

After many years adrift in the ocean of the Internet, my iceberg has finally run aground. That's right, I now have my vary own website. It has literally been years in the making. Over the past several years, I have put together a dozen or so small websites for fun. I wrote one for my anime group, Kitsune-Udon, the Agnostic club I was a member of while in college, a warehouse containing my anime collection, and several other small projects. In addition, I've also had two unsuccessful blogs from different providers.

Finally, I have a single place to collect all my various pieces of data. My plan is for this site to be a dump of everything that is me. I'll blog about my interests, discuss my current job happenings, share my thoughts with the rest of the software community, and hopefully gain a following which I can use to conquer the world. One subscriber at a time...


Continue reading