Inside.Java

For Authors

• install JDK 23 and a recent Maven (3.8.x is confirmed to work)
• if you don't like IDEs:
  • run mvn compile
  • to generate the site, run mvn exec:exec
  • to safely regenerate the site, run mvn clean compile exec:exec
  • launch a web server in target/site
• if you do like IDEs:
  • import the project into your IDE
  • fight with it until it understands that you're using JDK 23 with preview features
  • to generate the site, create a run configuration named "Build" with the program argument build
  • to get a live preview of what you're doing, create a run configuration named "Develop" with the program arguments develop --pureTemplates --sources src/main/java and launch it
  • go to https://localhost:8000
• to write an article:
  1. create a new file in _posts with a name that matches YYYY-MM-DD-topic
  2. add the following frontmatter:

     ---
     layout: post
     title: "$LONG_TITLE"
     stickyTitle: "$SHORT_TITLE"
     author: ["$YOUR_NAME"]
     type: text
     tags: ["$TAGS"]
     excerpt: "$SUMMARY"
     ---

  3. if the date in the file is in the future, see it appear in the first spot on the landing page
  4. click it, observe the Ginevra bug, restart "Develop" and refresh the browser
  5. edit the markdown and watch the preview-on-save in the browser