In this post we’re going to have a look at how to create a simple Markdown powered blog with Go(lang) and gin. The blog will be able to look up a markdown file by title / filename, display a list of all blog posts, display a single blog post and give the user an error page when a link can not be found.
I recently wrote a couple of lines of Go again, mainly to see if I could write a cross platform clone of a two line shell script in Go (which actually makes it like 69 lines, but whatever).
So I wrote
mdclip to compile a file from markdown to HTML and put it in my clipboard (so I can paste it into my WordPress editor). Now you could scroll down to the comment box and go like
I’m trying Visual Studio Code at the moment and it’s a fun and fast atom alternative. One of my early annoyances was that I could not figure out how to make my MarkDown files wrap at the desired column width.
The trick apparently is to define the following settings:
Building your own tools makes you a better programmer. Seriously. There is nothing more satisfying than the feeling of pressing a single button instead of doing some annoying job that you used to do before by hand and YOUR program or script runs off to do all your work for you and then it says:
All done, task took 35 milliseconds
I’m currently tasked with the revision of some lecture material for basic HTML, CSS and PHP studies, so I thought I should give gitbook a try.
It’s a super sweet generator for creating an interactive website, a pdf and even epub from a loosely structured bunch of MarkDown files. You can imagine I love that. Continue reading “Creating books with Gitbook”
I’ve tried out Github’s Atom Editor shortly and I must say, they’ve come up with a pretty cool thing.
If you want to try it out, drop a comment, got 3 invites. At the moment only for Mac OS.
I have a quite terminal based workflow. I needed a way to copy the HTML version of a MarkDown file, straight to my clipboard. I love writing in my favourite text editor and I know a lot of other people do. They don’t want to bother with browser windows and their lack of key bindings and shortcuts. Projects like GHOST certainly make things easier for people like me, but I still have a majority of my blogs running WordPress. Continue reading “Copy MarkDown HTML to Clipboard from the Terminal / Shell”
I just wanted to show, quite quickly, what combination of windows I’ve been looking at a lot in the past months.
Git for Book writing
Git is amazing and I love it. I’ve been using it to write the book and to track my MarkDown source files. It’s been really easy to figure out when I did what, which is great when you’re dealing with several releases of software and you have to adjust things. It flags everything you change, everything you add, everything you take away. It’s nice to know that no matter what you do, you can always go back, you have a history in many small, but meaningful pieces.
Editing and Revisions
The editing was done in regular office software like Word and Libre Office/Open Office to correct mistakes, elaborate, clarify, etc.
It’s very reasonable and it’s been a struggle for me once in a while, because I have a hard time using desktop publishing and home office products. They crash, are buggy and just don’t offer a very good writing experience. This I think was the hardest part!
Poet is a great little node.js based project that allows you to start a blog in no time.
The description of the project by the author made me smile, so I’ll just quickly share this quote: Continue reading “Poet – a node.js blogging platform”
Retext is a great MarkDown editor for beginners and is widely available on the Linux platform.
Retext features that are most valuable to me are the display of files in split view and PDF export. It’s a solid editor for both MarkDown and plain text files and I think it’s great for beginners to check the MarkDown syntax right away.
Having said that, it’s much like Mou, my favourite MarkDown editor on Mac OS X, but not as feature rich.
Features I’d love to see in Retext
- custom CSS for PDF export
- theming support for the editor itself
- changing the “copy HTML” functionality so it only exports the body, without surrounding
Retext is available in most package managers, called
retext, so for Debian / Ubuntu you would run:
sudo apt-get install retext
On Arch Linux you currently have to remember to install
python-markdown with it, since it is not automatically required as a dependency:
sudo yaourt -S markdown-python retext