главная|main page

состояние|status

блог|blog

файлы|files

программы|software

summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCarlos Fenollosa <carlos.fenollosa@gmail.com>2013-12-23 21:01:01 +0100
committerCarlos Fenollosa <carlos.fenollosa@gmail.com>2013-12-23 21:01:01 +0100
commit9f07bdbc3d41c4424c202ea755d83496b4e36a8a (patch)
tree1a3ebd6902bd65c3b3355f292fe37b0af7eac496
parent2559651d6e243cefe1bc924cae3c5fa048784fc0 (diff)
Extended the Markdown support info
-rw-r--r--README.md19
-rwxr-xr-xbb.sh7
2 files changed, 14 insertions, 12 deletions
diff --git a/README.md b/README.md
index 61fc6a5..7f5791f 100644
--- a/README.md
+++ b/README.md
@@ -34,6 +34,10 @@ Features
--------
- Simple creation and edition of the posts with your favorite text editor
+- **NEW** Markdown support via a third-party library (e.g.
+ [Markdown.pl](http://daringfireball.net/projects/markdown/)). Use
+ it via `./bb.sh post -m`. The third party library must support an invokation
+ like `markdown_bin in.html > out.md` as the code calls it that way.
- Post preview
- Save posts as drafts and resume later
- Transformation of every post to its own html page, using the title as the URL
@@ -41,11 +45,11 @@ Features
- Generation of an RSS file! Blog's magic is the RSS file, isn't it...?
- Generation of a page with all posts, to solve the index.html pagination problem
- Rebuilding the index files without the need to create a new entry
-- Optional comments, using the Disqus platform
+- By default, comments are delegated to Twitter. Can be configured for Disqus
- Google Analytics support
- Feedburner support
- Auto-generated CSS support
-- Headers, footers, and in general everything that a well-structured html file has
+- Headers, footers, and in general everything that a well-structured html file needs
- xhtml validation, CSS validation, RSS validation by the w3c
- Backup of the site every time you post
- Everything contained in a single 700-line bash script!
@@ -56,11 +60,6 @@ Read the CHANGELOG section of the script header for more updates
Future ideas
------------
-This software is still maintained, however, it can be considered finished. It has been used by many people
-and no bugs have been found.
-
-In the issues tab you can find some improvements; the main one is the addition of Markdown support for posts.
-This requires a Markdown parser, which would add more dependencies and/or increase the code length.
-
-If you happen to find a concise, elegant Markdown to HTML parser which runs in Bash and is portable, please
-comment on issue #14
+This software is still maintained, however, it can be considered more or less finished.
+It has been used by many people and no bugs have been found, but if you happen to find one,
+please report it.
diff --git a/bb.sh b/bb.sh
index 1ade8cf..d5d8d92 100755
--- a/bb.sh
+++ b/bb.sh
@@ -17,6 +17,7 @@
# and then rebuilds the index.html and feed.rss.
#
# Comments are supported via external service (Disqus).
+# Markdown syntax is supported via third party library (e.g. Gruber's Markdown.pl)
#
# This script is standalone, it doesn't require any other file to run
#
@@ -33,6 +34,8 @@
# There are many loops which iterate on '*.html' so make sure that the only html files
# on this folder are the blog entries and index.html and all_posts.html. Drafts must go
# into drafts/ and any other *.html file should be moved out of the way
+#
+# Read more: https://github.com/cfenollosa/bashblog
#########################################################################################
@@ -167,8 +170,8 @@ global_variables() {
date_format="%B %d, %Y"
date_locale="C"
- # Markdown location. Trying to autodetect by default, but change this
- # to the script location
+ # Markdown location. Trying to autodetect by default.
+ # The invocation must support the signature 'markdown_bin in.html > out.md'
markdown_bin="$(which Markdown.pl)"
}