Spatie Filament Markdown Editor 项目使用教程

1. 项目的目录结构及介绍

Spatie Filament Markdown Editor 是一个为 Filament 框架提供的 Markdown 编辑器。以下是项目的目录结构及其简单介绍：

filament-markdown-editor/
├── .github/              # GitHub 工作流和模板文件
├── docs/                 # 文档资料
├── resources/            # 资源文件，如样式表、脚本等
├── src/                  # 源代码目录
│   ├── Components/       # Vue 组件
│   ├── Http/             # HTTP 相关类
│   ├── Forms/            # 表单字段相关
│   └── ...
├── tests/                # 测试文件
├── .editorconfig          # 编辑器配置文件
├── .gitattributes         # Git 属性配置
├── .gitignore            # Git 忽略文件
├── CHANGELOG.md          # 更新日志
├── LICENSE.md            # 许可证文件
├── README.md             # 项目说明文件
├── composer.json         # Composer 配置文件
├── package.json          # Node.js 包管理配置文件
├── phpunit.xml.dist       # PHPUnit 配置文件
└── webpack.mix.js        # Webpack 配置文件

2. 项目的启动文件介绍

在 src/ 目录下，主要的启动文件是 MarkdownEditor.php，这是在 Filament 中注册 Markdown 编辑器字段的地方。以下是启动文件的简单介绍：

• MarkdownEditor.php：这个文件是 Markdown 编辑器字段的主要类文件，它包含了如何将编辑器集成到 Filament 表单中的逻辑。

在 Filament 资源中使用此编辑器时，通常会通过以下方式引入：

use Spatie\FilamentMarkdownEditor\MarkdownEditor;

public static function form(Form $form): Form
{
    return $form->schema([
        // 其他字段...
        MarkdownEditor::make('text')
            ->fileAttachmentsDisk('admin-uploads')
            ->fileAttachmentsVisibility('public')
            ->required(),
    ]);
}

3. 项目的配置文件介绍

项目的配置主要通过以下文件进行：

• config/filament-markdown-editor.php：这个文件是用于配置 Markdown 编辑器行为的配置文件，可以设置图片上传的磁盘和可见性等。

配置文件可能看起来像这样：

return [
    'disk' => env('FILAMENT_MARKDOWN_EDITOR_DISK', 'local'),
    'path' => env('FILAMENT_MARKDOWN_EDITOR_PATH', 'uploads'),
    'visibility' => env('FILAMENT_MARKDOWN_EDITOR_VISIBILITY', 'public'),
];

在这个配置文件中，可以设置图片上传的存储磁盘、存储路径以及上传文件的可见性。这些环境变量可以在 .env 文件中定义，以便于不同环境下的配置调整。