⚒Anvil
Sign in

clo / cl-site public

merged

Markdown 54

opened by common-lisp.net

Erik Huelsmann (@ehuelsmann) on GitLab, 2018-10-14.

@mmontone, @tplotnikov, @vdardel: this branch adds markdown processing but generates a horrible TOC (and doesn't recognize the "Awesome" image/link).

The "Awesome" image/link might be a further improvement, but if we can convince this branch to create an acceptable ToC, I'd think we're a long way towards migrating a few important pages to Markdown.

The pages which I'd like to be Markdown most of all are the news page (which it already is) and the "project-intro" page, simply because I have to rewrite it completely. Which also explains why I'd like to have the ToC (project-intro uses that) but not so much about the "Awesome" image/link (project-intro doesn't use it; neither does news).

Closes #9.

0 commits, 0 files changed

common-lisp.net added 3 commits <ul><li>81affca5...089d3e20 - 2 commits from branch <code>clo:master</code></li><li>923b65ed - Add processing of Markdown input files</li></ul> [Compare with previous version](https://gitlab.common-lisp.net/clo/cl-site/merge_requests/54/diffs?diff_id=790&start_sha=81affca5dc296145cd3657c70003c732aa72995e)
Ccommon-lisp.net

Dave Cooper (@dcooper) on GitLab, 2018-10-15.

@ehuelsmann: Just curious - why are you changing back to :cl-markdown again?

Ccommon-lisp.net

Dave Cooper (@dcooper) on GitLab, 2018-10-15.

I guess you changed because :cl-markdown purports to handle tables of contents?

By the way, another approach to all this (after merging !53) could be to pre-pre-process any .md files into .lisp files, just writing the whole contents as a big string wrapped in that wmd macro (expanding said macro as needed) - then let the preprocess-lisp-files deal with it. That way we’d be running all markdown processing through one central (standardised) chokepoint. (admittedly though, you’d have to do something a little extra to deal with the headers - parsing them and writing out as a :headers-plist in the .lisp, only to have them get converted back to yaml style in the .html)

As far as the news.md - if you set that up as a .lisp file from the beginning instead of raw .md, you could use lhtml to insert the extra bits of HTML it needs, rather than inserting those hard-codedly in the processing function. That way the only special processing for news.html would be the generating of the newsbox.

Ccommon-lisp.net

Erik Huelsmann (@ehuelsmann) on GitLab, 2018-10-15.

The reason to change it back to cl-markdown is indeed the fact that it supposedly handles the ToC. This MR has been marked WIP, which means it can't be merged yet. The intent for that is to show what I'm currently working on, hopefully opening up some discussion and/or cooperation by bringing my work forward.

common-lisp.net added 1 commit <ul><li>c646e8f0 - Simplify build process by removing special handling of favicon</li></ul> [Compare with previous version](https://gitlab.common-lisp.net/clo/cl-site/merge_requests/54/diffs?diff_id=826&start_sha=923b65edba3a3da3201e3dd477794407687038e0)
common-lisp.net added 48 commits <ul><li>923b65ed...ae35ea62 - 47 commits from branch <code>clo:master</code></li><li>edfb4699 - Add processing of Markdown input files</li></ul> [Compare with previous version](https://gitlab.common-lisp.net/clo/cl-site/merge_requests/54/diffs?diff_id=829&start_sha=923b65edba3a3da3201e3dd477794407687038e0)
common-lisp.net added 6 commits <ul><li>edfb4699...001e40f8 - 5 commits from branch <code>clo:master</code></li><li>cdf2b6e4 - Add processing of Markdown input files</li></ul> [Compare with previous version](https://gitlab.common-lisp.net/clo/cl-site/merge_requests/54/diffs?diff_id=832&start_sha=edfb4699f26644a023c5815d9d76a1a9c33e33df)
common-lisp.net added 1 commit <ul><li>fae3c4cf - Replace underline-heading markings with hash-prefixes</li></ul> [Compare with previous version](https://gitlab.common-lisp.net/clo/cl-site/merge_requests/54/diffs?diff_id=833&start_sha=cdf2b6e48ca0132e30072387c870e8e87b5fed77)
common-lisp.net added 5 commits <ul><li>fae3c4cf...db5965bc - 3 commits from branch <code>clo:master</code></li><li>809db4fe - Add processing of Markdown input files</li><li>2ab9de72 - Replace underline-heading markings with hash-prefixes</li></ul> [Compare with previous version](https://gitlab.common-lisp.net/clo/cl-site/merge_requests/54/diffs?diff_id=834&start_sha=fae3c4cfdb1813a4deb3cd99cc3bca7c9cb141fe)
common-lisp.net added 2 commits <ul><li>39e2bea4 - Table of contents styles</li><li>26c3c9fa - Merge branch &#39;wip-markdown&#39; into &#39;markdown&#39;</li></ul> [Compare with previous version](https://gitlab.common-lisp.net/clo/cl-site/merge_requests/54/diffs?diff_id=836&start_sha=2ab9de72ddd39972112256a57ef65cda6fe23d8a)
common-lisp.net added 1 commit <ul><li>a81ba019 - Expand CSS ToC tweaks; Remove items from lisp companies ToC</li></ul> [Compare with previous version](https://gitlab.common-lisp.net/clo/cl-site/merge_requests/54/diffs?diff_id=839&start_sha=26c3c9fa9d031f87f0acf99812d1295ec33dfd60)
common-lisp.net unmarked as a **Work In Progress**
common-lisp.net added 1 commit <ul><li>105da5da - Move preprocessing into its own phase (and not as part of processing)</li></ul> [Compare with previous version](https://gitlab.common-lisp.net/clo/cl-site/merge_requests/54/diffs?diff_id=841&start_sha=a81ba01929974235728f721ccdb347dc6a2a2d6f)
Ccommon-lisp.net

Erik Huelsmann (@ehuelsmann) on GitLab, 2018-10-20.

@mmontone, @vdardel, @tplotnikov: please review this branch which adds Markdown processing and is supposed to close #9 and let me know what you think!

common-lisp.net added 1 commit <ul><li>8585f62c - Remove HTML versions of pages now maintained as Markdown</li></ul> [Compare with previous version](https://gitlab.common-lisp.net/clo/cl-site/merge_requests/54/diffs?diff_id=843&start_sha=105da5dad0b935a9bad60257ac3eb35efac0dbf4)
Ccommon-lisp.net

Mariano Montone (@mmontone) on GitLab, 2018-10-20.

Looks good enough to me. I can adjust a couple of things with the TOC later perhaps. And I would add a title to libraries page.

common-lisp.net added 1 commit <ul><li>0930c72a - Add titles to markdown pages</li></ul> [Compare with previous version](https://gitlab.common-lisp.net/clo/cl-site/merge_requests/54/diffs?diff_id=844&start_sha=8585f62ce1c6482ebebafeaddaec7dcd88db71c2)
Ccommon-lisp.net

Erik Huelsmann (@ehuelsmann) on GitLab, 2018-10-20.

Title comment incorporated.

We probably want more improvements on the current version indeed, however I think it's a very nice next step (without any real regressions, which is an important point IMO). I'll merge to master after more review or some time tomorrow if no further comments come up.

common-lisp.net changed the description
Ccommon-lisp.net

Tim Plotnikov (@tplotnikov) on GitLab, 2018-10-21.

I think thats fine.

common-lisp.net merged
common-lisp.net mentioned in commit 8fa6d5e6155a9d079d65bef9118d99ea807910d8

Sign in to comment.