Post-ELEC2 & Plugins

2016-06-14 20:37:00 +0000, 2 years and 2 months ago

ELEC-2 was hard-ish. That’s as much as I’m going to say about that.
Onto more fun things; plugins. Since this site is growing quite large I’ve decided I should start to streamline some things that usually took me a while, or make things look nicer. The first of these is the Kramdown markdown parser, I decided to move away from Maraku because it was slow, and didn’t have the features I wanted, this also means I have to now go through the process of changing the syntax of all my old posts.
In Kramdown, there’s a math engine called MathJAX, which basically turns LaTeX math notation into HTML readable text via some fancy JavaScript, as shown with $$\sum_{n=0}^\infty \frac{(a_1)_n\cdots(a_p)_n}{(c_1)_n\cdots(c_q)_n} \frac{z^n}{n!}$$, which gives:

Pretty cool, well that’s nothing compared to ditaa, I spent a lot of time making ascii diagrams for my college notes. I realised they aren’t very legible when they start getting complicated, ditaa (DIagrams Through Ascii Art) turns ascii diagrams into bitmap graphics, I was thinking about manually drawing the diagrams myself; but getting a perfect image would be impossible - so thanks again computers for saving me time. The syntax of turning ascii art into graphics is shown as:

             |      ^      |      ^ Q1   |      ^ Q2   |      ^ Q3
        +----+----+ | +----+----+ | +----+----+ | +----+----+ |
        | +--+--+ | | | +--+--+ | | | +--+--+ | | | +--+--+ | |
        | |  S  | | | | |  S  | | | | |  S  | | | | |  S  | | |
        +-+D   Q+-+-* +-+D   Q+-+-* +-+D   Q+-+-* +-+D   Q+-+-+
INPUT   --+CK ¬Q+-+ +---+CK ¬Q+-+ +---+CK ¬Q+-+ +---+CK ¬Q+-+ 
          |  R  |       |  R  |       |  R  |       |  R  |   
          +--+--+       +--+--+       +--+--+       +--+--+  
             |             |             |             |
LOGIC 0 -----+-------------+-------------+-------------+   

Which is rendered as:

removed ditaa

Now I see the implication of rendering several diagrams at once would create significant slowdown in page loading; which is why I’ve also decided (in the near future) to convert all college notes into smaller markdown files, much like this post, so that each section has it’s own file, which removes the need to display all sections at once, and render them once a menu is clicked, something like that. Doing this on Jekyll is easier than I imagined it would be, all I need to do is arrange the folders like:

    |   |
    |   +--_posts
    |   |
    |   +-- pictures
    |   | 
    |   +--_posts
    |   |
    |   +--pictues

And then do {\% for post in site.categories.notes.introductory_elec %}, which displays only the posts inside note/introductory_elec. All the files have been cleaned up and assorted into their respective directories, which makes management a lot easier now.

I readded Disqus too, as much as I dislike it, (having tried alternatives such as Isso) there simply isn’t anything currently out that allows the same thing to run off github-pages, oh well, atleast I managed to hide the footer of the iframe :)