Connect a PortalJS catalog to a live CKAN instance through its API. The skill generates a small server-side client and updates search and dataset showcase pages to fetch CKAN data, while pre-rendering pages for static deployment.
中文简介正在准备中。当前显示英语简介。
Wire a scaffolded PortalJS portal to a CKAN backend over its API. Generates a tiny server-side fetch client (no runtime dependency) and feeds the /search catalog and /@namespace/slug showcases from CKAN instead of datasets.json. Use when connecting an existing portal to a live CKAN instance instead of a static manifest.
实测评分 未实测
查看安装方法安装前可以查看交给 AI 代理的指令内容。
Connect an existing portaljs-catalog portal to a live CKAN backend for the "decoupled /
any backend" path. The portal stops reading the static datasets.json manifest (and files
in /public/data/) and instead feeds its two data surfaces — the /search catalog and
the /@namespace/slug showcases — straight from a CKAN instance's REST API
(package_search / package_show) through a generated fetch client. Output is plain,
editable Next.js code with no runtime dependency — never @portaljs/ckan, whose bundle
wires React UI components to React 18 internals and crashes at import under the template's
React 19. Pages fetch CKAN server-side in getStaticProps/getStaticPaths, so the catalog
is pre-rendered at build time and the site can still be statically deployed. Run this right
after portaljs-new-portal to swap a freshly scaffolded portal's sample data over to CKAN.
portaljs-new-portal) with package.json, pages/,
datasets.json, pages/search.tsx, and pages/[owner]/[slug].tsx present.https://demo.dev.datopian.com.The canonical, full step-by-step workflow is
.claude/commands/portaljs-connect-ckan.md —
the single source of truth. Read and follow it when executing. Summary:
$ARGUMENTS — CKAN base URL (required), org filter (optional), group
filter (optional), portal directory (default .). If the URL is missing, interview the
user; never dead-end with a missing-input error.portaljs-catalog portal; if not, suggest
portaljs-new-portal instead of failing silently.package_search?rows=1, and validate each org
filter via organization_show; on failure, explain and re-prompt rather than dead-ending.lib/ckan.ts — a self-contained server-side fetch client wrapping
package_search and package_show, with DMS, ORG_FILTER, GROUP_FILTER, and
MAX_DATASETS as editable constants.pages/search.tsx to list datasets from package_search, linking each to
/@namespace/slug via datasetHref; leave pages/index.tsx untouched.pages/[owner]/[slug].tsx to pre-render one page per dataset via
getStaticPaths and fetch details with package_show, previewing tabular resources
through the existing Table component.npx next build; fix any error before reporting success.lib/ckan.ts (fetch wrapper client — no dependency added to package.json).pages/search.tsx (catalog reads package_search); pages/[owner]/[slug].tsx
(showcase reads package_show, overwritten to drop the datasets.json source).pages/index.tsx (still the static search-first landing page).t() (lib/i18n.ts), with the
keys added to locales/en.json and every other locales/*.json; npm run i18n:check
passes.npx next build succeeds and prints the static page count./search and /@namespace/slug are served from the CKAN backend; the
DMS env var can override the base URL at deploy time without editing code.| Symptom | Cause | Fix |
|---|---|---|
| Missing CKAN URL | User invoked the skill with no $ARGUMENTS | Ask for the base URL (and optional org/group filter); never error out. |
package_search request fails or times out | URL isn't a reachable CKAN root | Tell the user, ask them to confirm the URL, and retry. |
| Org filter not found | organization_show returns success: false | List valid orgs from organization_list and ask which one was meant. |
| Catalog renders empty after connecting | Wrong org/group filter name in lib/ckan.ts | Clear or correct the filter constants and rebuild. |
next build fails | Typo in substituted CKAN_URL or bad TypeScript edit | Print the log, fix the first error, and re-run before reporting success. |
<Table> fails to load a resource | CKAN resource host blocks CORS | Note that the Download link still works; prefer datastore-backed resources. |
/portaljs-connect-ckan url=https://demo.dev.datopian.com
/portaljs-connect-ckan url=https://demo.dev.datopian.com org=my-org
/portaljs-connect-ckan url=https://data.example.gov group=education dir=./my-portal
.claude/commands/portaljs-connect-ckan.mdreferences/reference.mdportaljs-new-portal, portaljs-add-dataset, portaljs-deploy还没有评价。欢迎分享你的使用感受。
无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。
还没有评论。来写第一条吧。
Migrate an ArcGIS Hub open data site into a PortalJS catalog. The skill collects the inventory, exports and converts spatial and tabular data for publishing, uploads files to Cloudflare R2 through Git LFS, and produces a report comparing source and derived data.
中文简介正在准备中。当前显示英语简介。
Add a line, bar, area, pie, or scatter chart to the showcase for a dataset already registered in PortalJS. The skill creates a reusable Chart component and displays it in the dataset’s Views section using the existing data source.
中文简介正在准备中。当前显示英语简介。
Register a CSV, TSV, JSON, or GeoJSON source in an existing PortalJS portal. The skill adds it to the dataset catalog and routes local files or remote URLs so the catalog and showcase can display the data.
中文简介正在准备中。当前显示英语简介。
Generate DCAT catalog feeds for a PortalJS site so open data catalogs can harvest its datasets. The skill supports JSON-LD, Turtle, and RDF/XML formats, adds feed discovery, and checks conformance to selected profiles.
中文简介正在准备中。当前显示英语简介。
Prepare a vector geospatial dataset for a PortalJS portal by converting its coordinate system, creating a map-ready PMTiles file and a queryable GeoParquet file, and registering both with the original data for an automatically rendered showcase.
中文简介正在准备中。当前显示英语简介。
Add an interactive Leaflet map to a selected GeoJSON dataset’s PortalJS showcase. The skill can register a local or remote GeoJSON source, install the map dependencies, and render the map in the page’s Views section.
中文简介正在准备中。当前显示英语简介。