Update Theme

Breaking Changes#

v4.0.3#

• Change footer registration config to links. This will give you more flexibility to add more links or other information:

  1
  export const theme: ThemeUserConfig = {
  2
    footer: {
  3
      links: [ // [!code highlight:12]
  4
        {
  5
          title: 'Moe ICP APTX4869',
  6
          link: 'https://icp.gov.moe/?keyword=APTX4869',
  7
          style: 'text-sm' // Uno/TW CSS class
  8
        },
  9
        {
  10
          title: 'Site Policy',
  11
          link: '/terms/list',
  12
          pos: 2 // position set to 2 will be appended to copyright line
  13
        }
  14
      ]
  15
    }
  16
  }

v4.0.2-beta#

• Considering move tools icons to new path like src/assets/tools/, this may help user know which ones are relevant to tools.

• Change links applyTip to custom array style:

  1
  export const integ: IntegrationUserConfig = {
  2
    links: {
  3
      applyTip: [
  4
        { name: 'Name', val: theme.title }, // [!code highlight:4]
  5
        { name: 'Desc', val: theme.description || 'Null' },
  6
        { name: 'Link', val: 'https://astro-pure.js.org/' },
  7
        { name: 'Avatar', val: 'https://astro-pure.js.org/favicon/favicon.ico' }
  8
        // You can also add more fields
  9
      ]
  10
    }
  11
  }

• Add env BUN_LINK_PKG, set this to true where automatically refer the package astro-pure in path packages/pure instead of node_modules/astro-pure. This may help user to develop the theme or change code for them (may not be recommended for production).

• Change CSS framework to UnoCSS. Will affect unocss.config.ts & typography classname setting.

v4.0.1-beta#

• Change svg deliver import to custom import svg element. This will affect using component for ToolSelection. You should change:

  (Optional) Move icons to new path like src/assets/icons/

  Then change using code (default at src/pages/about/index.astro)

  1
  <ToolSection
  2
    tools={[
  3
      {
  4
        name: 'Arch Linux',
  5
        description: 'Linux Distribution',
  6
        href: 'https://archlinux.org/',
  7
        iconPath: 'archlinux' // [!code --]
  8
        icon: import('@/assets/icons/archlinux.svg?raw') // [!code ++]
  9
      }
  10
    ]},
  11
  />

• This change import a new component Svg. See User Components #Svg Loader for usage.

v4.0.0-alpha#

• Move all components, types and utils that are reused to new npm packages astro-pure. Affected components are included in . Import method is also changed:

  1
  import { Button } from '@/components/user' // [!code --]
  2
  import { Button } from 'astro-pure/user' // [!code ++]

• New format config file src/site.config.ts. There will be zod schema to validate the config file, and use of config will be changed to:

  1
  import { siteConfig } from '@/site-config' // [!code --]
  2
  import config from '@/site-config' // [!code ++]
  3
  // Or if you want to use the config that is after processed or transformed
  4
  import config from 'vertual:config' // [!code ++]

• Built-in astro config supported. package astro-pure will automatically config some integrations like unocss/astro, @astrojs/mdx, @astrojs/sitemap, also with some rehypePlugins and remarkPlugins.

• Change search engine to pagefind ↗, mainly because Astro v5 will not allow getting collection data directly from client (that is core working mode of Fuse.js search engine).

• Change some BaseHead tags config to src/site.config.ts.

v3.1.4#

• Move config siteConfig.content.typographyProse to integrationConfig.typography.class in src/site.config.ts.

• Move advanced components to src/components/advanced. Affected components are included in Advanced Components. Import method is also changed:

  1
  import LinkPreview from '@/components/LinkPreview.astro' // [!code --]
  2
  import { LinkPreview } from 'astro-pure/advanced' // [!code ++]
  3
  
  4
  <LinkPreview href='https://www.cloudflare.com/' />

• Move Substats config to related page src/pages/about/index.astro.

• Change Github Card component to GithubCard in src/components/advanced. See Advanced Components #Github Card ↗ for usage.

• Move Links Logbook to src/site.config.ts. See Friend Links #Basic Configurations.

v3.1.3#

• Move user components to src/components/user. Affected components are included in User Components. Import method is also changed:

  1
  import Button from '@/components/Button' // [!code --]
  2
  import { Button } from 'astro-pure/user' // [!code ++]

• Replace remark-github-blockquote-alert plugin to component Aside. Check User Components #Aside to know how to migrate.

v3.1.2 (pre-release)#

• Move some configuration items like telegram, walineServelURL to new structure in src/site.config.ts.

v3.1.1#

• Move the internal parts in the src/utils to src/plugins.
• Modify the configuration file astro.config.ts to astro.config.mjs.
• Update ESLint to latest version and migrate configuration file .eslintrc.js to eslint.config.mjs.
• Modify the prettier.config.js to prettier.config.mjs.

v3.1.0 (pre-release)#

• Change common content markdown formatter coverImage to heroImage. You need to modify all your markdown files to replace coverImage with heroImage.

v3.0.9#

A stable version.

Pending update…

Update Method#

Rebase#

If you create a new project using fork, you can just rebase the theme repository to the latest version.

Merge Manually#

As there’s not the same git history, you might need to merge the theme repository to your project manually.

A soluable way for Windows user is using tool WinMerge ↗.

A filter list here may be helpful:

1
## This is a directory/file filter template for WinMerge
2
name: Astro Theme Pure
3
desc: Diff for Blog v.s. Astro Theme Pure
4

5
## Select if filter is inclusive or exclusive
6
## Inclusive (loose) filter lets through all items not matching rules
7
## Exclusive filter lets through only items that match to rule
8
## include or exclude
9
def: include
10

11
## Filters for filenames begin with f:
12
## Filters for directories begin with d:
13
## To exclude some of the files that match the f: pattern, specify f!:
14
## To exclude some of the folders that match the d: pattern, specify d!:
15
## (Inline comments begin with " ##" and extend to the end of the line)
16

17
### Front-end files ###
18
d: \\\.git$
19
d: \\node_modules$
20

21
# Astro cache
22
d: \\\.vercel
23
d: \\\.astro
24

25
### Theme dev ###
26
d: ^\\packages$
27
d: ^\\preset$
28
d: ^\\test$
29
f: ^LICENSE$
30
f: ^README\.md$
31
f: ^README-zh-CN\.md$
32
f: ^CODE_OF_CONDUCT\.md$
33

34
# Project
35
f: ^bun\.lockb$
36
f: \.code-workspace$
37
f: ^ignore\.md$
38

39
### Astro theme pure ###
40
# Static
41
d: ^\\public\\favicon$
42
f: ^public\\links\.json$
43
f: ^public\\images\\social-card\.png$
44

45
# Assets
46
f: ^src\\assets\\avatar\.png$
47
d: ^\\src\\assets\\projects$
48
d: ^\\src\\assets\\tools$
49

50
# Content
51
d: ^\\src\\content\\blog$
52
d: ^\\src\\content\\docs$
53
d: ^\\src\\pages\\docs$
54
f: ^src\\pages\\terms\\.*\.md$
55

56
### Blog ###
57
# Your own files