From 79e48a3dc933a4c547099a81b9b4b93658b6a841 Mon Sep 17 00:00:00 2001 From: Christopher Carpenter Date: Fri, 11 Sep 2015 00:37:48 -0500 Subject: [PATCH 1/5] Refactor menu/file structure This standardizes capitalization in the menu and categorizes things into more distinct categories that I hope are more helpful. Quite frankly we could use a web designer to give this kind of thing a once over, I'm a web developer :). --- _data/nav.yml | 41 ++++++++++--------- {env => ide}/cusp-setup.html | 0 {env => ide}/emacs-setup.html | 0 {env => ide}/slime-setup.html | 0 env/ide.html => ide/summary.html | 0 {env => implementations}/ccl-setup.html | 0 {env => implementations}/clisp-setup.html | 0 {env => implementations}/lispworks-setup.html | 0 {env => implementations}/sbcl-setup.html | 0 .../summary.html | 0 env/quicklisp.html => quicklisp.html | 0 11 files changed, 21 insertions(+), 20 deletions(-) rename {env => ide}/cusp-setup.html (100%) rename {env => ide}/emacs-setup.html (100%) rename {env => ide}/slime-setup.html (100%) rename env/ide.html => ide/summary.html (100%) rename {env => implementations}/ccl-setup.html (100%) rename {env => implementations}/clisp-setup.html (100%) rename {env => implementations}/lispworks-setup.html (100%) rename {env => implementations}/sbcl-setup.html (100%) rename env/lisp-system.html => implementations/summary.html (100%) rename env/quicklisp.html => quicklisp.html (100%) diff --git a/_data/nav.yml b/_data/nav.yml index eeac423..90ba22b 100644 --- a/_data/nav.yml +++ b/_data/nav.yml @@ -1,10 +1,9 @@ - title: "Home" href: "/" -- title: "quicklinks" +- title: "Quicklinks" href: "/quicklinks.html" - - title: "Initial" href: "/initial" subcategories: @@ -17,38 +16,40 @@ - subtitle: "ABCs" subhref: "/abcs.html" -- title: "examples" +- title: "IDE" + href: "/ide" + subcategories: + - subtitle: "Summary" + subhref: "/summary.html" + - subtitle: "Emacs" + subhref: "/emacs-setup.html" + - subtitle: "SLIME" + subhref: "/slime-setup.html" + +- title: "Libraries" + href: "/quicklisp.html" + +- title: "Examples" href: "/examples" subcategories: - subtitle: "Snippets" subhref: "/snippets.html" - - subtitle: "trotter" + - subtitle: "Trotter" subhref: "/trotter.html" -- title: "env" - href: "/env" +- title: "Implementations" + href: "/implementations" subcategories: - - subtitle: "IDE" - subhref: "/ide.html" - - subtitle: "Quicklisp" - subhref: "/quicklisp.html" + - subtitle: "Summary" + subhref: "/summary.html" - subtitle: "CUSP" subhref: "/cusp-setup.html" - - subtitle: "emacs" - subhref: "/emacs-setup.html" - - subtitle: "SLIME" - subhref: "/slime-setup.html" - -#- title: "Systems" -# href: "/env" -# subcategories: - subtitle: "Clozure CL" subhref: "/ccl-setup.html" - subtitle: "SBCL" subhref: "/sbcl-setup.html" - subtitle: "LispWorks CL" subhref: "/lispworks-setup.html" - - subtitle: "setup" - subhref: "/lisp-system.html" + - title: "Who?" href: "/about/" diff --git a/env/cusp-setup.html b/ide/cusp-setup.html similarity index 100% rename from env/cusp-setup.html rename to ide/cusp-setup.html diff --git a/env/emacs-setup.html b/ide/emacs-setup.html similarity index 100% rename from env/emacs-setup.html rename to ide/emacs-setup.html diff --git a/env/slime-setup.html b/ide/slime-setup.html similarity index 100% rename from env/slime-setup.html rename to ide/slime-setup.html diff --git a/env/ide.html b/ide/summary.html similarity index 100% rename from env/ide.html rename to ide/summary.html diff --git a/env/ccl-setup.html b/implementations/ccl-setup.html similarity index 100% rename from env/ccl-setup.html rename to implementations/ccl-setup.html diff --git a/env/clisp-setup.html b/implementations/clisp-setup.html similarity index 100% rename from env/clisp-setup.html rename to implementations/clisp-setup.html diff --git a/env/lispworks-setup.html b/implementations/lispworks-setup.html similarity index 100% rename from env/lispworks-setup.html rename to implementations/lispworks-setup.html diff --git a/env/sbcl-setup.html b/implementations/sbcl-setup.html similarity index 100% rename from env/sbcl-setup.html rename to implementations/sbcl-setup.html diff --git a/env/lisp-system.html b/implementations/summary.html similarity index 100% rename from env/lisp-system.html rename to implementations/summary.html diff --git a/env/quicklisp.html b/quicklisp.html similarity index 100% rename from env/quicklisp.html rename to quicklisp.html From b714f43ebf6a22d7872d20e5e8a8512b39123c0f Mon Sep 17 00:00:00 2001 From: Christopher Carpenter Date: Fri, 11 Sep 2015 01:01:56 -0500 Subject: [PATCH 2/5] Rename refactored ide folder/menu to ides --- _data/nav.yml | 13 +++++++++---- {ide => ides}/cusp-setup.html | 0 {ide => ides}/emacs-setup.html | 0 ides/lispworks-setup.html | 1 + {ide => ides}/slime-setup.html | 0 {ide => ides}/summary.html | 0 6 files changed, 10 insertions(+), 4 deletions(-) rename {ide => ides}/cusp-setup.html (100%) rename {ide => ides}/emacs-setup.html (100%) create mode 120000 ides/lispworks-setup.html rename {ide => ides}/slime-setup.html (100%) rename {ide => ides}/summary.html (100%) diff --git a/_data/nav.yml b/_data/nav.yml index 90ba22b..cf99889 100644 --- a/_data/nav.yml +++ b/_data/nav.yml @@ -16,8 +16,8 @@ - subtitle: "ABCs" subhref: "/abcs.html" -- title: "IDE" - href: "/ide" +- title: "IDEs" + href: "/ides" subcategories: - subtitle: "Summary" subhref: "/summary.html" @@ -25,6 +25,10 @@ subhref: "/emacs-setup.html" - subtitle: "SLIME" subhref: "/slime-setup.html" + - subtitle: "CUSP" + subhref: "/cusp-setup.html" + - subtitle: "LispWorks CL" + subhref: "/lispworks-setup.html" - title: "Libraries" href: "/quicklisp.html" @@ -42,14 +46,15 @@ subcategories: - subtitle: "Summary" subhref: "/summary.html" - - subtitle: "CUSP" - subhref: "/cusp-setup.html" - subtitle: "Clozure CL" subhref: "/ccl-setup.html" + - subtitle: "CLISP" + subhref: "/clisp-setup.html" - subtitle: "SBCL" subhref: "/sbcl-setup.html" - subtitle: "LispWorks CL" subhref: "/lispworks-setup.html" + - title: "Who?" href: "/about/" diff --git a/ide/cusp-setup.html b/ides/cusp-setup.html similarity index 100% rename from ide/cusp-setup.html rename to ides/cusp-setup.html diff --git a/ide/emacs-setup.html b/ides/emacs-setup.html similarity index 100% rename from ide/emacs-setup.html rename to ides/emacs-setup.html diff --git a/ides/lispworks-setup.html b/ides/lispworks-setup.html new file mode 120000 index 0000000..79c918e --- /dev/null +++ b/ides/lispworks-setup.html @@ -0,0 +1 @@ +../implementations/lispworks-setup.html \ No newline at end of file diff --git a/ide/slime-setup.html b/ides/slime-setup.html similarity index 100% rename from ide/slime-setup.html rename to ides/slime-setup.html diff --git a/ide/summary.html b/ides/summary.html similarity index 100% rename from ide/summary.html rename to ides/summary.html From 89673a42bfbca311e92a07fbfaf7f3dd09b7834a Mon Sep 17 00:00:00 2001 From: Christopher Carpenter Date: Fri, 11 Sep 2015 01:03:03 -0500 Subject: [PATCH 3/5] Fix links broken due to refactor --- index.html | 21 ++++++++------------- quicklinks.html | 8 ++++---- 2 files changed, 12 insertions(+), 17 deletions(-) diff --git a/index.html b/index.html index c02aa64..7f7dab3 100644 --- a/index.html +++ b/index.html @@ -1,27 +1,22 @@ --- layout: default --- - - -
-

Articulate Common Lisp

How to write Common Lisp in 2015 -
an initiation manual for the uninitiated

-
-
+

Dear Reader,

One of the key problems in onboarding developers to use modern Common Lisp is the vertical wall of difficulty. Things that are routinely problematic:

  • emacs use. Most people don’t use emacs.
  • Library creation. Putting together ASDF libraries and using them is a fairly horrid experience the first time.
    • -
  • Selection of Lisp system to use, along with an up-to-date discussion of pros and cons.
    • +
  • Selection of Lisp implementation to use, along with an up-to-date discussion of pros and cons.
  • Putting together serious projects is not commonly discussed.

This site is dedicated to handling these problems. My goal is to put together an introduction/tutorial for practicing professionals and hobbyists from other languages. People who want to get started with Lisp beyond just typing into a REPL. Right now, it feels like this information is less disseminated and much less centralized than it otherwise might be. It’s not intended to be a HOWTO for Common Lisp. That’s been covered quite well. But it is intended to be a HOWTO on how to put together a Lisp environment.

@@ -31,10 +26,10 @@

Dear Reader,

P.S.: feel free to contact me for anything you like.

diff --git a/quicklinks.html b/quicklinks.html index 00b23f3..d6bee63 100644 --- a/quicklinks.html +++ b/quicklinks.html @@ -7,13 +7,13 @@

Quick Links

Initial environment setup

Example code

Language Resource Recommendations

in no particular order

From ee8d803b3c82a68fcdff758edd6f2604bda91107 Mon Sep 17 00:00:00 2001 From: Christopher Carpenter Date: Fri, 11 Sep 2015 01:05:46 -0500 Subject: [PATCH 4/5] Re-order menu entries Order them roughly in the order that you'd use them being a novice, I think. --- _data/nav.yml | 33 ++++++++++++++++----------------- 1 file changed, 16 insertions(+), 17 deletions(-) diff --git a/_data/nav.yml b/_data/nav.yml index cf99889..895916a 100644 --- a/_data/nav.yml +++ b/_data/nav.yml @@ -16,6 +16,20 @@ - subtitle: "ABCs" subhref: "/abcs.html" +- title: "Implementations" + href: "/implementations" + subcategories: + - subtitle: "Summary" + subhref: "/summary.html" + - subtitle: "Clozure CL" + subhref: "/ccl-setup.html" + - subtitle: "CLISP" + subhref: "/clisp-setup.html" + - subtitle: "SBCL" + subhref: "/sbcl-setup.html" + - subtitle: "LispWorks CL" + subhref: "/lispworks-setup.html" + - title: "IDEs" href: "/ides" subcategories: @@ -30,9 +44,6 @@ - subtitle: "LispWorks CL" subhref: "/lispworks-setup.html" -- title: "Libraries" - href: "/quicklisp.html" - - title: "Examples" href: "/examples" subcategories: @@ -41,20 +52,8 @@ - subtitle: "Trotter" subhref: "/trotter.html" -- title: "Implementations" - href: "/implementations" - subcategories: - - subtitle: "Summary" - subhref: "/summary.html" - - subtitle: "Clozure CL" - subhref: "/ccl-setup.html" - - subtitle: "CLISP" - subhref: "/clisp-setup.html" - - subtitle: "SBCL" - subhref: "/sbcl-setup.html" - - subtitle: "LispWorks CL" - subhref: "/lispworks-setup.html" - +- title: "Libraries" + href: "/quicklisp.html" - title: "Who?" href: "/about/" From dde5b1bd7478f3b74d6959e0df35ae3e68b520e7 Mon Sep 17 00:00:00 2001 From: Christopher Carpenter Date: Fri, 11 Sep 2015 01:13:32 -0500 Subject: [PATCH 5/5] Move initial to project namespace --- _data/nav.yml | 4 ++-- index.html | 4 ++-- {initial => project}/abcs.html | 0 {initial => project}/basic-project.html | 0 {initial => project}/new-project.html | 0 quicklinks.html | 4 ++-- 6 files changed, 6 insertions(+), 6 deletions(-) rename {initial => project}/abcs.html (100%) rename {initial => project}/basic-project.html (100%) rename {initial => project}/new-project.html (100%) diff --git a/_data/nav.yml b/_data/nav.yml index 895916a..e84389e 100644 --- a/_data/nav.yml +++ b/_data/nav.yml @@ -4,8 +4,8 @@ - title: "Quicklinks" href: "/quicklinks.html" -- title: "Initial" - href: "/initial" +- title: "Starting a Project" + href: "/project" subcategories: - subtitle: "New Project" subhref: "/new-project.html" diff --git a/index.html b/index.html index 7f7dab3..97bd5c6 100644 --- a/index.html +++ b/index.html @@ -28,8 +28,8 @@

Dear Reader,

diff --git a/initial/abcs.html b/project/abcs.html similarity index 100% rename from initial/abcs.html rename to project/abcs.html diff --git a/initial/basic-project.html b/project/basic-project.html similarity index 100% rename from initial/basic-project.html rename to project/basic-project.html diff --git a/initial/new-project.html b/project/new-project.html similarity index 100% rename from initial/new-project.html rename to project/new-project.html diff --git a/quicklinks.html b/quicklinks.html index d6bee63..9f2a45f 100644 --- a/quicklinks.html +++ b/quicklinks.html @@ -5,10 +5,10 @@

Quick Links

-

Initial environment setup

+

Getting Started

Example code