Aller au contenu
StudioCMS Docs
Site principal

@studiocms/mdx

v0.2.0 GitHub npm Journal des modifications

Présentation

Section intitulée « Présentation »

Ce module d’extension active la prise en charge MDX dans StudioCMS.

Installation

Section intitulée « Installation »

  1. Installez le paquet à l’aide de la commande suivante :

    Fenêtre de terminal
    npm run studiocms add @studiocms/mdx

  2. Votre configuration StudioCMS devrait désormais inclure @studiocms/mdx :

    studiocms.config.mjs
    import { 
    function defineStudioCMSConfig(config: StudioCMSOptions): StudioCMSOptions
    A utility function to define the StudioCMS config object.
This function is used to define the optional StudioCMS
config object in the Astro project root. The expected file
name is studiocms.config.mjs. And it should be adjacent
to the Astro project's astro.config.mjs file.
    

    StudioCMS will attempt to import this file and use the default
export as the StudioCMS config object automatically if it exists.
    

    Using this function is optional, but it can be useful for IDEs
to provide better intellisense and type checking.
    @example 
    // studiocms.config.mjs
    import { defineStudioCMSConfig } from 'studiocms/config';
    

    export default defineStudioCMSConfig({
     dbStartPage: true,
     // ...Other Options
    })
    defineStudioCMSConfig     } from 'studiocms/config';
    import 
    function mdx(options?: MDXPluginOptions): StudioCMSPlugin
    Creates and configures the StudioCMS MDX plugin.
    @param ― options - Optional configuration options for the MDX plugin.
    @returns ― The configured StudioCMS plugin.
    @example 
    plugins: [
      studiocmsMDX({
        remarkPlugins: [],
        rehypePlugins: [],
        recmaPlugins: [],
        remarkRehypeOptions: {}
      }),
    ]
    mdx     from '@studiocms/mdx';
    

     export default 
    function defineStudioCMSConfig(config: StudioCMSOptions): StudioCMSOptions
    A utility function to define the StudioCMS config object.
This function is used to define the optional StudioCMS
config object in the Astro project root. The expected file
name is studiocms.config.mjs. And it should be adjacent
to the Astro project's astro.config.mjs file.
    

    StudioCMS will attempt to import this file and use the default
export as the StudioCMS config object automatically if it exists.
    

    Using this function is optional, but it can be useful for IDEs
to provide better intellisense and type checking.
    @example 
    // studiocms.config.mjs
    import { defineStudioCMSConfig } from 'studiocms/config';
    

    export default defineStudioCMSConfig({
     dbStartPage: true,
     // ...Other Options
    })
    defineStudioCMSConfig    ({
       
    StudioCMSOptions.plugins?: StudioCMSPlugin[]
    Add Plugins to the StudioCMS
    plugins    : [
         
    function mdx(options?: MDXPluginOptions): StudioCMSPlugin
    Creates and configures the StudioCMS MDX plugin.
    @param ― options - Optional configuration options for the MDX plugin.
    @returns ― The configured StudioCMS plugin.
    @example 
    plugins: [
      studiocmsMDX({
        remarkPlugins: [],
        rehypePlugins: [],
        recmaPlugins: [],
        remarkRehypeOptions: {}
      }),
    ]
    mdx    (),
       ],
     });