Help:Structured Discussions/One page/ca

Tota la documentació de Flow en una sola pàgina.

Installation

Reminder: Structured Discussions were formerly called "Flow". Some tools and processes may have kept the old name.

Wikimedia Foundation wikis

</translate> <translate> Structured Discussions is only enabled on [[<tvar name=1>Structured Discussions/Wikis</tvar>|some Wikimedia wikis]].</translate> <translate> Some of those wikis have it available as a Beta feature for all users.</translate> <translate> [[<tvar name=1>m:Special:MyLanguage/Limits to configuration changes#forbidden-extensions</tvar>|It will not be installed on any more Wikimedia wikis]].</translate>

Other wikis

You will need to install the StructuredDiscussions extension on your wiki.

Learn more at <tvar name=1>Extension:StructuredDiscussions </tvar> </translate>

Activation

</translate> <translate> Sysops on wikis that have Structured Discussions installed have the right to create, move and delete Structured Discussions boards.

To activate flow, go to <tvar name=EnablePage>Special:EnableStructuredDiscussions</tvar> on your wiki. Type the name of the page on the first form. The second textarea allows you to pre-fill the Board Description.

This performs the following tasks: </translate>

<translate> archives the talk page in wikitext in a sub-page;</translate>
<translate> Creates a new Structured Discussions Board replacing the talk page.</translate>
<translate> creates a link to the archive sub-page on Structured Discussions Board's description (the bar on the right side);</translate>

<translate> It is not possible to convert a wikitext page content to Structured Discussions.</translate> <translate> This is due to Structured Discussions's structure (a Board with Topics).

Page moves are done like any other page.

Deletion of a Structured Discussion Board is done like any other page. However, if you want to archive the Board, move it to a sub-page instead. </translate> <translate>

Deactivation

</translate> <translate> On some wikis there was previously a Beta feature that allowed users to enable Structured Discussions on their talk page.</translate> <translate> This Beta feature is no longer supported, but users who once had it enabled can deactivate it.</translate>

<translate> If they do, "Flow talk page manager" does the following tasks: </translate>

<translate> unarchives their former wikitext talk page</translate>
<translate> archives the Structured Discussions Board on a sub-page.</translate> <translate> This archived page is at the following address: <tvar name="1">User talk:USERNAME/Structured_Discussions_Archive_1 </tvar>.</translate>

<translate> A maintenance script exists that copies the content of a Structured Discussions board to a wikitext page.

If you need any assistance when deactivating your page, please [[<tvar name="1">Talk:Structured Discussions/Deprecation</tvar>|contact us]].

Probably in 2024, all Structured Discussions pages will be [[<tvar name="1">mw:Structured Discussions/Deprecation</tvar>|deactivated and converted]].

Rename, delete, restore

If you want to rename, delete or restore a Structured Discussions board, please see [[<tvar name=admin>Special:MyLanguage/Help:Structured Discussions/Administration</tvar>|the Administration page]]. </translate>

Known problems (and how to solve them)

Some problems may occur when people use Structured Discussions. This page lists these problems.

Structured Discussions is not working for you

There is two possible known cases.

Browser compatibility

Structured Discussions is following [[<tvar|browsers>Compatibility#Browser support matrix</>|MediaWiki's software compatibility]]. If your browser is not on the list of the "Grade A" browsers, Structured Discussions may not work for you. In any case, having an up-to-date browser is highly recommended for safety reasons.

It is possible to use Structured Discussions without JavaScript or on a text-only browser.

If you still have a problem, it may come from your account settings.

Account settings compatibility

Check compatibility

If your browser is up-to-date, you may have a problem with gadgets or personal scripts you use.

To check on that problem, at your choice: </translate>

<translate> if you are on a Wikimedia wiki, test if you can use Structured Discussions on an other wiki with your global account. Check on [[<tvar|Rollout>Structured Discussions/Wikis</>|the list of wikis where Structured Discussions is available]] and try Structured Discussions there. That option will not be relevant if you are using global scripts (written on your global.js).</translate>
<translate> create a new account for test purposes. Don't activate any extra gadgets or add scripts to that account. Try then to use Structured Discussions. </translate>
<translate> clear your cache and the try to post a message on a Structured Discussions board</translate>
<translate> check for [[<tvar|BrokenScripts>Special:MyLanguage/Help:Locating_broken_scripts</>|broken scripts]]</translate>

Find and solve the problem

You can identify which gadget or script is not compatible [[<tvar|BrokenScripts>Special:MyLanguage/Help:Locating_broken_scripts</>|by locating it]]. When you have found the problematic script or gadget, please contact script/gadget's author, your local script/gadget project or the administrators.

If you still have a problem, unselect all gadgets and clear all scripts from your account, save the changes, clear your cache. Then re-enable all gadgets and scripts.

If then you still have a problem, please contact the [[<tvar|Collab>Growth</>|Growth team]].

It is not possible to use Search to find Structured Discussions topics and contents

Special:Search page does not includes Structured Discussions topics.</translate>

Manage topics

Filter topics

</translate>

File:Filter Structured Discussions topics - Example in Chinese.png

<translate> Location of the filtering menu on a Chinese wiki.</translate>

<translate> On top of a Board is an option to filter topics.

"<tvar name=NewestTopics>Newest topics</tvar>" will show you topics stored by when they have been created.
"<tvar name=RecentTopics>Recently active topics</tvar>" will show you topics as they have been updated, most recent first. [[<tvar name=resolve>#resolve</tvar>|Resolve a topic]] updates it.

</translate>

Edit a topic/a message

</translate>

File:How to edit the summary of a structured discussion topic.png

<translate> The three-dots menu allows you to access many options: edit the topic title, the summary, resolve... (here in French).</translate>

<translate> Editing, like many other actions is accessible through the three-dots menu.

Autoconfirmed users can edit any message, to fix problems or look at the wikitext.

When a message is edited, a new entry is added to the History page. The username of the last editor who changes the message is displayed below the message itself, on the timestamp. To see the differences between the edits, click on the timestamp.

When you edit a message, [[<tvar name=1>Special:MyLanguage/Help:Structured Discussions/Quick tour#basics</tvar>|all basic editing applies]].

The title itself can also be edited. In the ... menu next to the topic's title, select "Edit title". </translate>

<translate> The topic title only allows wikitext markup allowed by the [[<tvar name=EditSummary>meta:help:Edit_summary#Properties</tvar>|edit summary]].</translate>^[1]

Summarize a topic

Summarizing a topic will help people to understand what happened in the Topic. It can be done anytime: during the conversation to summarize what happened, or at the end after a decision is made. Summarizing the topic will be suggested when you mark a topic as resolved.

You can put links or templates in the Summary (like {{See also }} or {{Tracked }}). All basic editing applies.

Logged-in users can summarize a Topic. </translate>

Resolve a topic

</translate>

File:Flow mark resolved prototype.gif

<translate> Resolving a topic hides all answers for that topic, and a check mark is added to the Topic title. Summarizing the topic will be suggested when you mark a topic as resolved. You can expand a resolved Topic by clicking on the Title or on the Summary. You can re-open a Topic anytime, by clicking on the Topic's menu (three dots icon). You need to reopen a topic to do any administrative actions (hide, delete, suppress).

A resolved topic is identified by a grey font color on the table of contents.

Logged-in users can resolve a topic. </translate>

Customization

If you want to only have a start-a-new-topic page, with nothing else around, use <tvar name=start>action=new-topic</tvar>. </translate>

Notifications

You can receive many information about Structured Discussions with the [[<tvar|Notifications>Special:MyLanguage/Help:Notifications</>|Notifications]].

Notifications received

[[<tvar|NotificationsTypes>Special:MyLanguage/Help:Notifications/Notifications_types#Flow</>|Structured Discussions action several notifications]].

Actions with notifications

Highlight new messages

If you click on a notification for a new message, a blue highlighting will be displayed on the side of all new messages for the given Topic.

Highlight mentions or thanks

If you click on a notification for a mention or a thank on a Structured Discussions board, the message where the mention is has a green highlighting.

Actions from notifications

You can unwatch a topic from notifications. Click on the ... and then on "Stop watching activity".

Watchlist

You can turn off Structured Discussions notifications on your notifications preferences. Your watchlist will be still updated with a new line for every subject on a talk page you watch or a new line when someone answers a Topic you watch.

Watch a topic

To watch a specific subject, click on the star on the top of the Topic, near of the title. It turns blue. If it is already blue, you already were watching this topic.

While watching, you will get a notification for every edit to this Topic, and a new line in your watch list.

When you create a Topic, you are auto-subscribed to this Topic.

Watch a Talk page

To watch a whole page, click on the star on the top of the page, near of the search field. It turns blue. If it is already blue, you already were watching this page.

While watching, you get a notification for every new subject posted on this talk page. You will also get a watch list entry. </translate>

Permalinks

Permalinks allow users to create a link to a Topic, or to quote precise elements from a Topic.</translate>

<translate> Board permalink</translate>

<translate> Like other pages on your wiki, a Board's permalink is the URL displayed on the browser's navigation bar, or, for internal links, the page title.</translate> <translate> https://meta.wikimedia.org/wiki/User talk:Example and [[User talk:Example]] are both permalinks to the whole board.</translate>

<translate> Topic permalink</translate>

<translate> A Topics namespace is Topic: </translate>

<translate> If you are on a Board, the Topic's permalink can be found by clicking on the three-dots icon, on the right side.</translate> <translate> If you are on the Topic itself, then the Topic's permalink is the URL displayed on the browser's navigation bar, or by clicking on the three-dots icon.</translate>

<translate> Topic links are formatted with a random sequence of characters, their universally unique identifier (UUID).</translate> <translate> This link does not currently have a hierarchical relationship between the Board and the Topic.</translate> <translate> Example:</translate> Topic:Sojhhtquzbhj3d7q

<translate> The UUID enables a Topic's title to be changed, e.g. to make it clearer, without needing to worry about breaking any incoming links.</translate> <translate> It is also needed by some future features, where a Topic may be displayed on multiple boards, or multiple wikis.</translate> <translate> A URL using the title was not possible to create, because many topics have similar titles: "Hello", "Thank you", "I need your help", etc.</translate> <translate> We are studying a way to have more human-readable URLs, which will still include the unique ID.</translate>

<translate> Post permalink</translate>

<translate> A Post's permalink is reachable by clicking on the three-dots icon, on the right side of the message itself.

Post links are formatted with a Topic's permalink and an anchor to the Post itself. </translate>

<translate> Example:</translate> Topic:Sojhhtquzbhj3d7q#flow-post-sojhhtr5w6j2go86

<translate> In order to highlight a particular topic, some elements may be added by Flow to the URL you will have in your browser address bar.</translate> <translate> Copying this URL will still work.</translate>

<translate> Tip: If you include another Post's permalink in your own comment, then any user who clicks on that link will see the post highlighted by a green bar. </translate>

Administration

All groups of user rights mentioned on this document are the ones defined on MediaWiki.org.

However, configuration varies by wiki, so consult <tvar name=1>Special:ListGroupRights</tvar> on the wiki you're interested in.

Concerning posts and topics

Posts and topics can be moderated in three different ways: hide, delete and suppress.

Some users can also edit or rename a Topic or a board, or mark a topic as resolved.

The following sections mention "posts", but everything also applies to topics.

It is not possible to carry out these actions when a topic has been "Marked as resolved". You have to reopen it first.

Edit

You can edit your own posts. Autoconfirmed users can edit Structured Discussions posts by other users.

Hide

By default, any user can hide a post; it uses the <tvar name=1>flow-hide</tvar> right.

A hidden post is replaced by a warning message. You can read the hidden post by clicking on the history link on the warning message. You will then access to the history page, where the message is struck through.

Anyone can unhide a post on the history page. If a post is unhidden, it becomes visible by anyone.

Mark as resolved

By default, any [[<tvar name=1>Special:ListGroupRights#user</tvar>|logged in user]] can mark a topic as resolved, or reopen it (making it no longer resolved).

This prevents further posts to the topic.

This uses the <tvar name=1>flow-lock</tvar> right.

Delete

</translate> <translate> By default, users in the [[<tvar name=1>Special:ListGroupRights#sysop</tvar>|sysop]] group can delete posts.</translate> <translate> When it is done, the post is deleted. Sysops can restore the post on the History page.</translate> <translate> This uses the <tvar name=1>flow-delete</tvar> right.</translate>

<translate> Hidden topics that haven't been replied can be successfully deleted using <tvar name=1>Special:Nuke</tvar> page.

Suppress

By default, users in the [[<tvar name=1>Special:ListGroupRights#oversight</tvar>|oversight]] and [[<tvar name=2>Special:ListGroupRights#suppress</tvar>|suppress]] groups can suppress posts.

When it is done, the post is oversighted. Oversighters can restore the post on the History page.

This uses the <tvar name=1>flow-suppress</tvar> right.

Rename

Renaming a topic will only change the topic title. It will not move the page from the board.

Concerning boards

</translate> <translate>

Rename

A user can rename a board if they have the right to create a Structured Discussions board at the destination name.

For example, if the destination is a Structured Discussions namespace, any user can move the board to there.

If a user has the "<tvar name=1>Create Structured Discussions boards in any location</tvar>" (<tvar name=2>flow-create-board</tvar>) right, they can create a page working on Structured Discussions in any location; that means they can move a Structured Discussions board to any location.

By default, <tvar name=1>flow-bot</tvar> has this right.

However, wikis can give it to additional users.

Delete and restore

Deleting a board requires the same privileges as deleting any page. When you delete a board, all topics linked to this board are inaccessible to all users, except sysops (like any deleted page). When you restore a board, all topics are visible again.

Protection and blocking

Like all pages on a wiki, it is possible to semi-protect or protect a Structured Discussions board. Blocks are also handled normally. If you block a user without selecting the "<tvar name=1>Editing their own talk page</tvar>" option, that user will still be able to create new topics on their personal talk page.

Move and redirect

Structured Discussions board can be moved in the same way as any other page, by visiting <tvar name=1>Special:MovePage</tvar>.

It is not possible at the moment to create a redirection from a Structured Discussions board.

However, you can work around this issue. Assume you want to redirect <tvar name=1>Talk:Source</tvar> to <tvar name=2>Talk:Destination</tvar>. </translate>

<translate> If <tvar name=1>Talk:Source</tvar> exists, move it to an archive page <tvar name=2>Talk:Source/Archive</tvar> (or a suitable archive location).</translate>
<translate> Create the redirect in a wikitext namespace, as normal, e.g. at <tvar name=1>User:MyUsername/Redirect</tvar>:</translate>
#REDIRECT [[Talk:Destination]]
<translate> Move <tvar name=1>User:MyUsername/Redirect</tvar> to <tvar name=2>Talk:Source</tvar>.</translate>

<translate> You can also use <tvar name="1">Special:ChangeContentModel</tvar> to forcibly create a wikitext page in a Structured Discussions-default namespace, and then redirect it.

Categorization

You can add categories:

for a Board, in the board description,
for a Topic, in the Summary.

Categories will work like on any other page. They will be displayed at the bottom of the Description sidebar. </translate>

Preloading contents

It is possible to preload some contents with Structured Discussions. You can create a link with some parameters, and these parameters will preload the Title and the text fields.

To do this, you can use these two parameters on a Structured Discussions Board: </translate>

topiclist_preloadtitle= - <translate> will preload the Title field with the text you add after the =</translate>
topiclist_preload= - <translate> will preload the text field with a page (usually as subpage) that you call after the = (does not works with simple text)</translate>

Examples

</translate>

<translate> Preload "<tvar name=welcome>Welcome</tvar>" on a new topic on <tvar name=example>Structured Discussions/Sandbox</tvar>:</translate>
https://www.mediawiki.org/wiki/Structured_Discussions/Sandbox?topiclist_preloadtitle=Welcome
<translate> Preload "<tvar name=title>Add title</tvar>" on a new topic title and preload the content of a subpage (<tvar name=example>Structured_Discussions/Sandbox/sub</tvar>) in the text field:</translate>
https://www.mediawiki.org/wiki/Structured_Discussions/Sandbox?topiclist_preloadtitle=Welcome&topiclist_preload=Structured_Discussions/Sandbox/sub

<translate> If there is no content on given page, nothing is preloaded.</translate>

Current limitations

It is not possible to preload the Summary.

It is not possible to preload Templates.

It is not possible to preload simple text on the message field: <tvar name=code>topiclist_preload=Hello</tvar> will not work.

It is not possible to add <tvar name=1>preloadparams </tvar>.

Tips

</translate>

<translate> Do not translate the parameters</translate>
<translate> Use [[<tvar name=help>Special:MyLanguage/Help:Magic_words#URL_data</tvar>|magic words]] like canonicalurl or urlencode to be sure your link will work with special characters or spaces on your wiki.</translate>

Dreceres de teclat

<translate> This page outlines the various keyboard commands supported by the visual editor mode on Structured Discussions. They are based on [[<tvar|VE>Special:MyLanguage/VisualEditor/Portal/Keyboard shortcuts</>|VisualEditor shortcuts]].

The shortcuts shown below are for PC, and may be different on Mac (usually replacing <tvar|ctrl>CTRL</> with <tvar|cmd>⌘ Cmd</>). You can press <tvar|ctrlslash>CTRL+/</> (<tvar|cmdslash>⌘ Cmd+/ on Mac</>) from within Structured Discussions to see the latest available shortcuts on your device.

If you have ideas for new useful commands, or have noticed problems with the existing ones, please let us know on the [[<tvar|Talk>Talk:Structured Discussions</>|Feedback Page]]. </translate>

Text styling
`CTRL`+`B`	Bold
`CTRL`+`I`	Italic
`CTRL`+`K`	Link
Type `[[`	Link
`CTRL`+`⇧ Shift`+`6`	Computer code
`CTRL`+`⇧ Shift`+`5`	Strikethrough
`CTRL`+`,`	Subscript
`CTRL`+`.`	Superscript
`CTRL`+`U`	Underline
`CTRL`+`M`	Remove
`CTRL`+`\`	Remove

Clipboard
`CTRL`+`C`	Copy
`CTRL`+`X`	Cut
`CTRL`+`V`	Paste
`CTRL`+`⇧ Shift`+`V`	Paste as plain text

Paragraph formatting
`CTRL`+`0`	Paragraph
`CTRL`+`7`	Preformatted
`CTRL`+`8`	Block quote
Type `:`	Block quote
`CTRL`+`1-6`	Heading (1-6)
Type `==`	Heading 2
`Tab ↹`	Increase indentation
`CTRL`+`]`	Increase indentation
`⇧ Shift`+`Tab ↹`	Decrease indentation
`CTRL`+`[`	Decrease indentation
Type `*`+`SPACE`	Bullet list
Type `#`+`SPACE`	Numbered list
Type `1.`+`SPACE`	Numbered list

History
`CTRL`+`Z`	Undo
`CTRL`+`⇧ Shift`+`Z`	Redo
`CTRL`+`Y`	Redo

Other
`CTRL`+`↵ Enter`	Save changes
`CTRL`+`F`	Find and replace
`CTRL`+`G`	Find next
`F3`	Find next
`CTRL`+`⇧ Shift`+`G`	Find previous
`⇧ Shift`+`F3`	Find previous
`CTRL`+`⇧ Shift`+`X`	Change directionality
`CTRL`+`A`	Select all
`CTRL`+`/`	Keyboard shortcuts
`CTRL`+`⇧ Shift`+`/`	Keyboard shortcuts

Insert
Type `<!--`	Comment
Type `<hiero`	⧼wikihiero-visualeditor-mwhieroinspector-title⧽
Type `<math`	⧼math-visualeditor-mwmathdialog-title⧽
Type `<chem`	⧼math-visualeditor-mwchemdialog-title⧽
`CTRL`+`⇧ Shift`+`K`	Reference
Type `<ref`	Reference
Type `<score`	⧼score-visualeditor-mwscoreinspector-title⧽
Type `<syntax`	Code block
Type `<source`	Code block
Type `{ \|`	Table
Type `{ {`	Template

↑ phab:T59153

[1] :T59153

[1]