Testing the /article-voice skill (custom) #85
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -6,71 +6,71 @@ description: You can learn about the configuration in the documentation of the D | |
|
|
||
| # Configuration | ||
|
|
||
| Configure *Kanban* appearance and behavior through its API: | ||
|
|
||
| - configure card appearance via [`cardShape`](api/config/js_kanban_cardshape_config.md) | ||
| - configure editor fields via [`editorShape`](api/config/js_kanban_editorshape_config.md) | ||
| - configure editor behavior via [`editor`](api/config/js_kanban_editor_config.md) | ||
| - configure rendering and scrolling via [`renderType`](api/config/js_kanban_rendertype_config.md) and [`scrollType`](api/config/js_kanban_scrolltype_config.md) | ||
| - configure Kanban history via [`history`](api/config/js_kanban_history_config.md) | ||
| - customize card appearance via [`cardTemplate`](api/config/js_kanban_cardtemplate_config.md) | ||
| - *Refer to the [**Customization**](guides/customization.md) section for details!* | ||
| - apply the desired locale via [`locale`](api/config/js_kanban_locale_config.md) | ||
| - *Refer to the [**Localization**](guides/localization.md) section for details!* | ||
| - load data for cards, columns, rows, and links via [`cards`](api/config/js_kanban_cards_config.md), [`columns`](api/config/js_kanban_columns_config.md), [`rows`](api/config/js_kanban_rows_config.md), and [`links`](api/config/js_kanban_links_config.md) | ||
| - *Refer to the [**Working with data**](guides/working_with_data.md) section for details!* | ||
|
|
||
| ## Cards | ||
|
|
||
| The Kanban board distributes *cards* across *columns* and *rows*. Use the [`cardShape`](api/config/js_kanban_cardshape_config.md) property to control which predefined fields appear on each card: | ||
|
Contributor
There was a problem hiding this comment. Здесь хорошо получилось. Оригинал преобразован в более короткое описание, но при этом сохранена вся нужная информация |
||
|
|
||
| - a card label via the `label: boolean` config | ||
|
Contributor
There was a problem hiding this comment. Возможно, здесь тоже не хватает глаголов, как уже обсуждалось здесь |
||
| - a card description via the `description: boolean` config | ||
|
|
||
| :::tip | ||
| You can manage the **label** and **description** fields of any card via the corresponding inputs in the Kanban editor. If you activate these fields, the editor displays the corresponding inputs automatically. To configure these inputs, use the [**text** and **textarea**](#text-and-textarea-types) types. | ||
|
Contributor
There was a problem hiding this comment. (+) использование active voice вместо passive |
||
| ::: | ||
|
|
||
| - a card progress via the `progress: boolean` config | ||
|
|
||
| :::tip | ||
| You can manage the **progress** field of any card via the corresponding control in the Kanban editor. If you activate this field, the editor displays the corresponding control automatically. To configure this control, use the [**progress**](#progress-type) type. | ||
|
Contributor
There was a problem hiding this comment. аналогично. Возможно, получилось однообразно, но все же лучше использования местоимений |
||
| ::: | ||
|
|
||
| - a start date via the `start_date: boolean` config | ||
| - an end date via the `end_date: boolean` config | ||
|
|
||
| :::tip | ||
| You can manage the **start date** and **end date** fields of any card via the corresponding controls in the Kanban editor. If you activate these fields, the editor displays the corresponding controls automatically. To configure these controls, use the [**date**](#date-and-daterange-types) type. | ||
|
Contributor
There was a problem hiding this comment. наверное, на очередном повторе уже можно разнообразить описание, но в оригинале также |
||
| ::: | ||
|
|
||
| - a card context menu via the `menu: boolean` config | ||
| - a card attachment via the `attached: boolean` config | ||
|
|
||
| :::tip | ||
| You can attach files to any card via the corresponding field in the Kanban editor. To configure this field, use the [**files**](#files-type) type. | ||
| ::: | ||
|
|
||
| - a card color via the `color: boolean` config | ||
|
|
||
| :::tip | ||
| You can manage the **top color line** of any card via the corresponding control in the Kanban editor. If you activate **color**, the editor displays a *colorpicker* control automatically. To configure this control, use the [**color**](#color-type) type. | ||
| ::: | ||
|
|
||
| - a card cover (*preview image*) via the `cover: boolean` config | ||
| - card comments via the `comments: boolean` config | ||
| - a confirmation dialog for card deletion via the `confirmDeletion: boolean` config | ||
| - card votes via the `votes: boolean | { show: boolean, clicable: true }` config | ||
| - card assignment (users) via the `users: boolean | { show: boolean, values: object, maxCount: number | false }` config | ||
|
Contributor
There was a problem hiding this comment. Правки выглядят логичными. Но по структуре все же в idra более четко получилось |
||
|
|
||
| :::tip | ||
| You can assign one or several users to any card via the corresponding control in the Kanban editor. To configure the control for assigning a single user, use the [**combo** or **select**](#combo-select-and-multiselect-types) types. To assign multiple users, use the [**multiselect**](#combo-select-and-multiselect-types) type. | ||
| ::: | ||
|
|
||
| - a card priority via the `priority: boolean | { show: boolean, values: object }` config | ||
|
|
||
| :::tip | ||
| You can manage the **priority** of any card via the corresponding control in the Kanban editor. If you activate **priority**, the editor displays the corresponding control automatically. To configure this control, use the [**combo** or **select**](#combo-select-and-multiselect-types) types only. | ||
| ::: | ||
|
|
||
| - *a custom field* via the `headerFields: [ { key: string, label: string, css: string } ]` config | ||
|
|
@@ -122,16 +122,16 @@ new kanban.Kanban("#root", { | |
| ~~~ | ||
|
|
||
| :::note | ||
| If you don't specify card settings via [`cardShape`](api/config/js_kanban_cardshape_config.md), the widget applies the [**defaultCardShape**](api/config/js_kanban_cardshape_config.md#default-config) parameters. | ||
|
Contributor
There was a problem hiding this comment. хорошо поправил unless и будущее время |
||
| ::: | ||
|
|
||
| ## Editor | ||
|
|
||
| :::info | ||
| Display the Editor as a **sidebar** or **modal window** using the [`editor.placement`](api/config/js_kanban_editor_config.md) property! | ||
| ::: | ||
|
|
||
| The editor consists of fields for managing card data. Configure editor fields with [`editorShape`](api/config/js_kanban_editorshape_config.md). The supported field types are: | ||
|
Contributor
There was a problem hiding this comment. преобразования чёткие, нужная инфа сохранена |
||
|
|
||
| - [**combo**, **select**, and **multiselect**](#combo-select-and-multiselect-types) | ||
| - [**color**](#color-type) | ||
|
|
@@ -144,7 +144,7 @@ The *Editor* of Kanban consists of the fields for managing the cards data. To co | |
|
|
||
| ### Combo, Select and Multiselect types | ||
|
|
||
| Set **combo**, **select**, or **multiselect** fields in `editorShape`: | ||
|
Contributor
There was a problem hiding this comment. (+) пассивный залог заменил на активный |
||
|
|
||
| ~~~jsx {3-12} | ||
| new kanban.Kanban("#root", { | ||
|
|
@@ -165,7 +165,7 @@ new kanban.Kanban("#root", { | |
| ~~~ | ||
|
|
||
| :::info | ||
| For **multiselect** and **combo** fields, specify a path to the preview image via the **avatar** property: | ||
|
Contributor
There was a problem hiding this comment. Из всех вариантов самый лучший, на мой взгляд: нет лишнего, но сохранен смысл |
||
|
|
||
| ~~~jsx {3,9,13} | ||
| editorShape: [ | ||
|
|
@@ -193,7 +193,7 @@ editorShape: [ | |
|
|
||
| ### Color type | ||
|
|
||
| Set a **color** field in `editorShape`: | ||
|
|
||
| ~~~jsx {3-12} | ||
| new kanban.Kanban("#root", { | ||
|
|
@@ -215,7 +215,7 @@ new kanban.Kanban("#root", { | |
|
|
||
| ### Text and Textarea types | ||
|
|
||
| Set **text** or **textarea** fields in `editorShape`: | ||
|
|
||
| ~~~jsx {3-14} | ||
| new kanban.Kanban("#root", { | ||
|
|
@@ -239,7 +239,7 @@ new kanban.Kanban("#root", { | |
|
|
||
| ### Progress type | ||
|
|
||
| Set a **progress** field in `editorShape`: | ||
|
|
||
| ~~~jsx {3-12} | ||
| new kanban.Kanban("#root", { | ||
|
|
@@ -261,7 +261,7 @@ new kanban.Kanban("#root", { | |
|
|
||
| ### Files type | ||
|
|
||
| Set a **files** field in `editorShape`: | ||
|
|
||
| #### Configuring Upload Url as String | ||
|
|
||
|
|
@@ -326,7 +326,7 @@ new kanban.Kanban("#root", { | |
|
|
||
| ### Date and DateRange types | ||
|
|
||
| Set a **date** field in `editorShape`: | ||
|
Contributor
There was a problem hiding this comment. Здесь и выше, хорошо заменяет пассив на актив, но в idra например, описания получились более развернутыми: |
||
|
|
||
| ~~~jsx {3-8} | ||
| new kanban.Kanban("#root", { | ||
|
|
@@ -342,7 +342,7 @@ new kanban.Kanban("#root", { | |
| }); | ||
| ~~~ | ||
|
|
||
| Use **dateRange** to bind start and end dates to a single control: | ||
|
|
||
| ~~~jsx {3-11} | ||
| new kanban.Kanban("#root", { | ||
|
|
@@ -363,7 +363,7 @@ new kanban.Kanban("#root", { | |
|
|
||
| ### Comments type | ||
|
|
||
| Set a **comments** field in `editorShape`: | ||
|
|
||
| ~~~jsx {3-13} | ||
| new kanban.Kanban("#root", { | ||
|
|
@@ -386,7 +386,7 @@ new kanban.Kanban("#root", { | |
|
|
||
| ### Links type | ||
|
|
||
| Set a **links** field in `editorShape`: | ||
|
|
||
| ~~~jsx {3-10} | ||
| new kanban.Kanban("#root", { | ||
|
|
@@ -407,7 +407,7 @@ new kanban.Kanban("#root", { | |
| ### Binding editor fields to card fields | ||
|
|
||
| :::info | ||
| To link an editor field to the corresponding card field, add a **key** to the field object in [`editorShape`](api/config/js_kanban_editorshape_config.md) (`key: "editor_field_key"`). For built-in card fields, set the matching key to *true* in [`cardShape`](api/config/js_kanban_cardshape_config.md). For custom card fields, add the key to the **headerFields** array. You can also use this key to provide initial field data. | ||
|
Contributor
There was a problem hiding this comment. Получился хороший вариант, более краткий, но без пассива, как например здесь |
||
|
|
||
| ~~~jsx {5,13,22,25,33-34,38-39,45-47} | ||
| // editor settings | ||
|
|
@@ -464,15 +464,15 @@ new kanban.Kanban("#root", { | |
| ::: | ||
|
|
||
| :::note | ||
| If you don't specify editor settings via [`editorShape`](api/config/js_kanban_editorshape_config.md), the widget applies the [**defaultEditorShape**](api/config/js_kanban_editorshape_config.md#default-config) parameters. In this case, the default controls and inputs appear in the editor only after you activate the corresponding card fields via [`cardShape`](api/config/js_kanban_cardshape_config.md). | ||
|
Contributor
There was a problem hiding this comment. (+) исправляет unless, будущее время и пассив, не удаляет нужные ссылки |
||
| ::: | ||
|
|
||
| ### Configure the editor | ||
|
|
||
| Use the [`editor`](api/config/js_kanban_editor_config.md) property to control editor behavior: | ||
|
|
||
| - enable autosave via `editor.autoSave` | ||
| - set the autosave delay via `editor.debounce` (requires `autoSave: true`) | ||
|
Contributor
There was a problem hiding this comment. хорошо сократил детали без потери смысла |
||
|
|
||
| ~~~jsx {6-9} | ||
| // create Kanban | ||
|
|
@@ -490,7 +490,7 @@ new kanban.Kanban("#root", { | |
|
|
||
| ## Toolbar | ||
|
|
||
| The **Toolbar** contains a search bar, sort controls, and buttons to add columns and rows. Initialize Toolbar in a separate container using the **kanban.Toolbar()** constructor: | ||
|
Contributor
There was a problem hiding this comment. тоже хорошо преобразовал в более краткое описание |
||
|
|
||
| ~~~jsx {13} | ||
| // create Kanban | ||
|
|
@@ -508,7 +508,7 @@ const board = new kanban.Kanban("#root", { | |
| new kanban.Toolbar("#toolbar", { api: board.api }); | ||
| ~~~ | ||
|
|
||
| Use the **items** property to hide, show, or customize Toolbar controls: | ||
|
|
||
|
|
||
| ~~~jsx {6-51} | ||
| // create Kanban | ||
|
|
@@ -571,6 +571,6 @@ To hide some of the Toolbar controls, remove the corresponding string(s) from th | |
|
|
||
| ## Example | ||
|
|
||
| This snippet shows how to configure **Cards**, **Editor**, and **Toolbar** together: | ||
|
Contributor
There was a problem hiding this comment. (+) не удалил описание сниппета |
||
|
|
||
| <iframe src="https://snippet.dhtmlx.com/5hcx01h4?mode=js&tag=kanban" frameborder="0" class="snippet_iframe" width="100%" height="600"></iframe> | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -6,7 +6,7 @@ description: You can learn about the initialization in the documentation of the | |
|
|
||
| # Initialization | ||
|
|
||
| This guide covers how to add Kanban to a page. Take the following steps to get a ready-to-use component: | ||
|
Contributor
There was a problem hiding this comment. (+) оставил всё нужное idra добавил здесь хорошее summary о конструкторах и аргументах |
||
|
|
||
| 1. [Include the Kanban source files on a page](#including-source-files). | ||
| 2. [Create a container for Kanban](#creating-container). | ||
|
|
@@ -16,12 +16,12 @@ This guide will give you detailed instructions on how to create Kanban on a page | |
|
|
||
| [Download the package](https://dhtmlx.com/docs/products/dhtmlxKanban/download.shtml) and unpack it into a folder of your project. | ||
|
Contributor
There was a problem hiding this comment. здесь осталась конструкция с of |
||
|
|
||
| Include 2 source files on your page: | ||
|
|
||
| - *kanban.js* | ||
| - *kanban.css* | ||
|
|
||
| Set correct relative paths to the source files: | ||
|
|
||
| ~~~html title="index.html" | ||
| <script type="text/javascript" src="./dist/kanban.js"></script> | ||
|
|
@@ -36,7 +36,7 @@ Add a container for Kanban and give it an ID, for example *"root"*: | |
| <div id="root"></div> | ||
| ~~~ | ||
|
|
||
| To also display the *Toolbar*, add a separate container for it: | ||
|
|
||
| ~~~jsx {1} title="index.html" | ||
| <div id="toolbar"></div> // container for Toolbar | ||
|
|
@@ -57,7 +57,7 @@ new kanban.Kanban("#root", { | |
| }); | ||
| ~~~ | ||
|
|
||
| To also initialize the *Toolbar*, use the **kanban.Toolbar** constructor separately. It takes two parameters: | ||
|
|
||
| - an HTML container (the ID of the HTML container) | ||
| - an object with configuration properties | ||
|
|
@@ -86,6 +86,6 @@ The full list of properties to configure **Toolbar of Kanban** can be found [**h | |
|
|
||
| ## Example | ||
|
|
||
| This snippet shows how to initialize **Kanban** with initial data: | ||
|
|
||
| <iframe src="https://snippet.dhtmlx.com/gb50vyip?mode=js&tag=kanban" frameborder="0" class="snippet_iframe" width="100%" height="500"></iframe> | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Здесь описание API было лучше, на мой взгляд
https://github.com/DHTMLX/docs-kanban/pull/83/changes#diff-7174c092c6ae1e7b14c766db2501547b5b20f45e207257d04ee5d649322f94d3R12