Vue PDF Viewer Starter Toolkit in VitePress (SSR)

Welcome to the Vue PDF Viewer starter toolkit! This repository provides a comprehensive guide on how to use Vue PDF Viewer with VitePress via the Markdown and TypeScript. This repo showcases how Vue PDF Viewer can be integrated and rendered as part of a VitePress project.

Table of Contents

• Usage
  • Project Setup
  • Running the Example Project
• Examples

Usage

Project Setup

1. Clone the Repository: If you haven't already, clone the repository and navigate into the project directory.

   git clone https://github.com/your-username/starter-vpv-vitepress.git
   cd starter-vpv-vitepress

2. Install Dependencies: Install the necessary dependencies using npm, yarn, pnpm or bun

   npm install
   # or
   yarn install
   # or
   pnpm install
   # or
   bun install

Remark: For pnpm, there is a bit more configuration required which can be found here.

Running the Example Project

This repository includes an example project to demonstrate Vue PDF Viewer in action:

1. Start the Development Server: Use the following command to start the development server

   npm run docs:dev
   # or
   yarn docs:dev
   # or
   pnpm run docs:dev
   # or
   bun run docs:dev

2. Open in Browser: Open your browser and navigate to http://localhost:5173 (or the port specified in your terminal) to see the example project in action

Using the Vue PDF Viewer Component

Once the example project is running, you can explore the source code to see how the Vue PDF Viewer component is integrated. Here is a brief overview:

1. Import the component: Import the desired Vue PDF Viewer component into your md file

   import { useData, defineClientComponent } from 'vitepress'
   
   const VPdfViewer = defineClientComponent(() => {
     return import('@vue-pdf-viewer/viewer').then(({ VPdfViewer }) => VPdfViewer)
   })

2. Use the component in the template: Add the Vue PDF Viewer component to your template section

   <template>
     <div :style="{ width: '1028px', height: '700px'}">
       <VPdfViewer src="https://raw.githubusercontent.com/mozilla/pdf.js/ba2edeae/web/compressed.tracemonkey-pldi-09.pdf" />
     </div>
   </template>

3. Ensure the configuration: Add the following code to your .vitepress/config.ts

     import { defineConfig } from 'vitepress'
     
     export default defineConfig({
       // ...
       themeConfig: {
         // ...
       },
       vite: {
         ssr: {
           noExternal: ['pdfjs-dist', '@vue-pdf-viewer/viewer']
         }
       }
     })

Examples

For more examples, please refer to the docs/*.md files in this repository:

• Desktop View
• Mobile View

Remark: If you would like more examples, feel free open an issue.

For more configurations, please check the documentation site.

Meta

• Homepage: https://www.vue-pdf-viewer.dev
• Docs: https://docs.vue-pdf-viewer.dev

---

Thank you for using Vue PDF Viewer! We hope this toolkit helps you build amazing VitePress applications. If you have any questions or need further assistance on this example, please feel free to open an issue. Happy coding!