No description
Find a file
2024-06-11 18:27:17 +02:00
public Add public dir 2024-06-10 21:26:27 +02:00
src Make survey class global available 2024-06-11 18:27:17 +02:00
create-core.lisp Quit after core image is build 2024-06-01 11:39:45 +02:00
dev.metalisp.survey.asd Move files 2024-06-10 18:20:03 +02:00
Dockerfile Add example dockerfile 2024-06-01 10:55:35 +02:00
LICENSE Add LICENSE information 2024-06-02 22:55:58 +02:00
package.lisp Just start the app 2024-06-09 18:40:24 +02:00
quicklisp-install.sh Shell script to install quicklisp 2024-06-01 10:55:18 +02:00
README.md Export README.md 2024-06-09 18:42:14 +02:00
README.org Just start the app 2024-06-09 18:40:24 +02:00
run-server.lisp No need to load package 2024-06-01 11:40:59 +02:00
run-server.sh Update run-server shell script 2024-06-01 11:40:46 +02:00

Table of Contents

  1. dev.metalisp.survey
    1. Introduction
    2. Dependencies
    3. Mailing list
    4. Issue tracker
    5. News Feed
    6. Installation instructions
      1. 1. Install a Common Lisp implementation
      2. 2. Set up ASDF
      3. 3. Organize the project directory
      4. 4. Configure ASDF to find the project
      5. 5. Load the project
      6. 6. Run the project
      7. Optional: Example Initialization in .sbclrc
    7. License

dev.metalisp.survey

Introduction

I am developing a simple web application in Common Lisp that facilitates the execution of the System Usability Scale (SUS) questionnaire. This app allows users to easily conduct usability evaluations by presenting the standard SUS questions and collecting responses. The goal is to streamline the process of gathering and analyzing usability feedback.

Dependencies

Mailing list

Issue tracker

News Feed

Installation instructions

1. Install a Common Lisp implementation

  • Ensure you have a Common Lisp implementation installed. Common options include SBCL (Steel Bank Common Lisp) and CCL (Clozure Common Lisp). You can download and install them from their respective websites:

2. Set up ASDF

  • ASDF is typically bundled with modern Lisp implementations. However, if its not present, you can download it from ASDFs repository.

3. Organize the project directory

  • Place the dev.metalisp.survey project in the ~/common-lisp directory. Ensure the directory structure looks like this:

    ~/common-lisp/
      └── dev.metalisp.survey/
          ├── dev.metalisp.survey.asd
          └── src/
              └── app.lisp
    

4. Configure ASDF to find the project

  • Open your Common Lisp REPL and run the following commands to set up the ASDF central registry:

    ;; Ensure ASDF is loaded
    (require :asdf)
    
    ;; Add ~/common-lisp to the ASDF central registry
    (push #p"~/common-lisp/" asdf:*central-registry*)
    

5. Load the project

  • In your REPL, load the project by running:

    (asdf:load-system :dev.metalisp.survey)
    

6. Run the project

  • After loading the system, you can run the main function or entry point of the project. ml-survey:start, you would execute:

    (ml-survey:start)
    

Optional: Example Initialization in .sbclrc

To make the ASDF configuration persistent across REPL sessions, you can add the setup to your .sbclrc file:

  1. Edit .sbclrc

    • Open (or create) the .sbclrc file in your home directory and add the following lines:

      (require :asdf)
      (push #p"~/common-lisp/" asdf:*central-registry*)
      
  2. Reload SBCL

    • The next time you start SBCL, it will automatically include the ~/common-lisp directory in the ASDF central registry.

License

MIT