flux-markdown: new port

[xykong]

New port: aqua/flux-markdown

Description

FluxMarkdown is a macOS QuickLook extension for Markdown files. It provides rich previews directly in Finder (press Space) with support for:

• Mermaid diagrams (flowcharts, sequence, class, Gantt...)
• KaTeX math (inline and block)
• GitHub Flavored Markdown including Alerts
• Syntax-highlighted code blocks (40+ languages)
• Vega / Vega-Lite charts and Graphviz DOT diagrams
• Interactive table of contents
• YAML frontmatter display
• PDF and HTML export (Cmd+Shift+P / Cmd+Shift+E)
• Light / Dark / System themes
• Scroll position memory across files

Homepage: https://github.com/xykong/flux-markdown
License: GPL-3
Stars: 600+
Platforms: macOS 12+ (Monterey and later, darwin >= 21)
Architectures: Universal (x86_64 + arm64)

Port details

• Distributed as a signed and notarized DMG via GitHub Releases
• Uses use_dmg yes — no compilation required
• post-activate removes quarantine attribute, registers the QuickLook extension via pluginkit, and refreshes the QL daemon cache
• Livecheck via the github PortGroup (GitHub Releases tags)

Checklist

• Portfile follows MacPorts conventions (header, indentation, stanza order)
• platforms {darwin >= 21} (requires macOS 12 Monterey for App Extensions)
• supported_archs x86_64 arm64
• Checksums verified against the published DMG
• Livecheck handled by github PortGroup

[reneeotten]

MacPorts is a build-from-source package manager and strongly prefers not to install pre-build binaries.

Please change the port such that it builds the source instead of downloading a .dmg file.

[reneeotten]

ping @xykong - can this be changed to build from source?

[xykong]

Thank you for the review! I've updated the port to build from source.

What changed:

• Replaced use_dmg yes with a proper build {} phase using xcodebuild
• Uses use_xcode yes with ad-hoc signing (CODE_SIGN_IDENTITY='', CODE_SIGNING_REQUIRED=NO)
• Sparkle auto-updater is removed from this build — MacPorts manages updates via `port upgrade`

Why a custom source tarball instead of the GitHub auto-generated one:

The project uses XcodeGen to generate `.xcodeproj` from `project.yml` (xcodegen is not currently in MacPorts — see ticket #69285), and Vite/npm to build the TypeScript web renderer. Since neither tool is available in the MacPorts build sandbox, I publish a MacPorts-specific tarball alongside the DMG on each release:

• `FluxMarkdown-${version}-macports-source.tar.gz` — pre-generated `.xcodeproj` (Sparkle removed from `project.yml`), pre-built `web-renderer/dist`, and Sparkle stripped from Swift sources

This tarball is generated by scripts/create_macports_tarball.sh and automatically uploaded to each GitHub Release. The only dependency at install time is xcodebuild (via use_xcode yes).

Let me know if there are any other issues!

[reneeotten]

Thanks for making the changes @xykong !

Instead of manually specifying the build and destroot phase and use_configure, can one use the xcode PortGroup instead? That PortGroup is intended to support xcode-based projects with setting sensible defaults.
See: https://github.com/macports/macports-ports/blob/master/_resources/port1.0/group/xcode-1.0.tcl

[reneeotten]

Suggested change

	distname FluxMarkdown-1.31.402-macports-source
	distname FluxMarkdown-${version}-macports-source

use ${version} to avoid the need to change this line upon each update