Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

InsightSoftwareConsortium/InsightJournal

Open more actions menu

Repository files navigation

The Insight Journal

The Insight Journal is an Open Access on-line publication covering the domain of medical and scientific image processing and visualization.

The unique characteristics of the Insight Journal include:

  • Open-access to articles, data, code, and reviews
  • Open peer-review that invites discussion between reviewers and authors
  • Support for continuous revision of articles, code, and reviews
  • Sustainable, reproducible research via Web3 technologies and the principles of verifiability, decentralization, and incentive engineering

Development

Prerequisites

  • Node.js 22+
  • pnpm

Installation

pnpm install

Build Commands

Command Description
pnpm run dev Start development server
pnpm run build Build site (uses cache if available, network fallback)
pnpm run build:full Prefetch all articles then build (recommended for production)
pnpm run preview Preview production build

Prefetch System

The site uses a cache-first architecture for robust, offline-capable builds. Articles are prefetched from the DeSci network and cached locally.

# Prefetch all articles (skips already cached)
pnpm run prefetch

# Force re-fetch all articles
pnpm run prefetch:force

# Verbose output with detailed logging
pnpm run prefetch:verbose

Cache location: ./cache/

  • cache/myst/ - Article JSON data
  • cache/pdfs/ - PDF files
  • cache/downloads/ - Download manifests
  • cache/thumbnails/ - Article thumbnails

The prefetch script includes:

  • Exponential backoff with jitter (1s → 30s max)
  • Up to 5 retries per request
  • Detailed error codes (E100-E999) for debugging
  • Concurrent fetching (4 parallel requests)

Dependency Notes

The pnpm.overrides in package.json forces katex to v0.16.27 to fix an ESM compatibility issue with the older version bundled in myst-transforms.

Contributors

Morty Proxy This is a proxified and sanitized view of the page, visit original site.