npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

rollup-plugin-pages

v1.4.0

Published

Generate pages for webapp

Downloads

15

Readme

rollup-plugin-pages

Appveyor Version Downloads

Generate pages for webapp

Installation

npm install --save-dev rollup-plugin-pages

Usage

// rollup.config.js
import resolve from 'rollup-plugin-resolve'
import postcss from 'rollup-plugin-postcss'
import pages from 'rollup-plugin-pages'

export default {
	input: 'src/**/*.page.js',
	output: {
		dir: 'dist',
		format: 'amd',
		sourcemap: true,
		chunkFileNames: '[name].js'
	},
	plugins: [
    resolve(),
    postcss(),
		pages({
			dir: 'src',
      template: 'src/**/*.html',
      assets: ['src/assets/**']
		})
	]
}

Options

dir

Directory of the files

Type: string

Default: .

getPageId

Get id of page by html path or script path for match the html and script page

Type: (path: string) => string

Default: defaultPageId

getTitle

Get the title of the Specified page

Type: (id: string, path: string, pkg: { [k: string]: any }) => string | string[]

Default: defaultPageTitle

data

The data to bind on the compiler of page template

Type: any

Default: {}

template

The file parttern of page templates

Type: string

Default: join(dir, '**/*.html')

Compile the html by ejs with Context:

type Node = {
  title: string
  isPage: boolean
  isCategory: boolean
  pages?: Node[]
  children?: Node[]
  data: any
  pkg: Package
  walkHierachy: (enter: (page:Node, i:number, level:number)=>void, enter: (page:Node, i:number, level:number)=>void)
} & ({
  isPage: true
  id: string
  category: string[]
  page: string
  main: string
  header: { html: ()=>string }[]
  body: { html: ()=>string }[]
})

Example:

<!DOCTYPE html>
<html>
	<head>
		<meta charset="utf-8" />
		<title><%-title%></title>
		<%- header.map(h=>h.html()).join("\n\t\t") %>
	</head>
	<body>
		<%- body.map(h=>h.html()).join("\n\t\t") %>
		<script type="module" src="<%=main%>"></script>
	</body>
</html>

defaultTemplate

The default page template file

Type: string

Default: defaultPageTemplate

indexTemplate

The default index page template file

Type: string

Default: defaultIndexPageTemplate

assets

The file parttern of asset files

Type: (string | [string, (string | ((file: string) => string))?])[]

Default: []

server

Start the dev server

Type: boolean

Default: --server || Process.env.SERVER || rollup.watchMode

host

The host the server should listen on

Type: string

Default: --host || Process.env.HOST || "0.0.0.0"

port

The port the server should listen on

Type: number

Default: --port || Process.env.PORT || 8080

publicPath

Prefix all served files with a base path - e.g. serve from /static instead of /

Type: string

Default: ""

statics

Directories to serve static files from

Type: (string | {path: string, mount: string})[]

Example: pages({ statics: ["node_modules", {path: "test", mount: "."}] })

Default: []

Test

$ npm run test -- -w

Browser access : http://localhost:8080

License

MIT