> For the complete documentation index, see [llms.txt](https://proxypanel.gitbook.io/wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://proxypanel.gitbook.io/wiki/article.md).

# 文章系统

ProxyPanel的文章系统，包含了【帮助】中的知识库与【首页】的公告。知识库配合面板自带变量和展现形式方便您即使调整使用教程，使用户更容易上手。

{% hint style="success" %}
最新大改动：**V 2.7.X**

* 多语言支持；
* 全新的显示模式；
* 富文本编辑器由 [Summernote](https://summernote.org/) 变更至 [TinyMCE](https://www.tiny.cloud/tinymce/)；
  {% endhint %}

## 基本参数 <a href="#ji-ben" id="ji-ben"></a>

### 类 别 <a href="#category" id="category"></a>

类别标识完全一致的文章，会被放在同一个分组下面。

### 语 言 <a href="#language" id="language"></a>

在不同语言环境下，只有所属语言的文章才会显示！

{% hint style="danger" %}
请确保.env文件中 `APP_LOCALE` 参数有出现在 [`config/common.php`](https://github.com/ProxyPanel/ProxyPanel/blob/master/config/common.php) `language` 下！
{% endhint %}

### 排 序 <a href="#sort" id="sort"></a>

公告：按照“创建日期”，优先显示**最新**公告。

文章：在同一文字，同一类别下，优先级：排序数字大到小；同一排序级别下，按照“创建日期”，新到旧；

### 头 图 <a href="#image" id="image"></a>

默认主题下暂无使用计划。用于瀑布式公告背景图，以及知识库的文章的卡片头图。

### 内 容 <a href="#content" id="content"></a>

你可以在知识库编辑器使用 **HTML** 进行写作。

#### 变量 <a href="#valuable" id="valuable"></a>

> 最新全部可使用变量可参考: [`/app/Services/ArticleService.php`](https://github.com/ProxyPanel/ProxyPanel/blob/master/app/Services/ArticleService.php)

```php
// {{siteName}} 会被替换为 网站名字；
// 案例：
欢迎访问{{siteName}}
```

#### 可阅读区域 <a href="#access" id="access"></a>

仅对订阅处于有效的用户展示区域内内容，且会提示非有效用户文章中有隐藏内容

```php
// 可阅读方法1
<!--access_mode_1 start-->
     可阅读内容
<!--access_mode_1 end-->
// 方法1 不可阅读时默认显示：您必须拥有有效套餐才可以查看该区域的内容！

// 可阅读方法2
<!--access_mode_2 start-->
     可阅读内容
<!--access_mode_2 else-->
     不可阅读时内容
<!--access_mode_2 end-->
```