Page components: Difference between revisions

Line 1:

{{Feature

|description=Page Components is the name I'm using for a visual design system that lets Users easily ~~compose~~ pages with various "blocks" or "elements" on the page. The goal is to ~~describe how~~ to ~~apply industry~~-~~norms~~ in [[MediaWiki]] software. MediaWiki is famously not a CMS, but more like a collaborative ~~swiss-army knife~~ complex construction kit. Because the system is virtually ~~unconstrained~~, we provide ~~opinions on the~~ "best way" when there is TIMTOWTDI.

|description=Page Components is the name I'm using for a visual design system that lets '''Users''' easily author pages with various "blocks" or "elements" on the page. The goal is to come up with a re-usable and easy-to-use system in [[MediaWiki]] software. MediaWiki is famously not a CMS, but more like a collaborative complex construction kit. Because the system is virtually unlimited and powerful, we would like to provide a pre-packaged "best way" to use that power without needing to be a power user and when there is TIMTOWTDI.

To develop such a system we also need to refer to all the technical underpinnings used by developers and wiki admins, so bear with us during the process. Eventually there will be separate technical vs. user content.

[[mw:Design]] is probably the best starting point to learn about User Interface in the MediaWiki context.

|image=HTML5 logo and wordmark.svg

}}

Line 76:

Line 80:

|-

|'''Elements'''

|An element is a general term that comes from the HTML specification<ref>See https://en.wikipedia.org/wiki/HTML_element and the HTML Specification itself https://html.spec.whatwg.org/multipage/index.html</ref> meaning an individual part of a document, encapsulated by an HTML tag. A 'link' is an element. In the MediaWiki Design System (Codex), the smallest unit is the 'token'

|An element is a general term that comes from the HTML specification<ref>See https://en.wikipedia.org/wiki/HTML_element and the HTML Specification itself https://html.spec.whatwg.org/multipage/index.html</ref> meaning an individual part of a document, encapsulated by an HTML tag. A 'link' is an element. In the MediaWiki Design System (Codex), the smallest unit is the [https://doc.wikimedia.org/codex/latest/design-tokens/definition-and-structure.html token]. Tokens help implement the Codex Design Style Guide across all page components<ref>[https://doc.wikimedia.org/codex/latest/design-tokens/definition-and-structure.html token definition]

[[mediawikiwiki:Codex#Using_design_tokens_directly|Using design tokens directly in MediaWiki]]</ref>.

|The building blocks or fields that make up a content type (such as a title or body).

|Refers to HTML elements (e.g., heading, paragraph), which are represented as blocks in the Gutenberg editor.

@@ Line 1: / Line 1: @@
 {{Feature
-|description=Page Components is the name I'm using for a visual design system that lets Users easily compose pages with various "blocks" or "elements" on the page. The goal is to describe how to apply industry-norms in [[MediaWiki]] software. MediaWiki is famously not a CMS, but more like a collaborative swiss-army knife complex construction kit. Because the system is virtually unconstrained, we provide opinions on the "best way" when there is TIMTOWTDI.
+|description=Page Components is the name I'm using for a visual design system that lets '''Users''' easily author pages with various "blocks" or "elements" on the page. The goal is to come up with a re-usable and easy-to-use system in [[MediaWiki]] software. MediaWiki is famously not a CMS, but more like a collaborative complex construction kit. Because the system is virtually unlimited and powerful, we would like to provide a pre-packaged "best way" to use that power without needing to be a power user and when there is TIMTOWTDI.
+To develop such a system we also need to refer to all the technical underpinnings used by developers and wiki admins, so bear with us during the process. Eventually there will be separate technical vs. user content.
+[[mw:Design]] is probably the best starting point to learn about User Interface in the MediaWiki context.
 |image=HTML5 logo and wordmark.svg
 }}
@@ Line 76: / Line 80: @@
 |-
 |'''Elements'''
-|An element is a general term that comes from the HTML specification<ref>See https://en.wikipedia.org/wiki/HTML_element and the HTML Specification itself https://html.spec.whatwg.org/multipage/index.html</ref> meaning an individual part of a document, encapsulated by an HTML tag.  A 'link' is an element. In the MediaWiki Design System (Codex), the smallest unit is the 'token'
+|An element is a general term that comes from the HTML specification<ref>See https://en.wikipedia.org/wiki/HTML_element and the HTML Specification itself https://html.spec.whatwg.org/multipage/index.html</ref> meaning an individual part of a document, encapsulated by an HTML tag.  A 'link' is an element. In the MediaWiki Design System (Codex), the smallest unit is the [https://doc.wikimedia.org/codex/latest/design-tokens/definition-and-structure.html token]. Tokens help implement the Codex Design Style Guide across all page components<ref>[https://doc.wikimedia.org/codex/latest/design-tokens/definition-and-structure.html token definition]
+[[mediawikiwiki:Codex#Using_design_tokens_directly|Using design tokens directly in MediaWiki]]</ref>.
 |The building blocks or fields that make up a content type (such as a title or body).
 |Refers to HTML elements (e.g., heading, paragraph), which are represented as blocks in the Gutenberg editor.