- Pelican 3.3
- ghp-import
- Markdown 2.3.1
Pelican's GETTING STARTED page is a good place to learn about the basics of Pelican (installation, project skeleton, development cycle, etc.).
git clone ssh://[email protected]/buddycloud/buddycloud.com.git
# install Pelican and dependencies
cd buddycloud.commake serveIf you want the server to autoreload whenever a file change, you can instead do:
make devserverView at http://localhost:8000
<repo>
fabfile.py
develop_server.sh
Makefile
README.md
pelicanconf.py (development configuration)
publishconf.py (production configuration)
output
<generated files - published to gh-pages branch>
content
pages
<website page files>
pelican-bootstrap3
<website theme>
To just generate a new version (without starting up a local webserver) just do:
make html
Files are updated to the gh_pages branch
make githubview the updates on http://buddycloud.com
We have developed several markdown extensions to fit our needs.
Our newly defined Markdown extension for creating Bootstrap Togglable tabs.
Since Bootstrap requires two HTML elements to compose Tooglable tabs, we also decided it would be easier to implement the transformation if the new Markdown syntax also contained two sections, as follows:
There's the Tab Key declaration section and the Tab Content declaration section.
Tab Key declaration sections must be surrounded by the following lines:
{@
@}
And each line amidst those will contain a Tab Key declaration and should be as follows:
{@[ KEY ]} where KEY can be any character
Important: you need to specify one of the Tab Key declarations to be the active one. To do so, you insert an $ sign before the enclosing brackets, as follows:
{@$[ ACTIVE_KEY ]}
Tab Content declaration sections must be surrounded by the following lines:
{{@
@}}
And each block of lines amidst those will contain a Tab Content declaration. Remember, it is a block of lines. That block of lines must be surrounded by the following lines:
{{@[ KEY ] where KEY must match a key declared at Tab Key declarations
/@}}
Important: The Tab Key declaration that will be automatically active must have a $ sign before the enclosing brackets:
{{@$[ ACTIVE_KEY ]
The active KEY must match the active KEY ofthe Tab Key declarations section.
The lines amidst those will be the content of your tabs. Feel free to use any markup syntax there.
Example Usage:
{@
{@[KEY]}
{@[KEY2]}
... (denoting multiple declarations in between)
{@[KEYn]}
@}
{{@
{{@$[KEY]
...
Your content for this tab
...
/@}}
{{@[KEY2]
...
Your content for this tab
/@}}
... (denoting multiple declarations in between
{@[KEYn]
...
Your content for this tab
...
/@}}
@}}
A new Markdown extension for writing Sequence Diagrams using the js-sequence-diagrams library.
All it does in fact is merge the js-sequence-diagrams syntax into the existing Markdown syntax, handling potential conflicts between the two.
We have the following restrictions upon the original js-sequence-diagrams syntax: definitions of sequence diagrams must not have black lines in between - the blocks of lines in between those blank lines will be understood as separate sequence diagram definitions.
For example:
A->B: Message
Note right of B: "B is receiving Message"
B-->A: Message back
will not render a single sequence diagrams with the two messages specified. Instead, there will be two sequence diagrams, each with one of the messages and the first one containing the note on the right of B. To reach this result, the definition should be as follows:
A->B: Message
Note right of B: "B is receiving Message"
B-->A: Message back
IMPORTANT: There must two blank lines, one before the sequence diagram block and another afterwards, separating the sequence diagram definition from other markup in the text.
Exports from Omnigraffle on OS X.
pip install omnigraffle-image-export
omnigraffle-export -f png buddycloud.com-diagrams.graffle ~/Documents/src/buddycloud.com/buddycloud-theme/static/img/diagrams
Coming soon.