Publishing - Hacker's way to publishing(blogging)
Hi! Welcome to my personal publishing platform.
Part one - The old solutions
###Project description Use markup language (Markdown/Textile) to writing, write code and use jekyll(Ruby) to generate static webpage, use git to sync data and do version control, use github as web host, its all open source tools, and it become extremely powerful after the combination.
###Design - Old (Jekyll) Website Architecture
|--config.yml
|--CNAME
|-- includes
|-- layouts
|-- posts
|-- static
|-- site
|--about.html
|--index.html
|--search.html
|--resume.html
###Data storage, Index and Sitemap
Post named like DATE-NAME, and ordered by date, example: 2013-03-07-Hacker's-way-of-publishing.
Index and Site mind map is the job which I haven't find a tools can solve it simple and easily, still working on it.
###Implement - how to use Jekyll build a blog
Install ruby, RubyGems Jekyll install at Github
.
.
Markdown.pl: Generate markdown file to static HTML.
###Conclusion & Problem
Jekyll is not what exactly I want, she's job is much more than the script "Markdown.pl", the whole procedure to use Jekyll is a little bothering, and the data storage is not what I want.
So, the conclusion I got from this project is that Markdown/Textile is good, Git is good, Github is good, but Jekyll is not what exactly I want, so, what I need is a tools to index and map, like C in "MVC" model, however, this project let me learn a lot about web development, I need do it again from scratch, first is decompose the Framework - Jekyll, figure out how it designed and implemeneted, then I can use some part of it to build my tools.
By the way, Markdown have a very bothering issue, you must put two "space" at the end of sentence to make a paragraph, still unconfortable, and no spell checking.
###Reference
Part two - The new project to build a tools-set meet my need
###Purpose - The way I want which noting existed can meet my need
Simple publishing - With the help of Jekyll, Git, and Github, the publishing procedure is extremly simple, I just need excute one commond, the new article will be generated into HTML and upload to my remote server, then you can see it on the website.
Simple architecture - I think a personal publishing website don't need and shouldn't need involed database and PHP (Professional Hypertext Preprocessor Language), static HTML is perfect, search function can use Google, she's the best. So, my way, easy to build, easy to maintain, less CPU and storage cost, reduce lots of page transmission and load time, clear and simple.
Offline editing & Auto syncing - I can modify any article I wrote before whether there is Internet access or not, because all data is on my local computer, and after edit, all changes I had made is sync to my website on remote server. (Details: I modified many articles which data stored in files and markup by Markdown or Textile, after the command excuted, all HTML files will be regenerated, the time is very fast, then the new HTML files will be sync to remote server, so the website is the latest version.)
Enjoyable writing - With the help of Markdown and Textile, the writing/editing progress has become very enjoyable, I can fully focus on writing, if I want mark text with formatted form, I don't need to move my hand off the keyboard to find the mouse, I just mark it with text (Markdown or Textile).
Data Free - All the data and information which is produced by you is in your hand, you can do whatever you want to.
Clean - I want my article webpage have just my content, nothing more, no navigative bar, no categories, no tags, no comments, they should be in post page, they should be in Index page or Homepage, post page just content, clearn to read, concentrate to read, simple to use.
Backup - Meantime, due to the fact of data is both on local computer and remote server, and synced via git, a backup function is archived accidently, I can backup my local data info external drive, and I can backup my remote server data into other cloud service.
###Design - New website architecture
|-- .git
|-- images
|-- javascripts
|-- statics
|-- stylesheets
|--site-file
|---.gitignore
|---CNAME
|---index.html
|--hobby.html
|--interest.html
|--information-source.html
|--resume.pdf
|---jianli.html
|---jianli2.html
|--project.html
|--skills.html
|--tools.html
|--scripts
|---generate.sh
|----convert.sh
|---up.sh
|---sitemap.sh
###Explantion
- index.html: Navigation page.
- image folder: Contain the image used in this site.
- javascripts folder: Contain the javascript used in this site.
- statics folder: The location of all generated static html page.
###Code Highlight