Difference between revisions of "Article"

From Wikidocumentaries
Jump to navigation Jump to search
(Propose a category for the article)
(43 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<gallery mode=slideshow>
 
<gallery mode=slideshow>
 
Wikit small en.png|On each topic page, the article and data section are presented first after the header image.
 
Wikit small en.png|On each topic page, the article and data section are presented first after the header image.
Wikit-expand.png|The article can be expanded to read it in its entirety.
+
Wikit-expand.png|The article can be expanded to be read it in its entirety.
 
Wikit-expanded.png|In the expanded view images are larger and there's more empty space around the article.
 
Wikit-expanded.png|In the expanded view images are larger and there's more empty space around the article.
Wikit redlink small en.png|This is an idea for a tool: Redlinks can link to Wikidocumentaries topic pages if the link makes a search in Wikidata.
+
Wikit redlink small en.png|'''Missing link feature''': Redlinks can link to Wikidocumentaries topic pages if the link makes a search in Wikidata.
 
Wikit-highlight.png|The same can be done with highlighted text.
 
Wikit-highlight.png|The same can be done with highlighted text.
 
Wikit-highlight-link.png|The edit box is used to trying different spelling variations.
 
Wikit-highlight-link.png|The edit box is used to trying different spelling variations.
Wikipedia Actions.png|Different tools can be places under the Actions menu
+
Wikipedia Actions.png|Different tools can be placed under the Actions menu
collectlinks1.png|The links can be navigated with the arrows above the link text. To be able to see behind the popup, the popup can be hidden from a button or by toggling by clicking on the link itself. TBD If there is no connection between the items (the page topic and the link topic), the popup opens in edit mode.
+
collectlinks1.png|'''Collect links tool''': The links can be navigated with the arrows above the link text. To be able to see behind the popup, the popup can be hidden from a button or by toggling by clicking on the link itself (TBD). If there is no connection between the items (the page topic and the link topic), the popup opens in edit mode, else in list mode.
collectlinks2.png|The user is asked to type in the property. A popup with possible properties opens, and the user can select the correct property.
+
collectlinks2.png|The user is asked to type in the property. A popup with possible properties opens, and the user can select the correct property. If the property direction is from the link topic to the page topic, it cannot be added in this view.
collectlinks3.png|The user can accept this or continue to add qualifiers. When the entry is accepted, the data is added to Wikidata, and the source will automatically be set to the Wikipedia page.
+
collectlinks3.png|The user can accept this or continue to add qualifiers. When the entry is accepted, the data is added to Wikidata, and the source will automatically be set to the Wikipedia page. There can be an additional dialog asking if the reverse statement can also be added.
 
collectlinks4.png|After accepting the popup is displayed in list mode. The list displays all properties between the topic of the page and the topic of the link.
 
collectlinks4.png|After accepting the popup is displayed in list mode. The list displays all properties between the topic of the page and the topic of the link.
 
collectlinks5.png|Any of the statement can be edited or removed (TBD)
 
collectlinks5.png|Any of the statement can be edited or removed (TBD)
Line 24: Line 24:
 
</gallery>
 
</gallery>
  
There are two types of articles in Wikidocumentaries.
+
==Article==
* Collaboratively created topic's main articles are discussed on this page.
+
===Article content===
* Articles created as memoirs by one person are discussed on the [[testimonials]] page.
+
Currently, Wikidocumentaries displays the Wikipedia article about the topic when the item exists in Wikidata. When the project is developed, it could display articles from other sources as well
 +
* Wikidocumentaries own wiki if the item is created in the Wikidocumentaries wiki or if an item is from a federated Wikibase that does not use articles. See further down the section on it.
 +
* It has been proposed, that Wikisource original material could be displayed in the space for the article. [https://docs.google.com/presentation/d/1jZe4SjevxgqzGvE_bfWSkc28DRPoRQaXMRgDJgM6hLU/edit#slide=id.gf64e3a6e9c_0_0 See the proposal].
 +
* Sometimes authority sources have articles that could also be displayed.
 +
* Personal point-of-view testimonials about a topic could be categorized as being displayed in this space or in their own component. A separate space might be good to avoid confusion between neutral pov and subjective ones.
  
 +
The sources could be displayed in a fallback order, and if there were more than one candidate, they could be added to a menu.
  
== Displaying an article in the topic page ==
+
===Languages===
* As a user I can read a main article about the current topic
+
The article is initially displayed in the user's language. The user is given the option to view the article in another language while the interface stays in the user's language.
** If the topic exists in Wikidata, the article to be displayed or added should be in Wikipedia.
+
 
** If the topic exists in Wikidocumentaries only, the article is stored in Wikidocumentaries.
+
The article area displays a message when the related Wikipedia article does not exist
 +
# Message if the article does not exist in the user's language but exists in another
 +
# Message if the article does not exist in any language
 +
# Message if the user wishes to see an automatically created article. With [https://meta.wikimedia.org/wiki/Abstract_Wikipedia Abstract Wikipedia], the article can be automatically created from facts.
 +
 
 +
When we are capable of storing user information, we could set a language fallback chain and use it for displaying the articles.
  
 +
===Layout===
 +
The article is displayed in compact and expanded modes.
 +
* In the compact mode, the article's beginning is displayed. The layout takes full width of the browser page.
 +
* When expanded, the article is displayed in a reader-friendly layout with tables and large images. Many templates remain unreadable, because they are custom-built in each Wikipedia. Images could open full-screen like this https://fat.github.io/zoom.js/. The code exists for Vue for example https://popmotion.io/pose/learn/vue-tutorial-medium-style-image-zoom/, https://codesandbox.io/s/github/francoischalifour/medium-zoom/tree/master/examples/vue?view=preview
 +
 +
===Links===
 +
* Links in Wikipedia articles are redirected to Wikidocumentaries pages based on Wikidata QIDs. See [[linking]].
 +
** Problem cases in Wikipedia: Page redirects, links to other namespaces than articles.
 +
* Red links are currently not displayed as links. They could trigger a label search function in Wikidata. The same method could be applied for arbitrarily selected text. The resulting link could be saved for adding to the Wikipedia article, but it would be useful also without saving. This would be some kind of annotation mechanism, see also [https://www.w3.org/annotation/ W3C Web Annotation recommendations].
  
 
==Toolbar==
 
==Toolbar==
  
 
===Edit-button / Plus-button===
 
===Edit-button / Plus-button===
* Wikipedia article
+
One button is dedicated to linking to the article on the source.
** View/edit in Wikipedia
+
 
** The icon can also be the Wikipedia logo
+
For Wikipedia articles
* Item in Wikidocumentaries – article in Wikidocumentaries
+
* "External link" symbol is displayed for viewing or editing the article in Wikipedia.
** Enable the use [[Visual Editor]] locally to edit the article and links. It will need to be modified to meet the local needs.
+
* If other sources are included, the icon could change accordingly.
* Missing article
+
* If the article is missing from Wikipedia in the user's language, the "Plus" icon is used.
** Plus-button
+
** Wikidocumentaries can be viewed in languages that Wikidata supports, even if there is no Wikipedia in that language. The missing article action produces an error in cases where there is no language Wikipedia.  
** Currently a missing article action is directed to the language Wikipedia. It produces an error in cases where there is no language Wikipedia. An intermediate step would be useful where the article names could be decided according to the target Wikipedia's practices before directing to the article creation page.
+
** An intermediate step would be useful where the article names could be decided according to the target Wikipedia's practices before directing to the article creation page. See [[#Article actions|Article actions]]
** When displaying items that exist in Wikidocumentaries only, the article would also be created in the local wiki. Later, when the local item gets imported to Wikidata, the resulting articles could be imported or merged with Wikipedias. This is a very difficult challenge, and a notification might be enough for volunteers to do the merge manually.
 
  
 
===Languages menu===
 
===Languages menu===
Line 54: Line 72:
  
 
===Actions menu===
 
===Actions menu===
* [[Tasks]] of picking the links in the text and adding to Wikidata
+
* [[#Article tasks|Tasks]] of picking the links in the text and adding to Wikidata
  
 
===Expand article===
 
===Expand article===
 
* Button is placed below the article. When clicked, it displays the full article and moves the Wikidata block to the end of the article.
 
* Button is placed below the article. When clicked, it displays the full article and moves the Wikidata block to the end of the article.
  
==Article content==
+
==Article actions==
===Wikipedia / Wikidocumentaries===
+
 
* Wikipedia article about the topic when the item exists in Wikidata.
+
===New article===
* Wikidocumentaries article of the topic when the item exists in Wikidocumentaries.  
+
When the article does not exist in Wikipedia, the user may choose to create it. The current, updated action is a link in the plus-button that goes directly to edit an article by the name of the item in Wikipedia. This is always not desirable.
===Languages===
+
* The article name may be used for another topic
* The article is initially displayed in the user's language.
+
* The article name may be a disambiguation page
*# Message if the article does not exist in the user's language but exists in another
+
* The article name may be a redirect.
*# Message if the article does not exist in any language
+
 
*# Message if the user wishes to see an automatically created article. With [https://meta.wikimedia.org/wiki/Abstract_Wikipedia Abstract Wikipedia], the article can be automatically created from facts.
+
There should be an intermediate step before creating the actual edit link, to select a correct name and maybe a category for the article.
*# Option the set a language fallback chain and use it for articles
+
 
* When expanded, the article displays images and tables. Many templates remain unreadable. Images could open full-screen like this https://fat.github.io/zoom.js/. Exists for Vue for example https://popmotion.io/pose/learn/vue-tutorial-medium-style-image-zoom/, https://codesandbox.io/s/github/francoischalifour/medium-zoom/tree/master/examples/vue?view=preview
+
====List options for names====
 +
;1. Use the topic title as the first option and the trunk for the extended options. The best-known title for the topic should already have been chosen for it.
 +
;2. If the article name is used for another topic
 +
* Grey it out if it is in use for another mainspace article. Allow manually editing the title.
 +
* Add alternative values with a clarifying extension to choose from. The format may vary according to the project. By default, use parenthesis to include additional information.
 +
** The value of P131, located in administrative entity. If that is too specific, display the P131 of that entity.
 +
** Display the P31 value as an alternative. If that is too specific, display the superclass of that item.
 +
** If there are several P31 values, display all of them as separate options.
 +
** For human topics, use the profession P106. If that is too specific, display the superclass of that item.
 +
* Add an option to edit the chosen value
 +
;3. For a redirect... In this case the community might have decided not to grant an article for this topic. Be cautious. Take over the redirect page for the article.
 +
* Display an option to create the page.
 +
;4. For a disambiguation page
 +
* Grey out the topic title and add all the alternative titles as an option.
 +
 
 +
====Propose a category for the article====
 +
* The item likely has very little information to go with
 +
* Look for categories for this item or the superclass of this item
 +
** Category for the P131, located in administrative entity
 +
 
 +
 
 +
<gallery heights=200 mode=slideshow>
 +
New article.png
 +
Newarticle disambig.png
 +
Newarticle redirect.png
 +
</gallery>
 +
 
 +
==Article tasks==
 +
See also [[Tasks]]
 +
 
 +
===Wikipedia article components to statements===
 +
In this scenario, the user could skim through links in the Wikipedia article and add them as statements. Idea stage, see the header illustration for details.
 +
* Use the same method for red links. Ask the user to confirm the target of a red link and save it as a statement.
 +
* Recognise unlinked named entities programmatically, verify and save as statements. UI: Automatically recognise names entities and underline the words.
 +
* Select free text and search for a target, save as a statement.
  
===Links===
+
===Navigating via missing links===
* Links in Wikipedia articles are redirected to Wikidocumentaries pages based on Wikidata QIDs. See [[linking]].
+
When a Wikipedia article does not exist for an item mentioned in the text, or has not been linked, it would be pretty easy to present a search pulldown to allow navigating to other items without the need to save any data. It would work with
** Problem cases in Wikipedia: Page redirects, links to other namespaces than articles.
+
* Red links
* Red links are currently not displayed as links. They could trigger a label search function in Wikidata. The same method could be applied for arbitrarily selected text. The resulting link could be saved for adding to the Wikipedia article, but it would be useful also without saving. This would be some kind of annotation mechanism, see also [https://www.w3.org/annotation/ W3C Web Annotation recommendations].
+
* Selected text
 +
* Named entities
  
==Local articles==
+
==How should the local articles be managed?==
Local articles for topics that only exist in Wikidocumentaries are created in Wikidocumentaries.
+
Local articles for topics that only exist in Wikidocumentaries could be created in Wikidocumentaries.
 
* All language versions of a Wikidocumentaries article are stored as separate wiki pages in Wikidocumentaries.
 
* All language versions of a Wikidocumentaries article are stored as separate wiki pages in Wikidocumentaries.
 
* Articles will have entries in the Wikibase to be able to connect them to different topics and language versions or they can be added using the modified sitelinks feature.
 
* Articles will have entries in the Wikibase to be able to connect them to different topics and language versions or they can be added using the modified sitelinks feature.
Line 83: Line 136:
 
* The user should be able to use a modified [[Visual Editor]] to edit (local) articles. It needs to be modified to support bespoke linking. This is a more general [[federation]] need.
 
* The user should be able to use a modified [[Visual Editor]] to edit (local) articles. It needs to be modified to support bespoke linking. This is a more general [[federation]] need.
  
==Wikidocumentaries article data==
+
===Wikidocumentaries article data===
 
What is the data to be saved about an article in Wikidocumentaries database.
 
What is the data to be saved about an article in Wikidocumentaries database.
 
* Topic articles
 
* Topic articles
Line 96: Line 149:
 
** Author (these are not collaboratively editable). The link to a user is not a Wikibase entry for privacy reasons unless made public --> How to handle. Start with an easy solution.
 
** Author (these are not collaboratively editable). The link to a user is not a Wikibase entry for privacy reasons unless made public --> How to handle. Start with an easy solution.
  
==Tooling, technology==
+
===Tooling, technology===
 
* The article should be translatable (local file to local file), preferably with Content Translate.
 
* The article should be translatable (local file to local file), preferably with Content Translate.
 
* Visual editor should be extended with a gadget that can make links based on Wikidata entries rather than local wiki links.
 
* Visual editor should be extended with a gadget that can make links based on Wikidata entries rather than local wiki links.
 
* Wikibase should be able to maintain an index of translations of an article. Can sitelinks be recycled?
 
* Wikibase should be able to maintain an index of translations of an article. Can sitelinks be recycled?
 
+
* Enable the use [[Visual Editor]] locally to edit the article and links. It will need to be modified to meet the local needs.
==Why is it interesting, what are the takeaways?==
+
* When displaying items that exist in Wikidocumentaries only, the article would also be created in the local wiki. Later, when the local item gets imported to Wikidata, the resulting articles could be imported or merged with Wikipedias. This is a very difficult challenge, and a notification might be enough for volunteers to do the merge manually.
 
 
  
 
{{Design-nav}}
 
{{Design-nav}}

Revision as of 12:59, 29 December 2021

Article

Article content

Currently, Wikidocumentaries displays the Wikipedia article about the topic when the item exists in Wikidata. When the project is developed, it could display articles from other sources as well

  • Wikidocumentaries own wiki if the item is created in the Wikidocumentaries wiki or if an item is from a federated Wikibase that does not use articles. See further down the section on it.
  • It has been proposed, that Wikisource original material could be displayed in the space for the article. See the proposal.
  • Sometimes authority sources have articles that could also be displayed.
  • Personal point-of-view testimonials about a topic could be categorized as being displayed in this space or in their own component. A separate space might be good to avoid confusion between neutral pov and subjective ones.

The sources could be displayed in a fallback order, and if there were more than one candidate, they could be added to a menu.

Languages

The article is initially displayed in the user's language. The user is given the option to view the article in another language while the interface stays in the user's language.

The article area displays a message when the related Wikipedia article does not exist

  1. Message if the article does not exist in the user's language but exists in another
  2. Message if the article does not exist in any language
  3. Message if the user wishes to see an automatically created article. With Abstract Wikipedia, the article can be automatically created from facts.

When we are capable of storing user information, we could set a language fallback chain and use it for displaying the articles.

Layout

The article is displayed in compact and expanded modes.

Links

  • Links in Wikipedia articles are redirected to Wikidocumentaries pages based on Wikidata QIDs. See linking.
    • Problem cases in Wikipedia: Page redirects, links to other namespaces than articles.
  • Red links are currently not displayed as links. They could trigger a label search function in Wikidata. The same method could be applied for arbitrarily selected text. The resulting link could be saved for adding to the Wikipedia article, but it would be useful also without saving. This would be some kind of annotation mechanism, see also W3C Web Annotation recommendations.

Toolbar

Edit-button / Plus-button

One button is dedicated to linking to the article on the source.

For Wikipedia articles

  • "External link" symbol is displayed for viewing or editing the article in Wikipedia.
  • If other sources are included, the icon could change accordingly.
  • If the article is missing from Wikipedia in the user's language, the "Plus" icon is used.
    • Wikidocumentaries can be viewed in languages that Wikidata supports, even if there is no Wikipedia in that language. The missing article action produces an error in cases where there is no language Wikipedia.
    • An intermediate step would be useful where the article names could be decided according to the target Wikipedia's practices before directing to the article creation page. See Article actions

Languages menu

  • List of links to all articles language version regardless of user settings or site translations.
  • All languages are displayed in a scrollable list
  • Display a link to Content Translate, when displaying the article in another language, and the user's language article does not exist.

Actions menu

  • Tasks of picking the links in the text and adding to Wikidata

Expand article

  • Button is placed below the article. When clicked, it displays the full article and moves the Wikidata block to the end of the article.

Article actions

New article

When the article does not exist in Wikipedia, the user may choose to create it. The current, updated action is a link in the plus-button that goes directly to edit an article by the name of the item in Wikipedia. This is always not desirable.

  • The article name may be used for another topic
  • The article name may be a disambiguation page
  • The article name may be a redirect.

There should be an intermediate step before creating the actual edit link, to select a correct name and maybe a category for the article.

List options for names

1. Use the topic title as the first option and the trunk for the extended options. The best-known title for the topic should already have been chosen for it.
2. If the article name is used for another topic
  • Grey it out if it is in use for another mainspace article. Allow manually editing the title.
  • Add alternative values with a clarifying extension to choose from. The format may vary according to the project. By default, use parenthesis to include additional information.
    • The value of P131, located in administrative entity. If that is too specific, display the P131 of that entity.
    • Display the P31 value as an alternative. If that is too specific, display the superclass of that item.
    • If there are several P31 values, display all of them as separate options.
    • For human topics, use the profession P106. If that is too specific, display the superclass of that item.
  • Add an option to edit the chosen value
3. For a redirect... In this case the community might have decided not to grant an article for this topic. Be cautious. Take over the redirect page for the article.
  • Display an option to create the page.
4. For a disambiguation page
  • Grey out the topic title and add all the alternative titles as an option.

Propose a category for the article

  • The item likely has very little information to go with
  • Look for categories for this item or the superclass of this item
    • Category for the P131, located in administrative entity


Article tasks

See also Tasks

Wikipedia article components to statements

In this scenario, the user could skim through links in the Wikipedia article and add them as statements. Idea stage, see the header illustration for details.

  • Use the same method for red links. Ask the user to confirm the target of a red link and save it as a statement.
  • Recognise unlinked named entities programmatically, verify and save as statements. UI: Automatically recognise names entities and underline the words.
  • Select free text and search for a target, save as a statement.

Navigating via missing links

When a Wikipedia article does not exist for an item mentioned in the text, or has not been linked, it would be pretty easy to present a search pulldown to allow navigating to other items without the need to save any data. It would work with

  • Red links
  • Selected text
  • Named entities

How should the local articles be managed?

Local articles for topics that only exist in Wikidocumentaries could be created in Wikidocumentaries.

  • All language versions of a Wikidocumentaries article are stored as separate wiki pages in Wikidocumentaries.
  • Articles will have entries in the Wikibase to be able to connect them to different topics and language versions or they can be added using the modified sitelinks feature.
  • Navigating the articles in different languages in the Wikidocumentaries MediaWiki needs a solution to connect them together.
  • The user should be able to use a modified Visual Editor to edit (local) articles. It needs to be modified to support bespoke linking. This is a more general federation need.

Wikidocumentaries article data

What is the data to be saved about an article in Wikidocumentaries database.

  • Topic articles
    • Topic id
    • Language id
    • Article location (If the articles are arranged in a hierarchical tree structure, then an additional title will be needed. Should be more flexible that way.
    • Translatable title
  • Testimonial articles
    • Depicted items --> Could also investigate existing Wikidata properties
    • Depicted date
    • Depicted location
    • Author (these are not collaboratively editable). The link to a user is not a Wikibase entry for privacy reasons unless made public --> How to handle. Start with an easy solution.

Tooling, technology

  • The article should be translatable (local file to local file), preferably with Content Translate.
  • Visual editor should be extended with a gadget that can make links based on Wikidata entries rather than local wiki links.
  • Wikibase should be able to maintain an index of translations of an article. Can sitelinks be recycled?
  • Enable the use Visual Editor locally to edit the article and links. It will need to be modified to meet the local needs.
  • When displaying items that exist in Wikidocumentaries only, the article would also be created in the local wiki. Later, when the local item gets imported to Wikidata, the resulting articles could be imported or merged with Wikipedias. This is a very difficult challenge, and a notification might be enough for volunteers to do the merge manually.


Navigation

About Technology Design Content modules Tool pages Projects
Status

Wikidocumentaries blog

Wikidocumentaries demo

Phabricator project

Facebook group

GitHub repository

Translation in TranslateWiki

Wikidocumentaries Slack

Setting up dev environment

Resources

Translations

Languages

Using Wikibase

Federation with Wikidata

APIs

Linking

Media metadata

Properties to content

User registration

Licensing

Page types

Landing page

Search page

Topic page

User page

Organisation page

Project page

Tool page

Tasks

Components

Main toolbar and footer

Search

Faceting

Topic page header

Content module

Dropdown

Modal

Icons

Active modules

Article

Family tree

Gallery

Historical map

Images

Image viewer

Infobox

Map

Module ideas

Audio/Video

Bibliography

Correspondence

Discussion

Graph

Name

Newspaper articles

Testimonials

Timeline

Visualizations

Wikidocumentary

3D

Visual editor

Query tool

QuickStatements

Open Refine

Creating topics

Uploading images

Geolocating tool

Metadata editor

Rectifying maps

Transcription

Annotation tool

Central Park Archives

Convent Quarter

Wikisource