pengzhanbo 385059f214
docs: update en docs (#708)
* docs: update en docs

* chore: tweak

* chore: tweak

* chore: tweak
2025-10-09 15:46:05 +08:00

2.5 KiB

title, icon, createTime, permalink
title icon createTime permalink
Repo Card octicon:repo-16 2025/10/08 21:11:56 /en/guide/components/github-repo-card/

Overview

The Repo Card component is used to display GitHub/Gitee repository information.

Usage

To use this component, you need to manually import the RepoCard component:

<!-- Import in markdown -->
<script setup>
import RepoCard from 'vuepress-theme-plume/features/RepoCard.vue'
</script>

<!-- After importing, you can use it in markdown -->
<RepoCard repo="pengzhanbo/vuepress-theme-plume" />

Register as a global component:

import RepoCard from 'vuepress-theme-plume/features/RepoCard.vue'
import { defineClientConfig } from 'vuepress/client'

export default defineClientConfig({
  enhance({ app }) {
    app.component('RepoCard', RepoCard)
  },
})

Global components can be used in any other markdown file:

<RepoCard repo="pengzhanbo/vuepress-theme-plume" />

Props

:::: field-group

::: field name="repo" type="string" required Repository address in owner/repo format :::

::: field name="provider" type="github | gitee" optional default="'github'" Repository platform. Currently only github/gitee are supported. :::

::: field name="fullname" type="boolean" optional Whether to display the full repository name.

The full repository name is owner/repo.

  • If the owner is an individual, the full repository name is not displayed by default, only repo is shown.
  • If the owner is an organization, the full repository name is displayed by default. :::

::::

Examples

Single Card

Input:

<RepoCard repo="pengzhanbo/vuepress-theme-plume" />

Output:

Multiple Cards

If you want to display multiple cards side by side in a compact way, you can use the CardGrid component.

Input:

<CardGrid>
  <RepoCard repo="vuepress/core" />
  <RepoCard repo="vuepress/ecosystem" />
</CardGrid>

Output:

Input:

<CardGrid>
  <RepoCard repo="pengzb/vuepress-theme-plume" provider="gitee" />
  <RepoCard repo="pengzb/vite-plugin-mock-dev-server" provider="gitee" />
</CardGrid>

Output: