Wikifier

De Mi caja de notas

Révision datée du 22 février 2020 à 08:31 par Xtof (discussion | contributions) (Redirection supprimée vers Wikifying-fr)
(diff) ← Version précédente | Voir la version actuelle (diff) | Version suivante → (diff)

Cette page a démarré sur iwc:wikifying et sera synchronisée pour traduction sur iwc:wikifying-fr


wikifier désigne la pratique de déposer de l’information et des idées sur le wiki. Par exemple, "Nous avons besoin de wikifier cette FAQ, ce concept, ce jargon, ou cet etherpad".

Suivez les directions étape-par-étape sur cette page pour :

  • Étape 1 : Créer votre page wiki.
  • Étape 2 : Éditer votre page wiki.
  • Étape 3 : (facultatif) vous ajouter vous-même aux noms de discussion
  • Étape 4 : (facultatif) créer une sparkline afin qu’il y ait une image à côté de votre nom d’utilisateur

Puis commencez par contribuer sur le wiki.

Pourquoi Rejoindre le Wiki IndieWeb

En tant que communauté, nous évitons les e-mails et préférons discuter en temps réel et de documenter les points importants du wiki pour faciliter la recherche et la création d'informations et de documentation au fil du temps.

Lorsque vous rejoignez le wiki, vous aidez notre communauté à grandir et vous fournissez également la documentation de votre voyage. Cela aide la prochaine personne qui, comme vous, souhaite contrôler ses données dans le lieu qu'elle possède.

Chaque personne qui rejoint le wiki a une page utilisateur qu'elle gère et crée au fil du temps. Vous pouvez façonner votre page pour raconter votre histoire. Au début, tenez compte de ces exemples lorsque vous recherchez des idées.

Exemples IndieWeb

Comment Rejoindre le Wiki IndieWeb

Si ce n’est déjà fait, réglez une connexion web sur votre domaine. À la différence des autres sites où vous choisissez un nom d’utilisateur et un mot de passe, vous n’aurez besoin que de votre nom de domaine pour vous connecter sur ce wiki.

Étape 1 : Créer votre page utilisateur

Après vous être connecté, visitez votre page utilisateur. Puis cliquez sur Create. Vous pouvez choisir deux modèles pour ajouter un profil à votre page.

  • Profil Minimum
  • Profil Infobox

Si vous voulez éditer votre page plus tard, allez sur Votre propre page utilisateur (ou cliquez sur votre nom de domaine tout en haut et à droite). À partir de là, cliquez sur Edit.

Profil Minimum

La communauté IndieWeb utilise les h-cards pour identifier les personnes en ligne. C’est comme une carte de visite pour votre site web.

La plus petite h-card inclut votre nom et un lien vers votre site web.

<span class="h-card">[http://exemple.com/ Votre nom]</span>

Profil Infobox

Si vous préférez inclure une boîte de profil comme portrait Aaron Parecki, nous avons créé un modèle.

Allez sur le modèle Infobox person et copiez le modèle. Puis retournez à votre page d’utilisateur. Copiez le modèle sur votre page d’utilisateur. Remplissez la donnée pertinente que vou aimeriez afficher, puis sauvegardez la page.

Étape Deux : Éditez Votre page Wiki

Vous pouvez façonner votre page wiki comme bon vous semble. Il existe quelques éléments communément renseignés par les membres de la communauté :

Racontez ce qui vous démange

Article principal : itches-fr

Puis, ajoutez une section démangeaisons où vous saisissez ce sur quoi vous voulez travailler sur votre propre site, la présence personnelle numérique en ligne et l’usage personnel de votre présence en ligne (par ex. quand vous êtes hors-ligne)

== Démangeaisons ==
* Ajouter une [[h-card-fr|h-card]] plus développée sur mon site
* Imaginer un [[URL design-fr|design URL]] pour mes posts
* Commencer à poster des [[notes-fr|notes]] manuellement sur les [[permalinks-fr|permaliens]]
* Essayer de vérifier mon site dans indiewebify.me
* Vérifier mon [[IndieMark-fr|IndieMarkd]] pour des idées supplémentaires de choses à ajouter sur mon site

Quand vous commencer à rassembler beaucoup de démangeaisons, vous pourriez vouloir les prioriser, tout spécialement avec ce sur quoi vous êtes en train de travailler. Démarrez par une section "Working on" pour cela :

== Working On ==
* La prochaine chose que j’envisage de travailler sur mon site
* La prochaine chose que je travaille à faire fonctionner sur mon site
* ... etc.


Concentration

Parce que c'est IndieWebCamp, et que ceci traite de votre page utilisateur IndieWebCamp, cela devrait revenir continuellement à vous poser la question :

  • Quelle est la prochaine chose que vous voulez travailler sur votre site personnel ?

Ce qui veut dire par exemple que les éléments suivants seront mieux à laisser de côté ou à poursuivre ailleurs - comme sur votre propre site !

  • Une todo liste personnelle (d'autres choses sur des sites non personnels) - votre page utilisateur IndieWebCamp est de travailler sur votre site personnel.
  • Demander aux autres de faire le travail pour vous. Note : les demandes d'aide pour les démangeaisons/projets spécifiques IndieWeb sont ok, mais adressez-les à tout le monde, pas seulement à des individus. Ceci concerne tout ce que vous voulez travailler - nous pas la délégation à d'autres du travail à réaliser.
  • Essayer de faire que les silos fassent des choses, en général ou avec des comptes spécifiques - au lieu de cela, documentez les problèmes de silos individuels sur les pages spécifiques des silos sur le wiki, et suivez-là. Vos démangeaisons devraient concerner votre site personnel, pas les silos.

Modèles Supplémentaires

Ces modèles pré-définis peuvent être ajoutés sur une page d’utilisateur :

Étape Trois : Ajouter un nom pour discuter

Ajoutez-vous (c’est facultatif) aux noms pour discuter. Ceci affichera votre photo avec votre nom dans les logs de discussion et produira un lien de votre nom vers votre site web. Cela permettra aussi à Loqi notre robot conversationnel de répondre à "who is [nomutilisateur]" avec l’information provenant de votre page utilisateur du wiki.

Pour ajouter un nom de discussion, visitez noms de discussion et utiliser le Modèle fourni.

Étape Quatre : Ajouter une sparkline

Le wiki IndieWeb autorise les sparklines, un petit avatar qui contient votre photo et votre nom reliés à votre page utilisateur. Ceci veut dire que les personnes peuvent ajouter

{{votrenom}}

sur n’importe quelle page avec un lien-photo qui s’affichera.

Visitez le Modèle pour ajouter une sparkline.

Pourquoi Contribuer sur le Wiki IndieWeb

Wikifier en général, et notamment des sujets, des notes ou des documents, aide à développer les communs interrogeables et découvrables de la communauté IndieWeb.

Est-ce lié à l'IndieWeb ? Super, ajoute-le au wiki. Pas sûr ? Regardez les exemples de ce qu'il faut (ou ne pas) ajouter :

Comment Contribuer sur le Wiki IndieWeb

Trouver les pages qui ont besoin d’améliorations

If you're looking for a way to help improve the wiki, consider looking for old pages and help clean them up and improve them! The sections below describe ways you can improve pages, such as fixing typos, ensuring pages have some sort of IndieWeb relevance, adding citations, or even deleting a page.

Here are some ideas for how to find pages that are likely to need improvement.

  • Pages with the Fewest Revisions - These are pages likely to have been defined in chat and need to be expanded. (You can ignore the "redirect pages" in this list.)
  • Short Pages - These pages have very little text. Sometimes that's because a redirect was created incorrectly, or sometimes the page was defined in chat and never expanded.
  • Oldest Pages - This is a list of pages sorted by the oldest date since the last edit. They are likely to have stale information, or may not meet our current standards for wiki pages if they were created many years ago.
  • Lonely Pages - These pages are not linked to by any other page. If the page is relatively complete itself, then consider adding links to it from relevant pages it may link to.

Wikification Incrémentale

Article principal : expand a page-fr

Il y a beaucoup de wikification incrémentale à produire.

  • corriger les erreurs de typo
  • augmenter (et/ou simplifier) une définition pour inclure une pertinence IndieWeb du terme
  • ajouter des exemples IndieWeb - si vous trouvez une page pour une technologie que vous soutenez sur votre site, ou un projet que vous utilisez sur votre site, ajoutez-la vous-même à la section «Exemples IndieWeb" pour cette page
  • ajouter des problèmes et des questions (pour les FAQs)
  • Recueillir des questions/réponses provenant des discusssions et ajoutez-les sur la page wiki appropriée
  • Organiser le contenu d'une page qui grandit en la découpant en sections selon agrandir une page

Voir :

  • agrandir une page pour des suggestions plus spécifiques pour la wikification incrémentale.
  • to-do pour des pages wiki spécifiques qui ont besoin d’améliorations incrémentale !

Ajouter des Citations

Chaque fois que vous voyez Loqi (ou quiconque franchement) partager ou publier un lien dans le chat vers quelque chose de pertinent pour l'indieweb, veuillez nous aider en ajoutant ces citations / exemples au wiki, et surtout si ce sont des photos, ajoutez-les aux pages d'événementS.

Mettre en forme les citations

Voici comment "mettre en forme les textes" de citations pour les ajouter, à partir du minimum, pour produire incrémentalement plus de travail (ou améliorer les citations existantes !)

lien
sérieusement, ça suffit d’ajouter un lien, c’est utile !
AAAA-MM-JJ lien
ajouter la date de publication de l’article aide beaucoup pour placer le lien dans un contexte temporel
AAAA-MM-JJ [lien nom-article]
encore mieux, placer le nom de l’article est encore mieux pour être plus lisible/compréhensible/cherchable/trouvable qu’un simple lien. Est-ce un lien tweet ou un nom qui manque ? Placez un résumé de la phrase à la place.
AAAA-MM-JJ auteur : [lien nom-article]
même mieux, ajoutez l’auteur pour aider à fournir de l’autorité ou au moins le contexte de qui-source
AAAA-MM-JJ {{auteurindieweb}} : [lien nom-article]
même mieux, si l’auteur est un participant dans la communauté indieweb, utilisez le modèle {{}} pour son nom raccourci / pseudo de chat afin de faire un lien vers son nom, peut-être même fournir automatiquement son icône

Facultatif :

  • Ajoutez un blockquote dans la ligne à la fin de la citation, avec de(s) phrase(s) clés copiées-collées à partir du lien, comme ceci :
AAAA-MM-JJ [lien nom-article] <blockquote>phrase(s)-clé pertinente(s) !</blockquote>

Ce sont tous des façons super-faciles pour poser du plein-texte en copiant-collant l’information dans le wiki. (Presque) Pas de code ou de syntaxe à connaître ou imaginer. Ne vous souciez pas d’être parafait, d’autres pourront aider à améliorer les choses.

Garder les pages wiki principalement en texte brut les rend aussi plus faciles à éditer et à améliorer !

La chose importante est de simplement suivre l’étape d’ajout d’information.

Si vous aimez ou êtes familier avec les modèles MediaWiki, vous pouvez aussi utiliser :

Où ajouter une citation

If you don't know where in a page to put a citation, add it to the See Also section at the end.

  • You can even do this from chat by using the << trick like this:
wikipagename << YYYY-MM-DD [link article-name]

etc.

If the citation is criticism, add/move it to the Criticism section of the article.

These are all incremental steps. None are required. All are something you can help with.

Every incremental step you can help with above helps the wiki.

Even just one incremental improvement is helpful!

Nouvelles pages

Article principal : start a page-fr

Il y a beaucoup de création de nouvelles pages, sur lesquelles vous pouvez aider. Créer de nouvelles pages wiki pour :

  • de nouveaux concepts ou des termes discutés, par exemple dans Discussion
    • commencer par un {{stub-fr}} et une courte définition qui inclut une pertinence indieweb ! (voir section suivante)
    • surtout si elles sont en rapport avec indieweb
  • les etherpads des notes de sessions IndieWebCamp une fois terminés, pour archiver les notes de session dans un endroit plus trouvable / pointable.
  • les nouveaux projets que vous commencez à utiliser sur votre site personnel ; assurez-vous d'ajouter votre site dans la section Exemples IndieWeb sur la page.

Si quelque chose n'est pas lié à indieweb, par exemple ça n'a pas été soulevé dans la discussion comme des choses en rapport avec indieweb, envisagez peut-être de documenter à la place sur Wikipedia (et/ou en utilisant Wikipedia comme une référence/citation).

Les définitions incluent une pertinence indieweb

When defining a term, include why it is specifically relevant to the indieweb (if that's not obvious from the description), beyond just a "normal" definition that could have come from Wikipedia (no need to replicate or summarize Wikipedia here, and do not copy from Wikipedia, instead link to it).

E.g. the jargon example could be improved with indieweb relevance like:

  • A jargon term is a specific unobvious word, concept, or technology (like Webmention), or re-use of a word to mean something other than its common meaning (like feed), or sometimes re-using a word as an acronym (like POSSE).

Documenter vos décisions

Une fois que vous avez vous-même documenté votre page d'utilisateur et commencé à documenter de manière incrémentale vos "Démangeaisons" et "Le travail en cours", au fur et à mesure que vous effectuez le travail et le déploiement sur votre site personnel, documentez vos "grandes décisions" sur votre page d'utilisateur ou peut-être dans une section "Mise en œuvre de la conception" de votre page de projet.

Exemples :

Documenter vos grandes décisions de conception et de mise en œuvre vous aidera à mieux considérer quand les revoir, et quand travailler sur de nouvelles fonctionnalités et caractéristiques.

Définir le jargon

Chaque fois que quelqu'un utilise un terme de jargon dans la Discussion, ou d'autres canaux de communication indieweb, allez-y et demandez dans le canal :

  • What is jargon term

Ceci alertera Loqi qui répondra soit avec la définition du wiki, ou vous invitera à définir le terme avec un lien pour créer la page sur le wiki.

Vous pouvez alors définir le terme jargon en cliquant sur ce lien, ou répondre à la question :

  • Un terme jargon est un concept peu évident, ou une ré-utilisation d'un mot pour signifier quelque chose d'autre que son sens commun.

Éviter de répéter les mots du terme, évitez les définitions abstraites génériques, et minimisez l'utilisation de termes du jargon dans une définition (utilisez-les si nécessaire, puis reliez/définissez les aussi).

Essayez d'être spécifique et avec du sens dans les définitions, et ajoutez pourquoi c'est pertinent pour l'indieweb (si ce n'est pas évident à partir de la description).

Définitions tweetables

Consultez les définitions sur les pages wiki, et modifiez-les pour qu'elles soient tweetables, car il est démontré que les gens tweeteront les bonnes définitions qui seront d'une longueur tweetable (en y ajoutant un lien à la suite de la page) - ce qui veut dire 257 caractères (espace + 23 caractères pour le lien raccourci tco).

Site deaths are when sites go offline, taking content and permalinks with them, and breaking the web accordingly. http://indiewebcamp.com/site-deaths

    • Notez qu'il a édité le dfn de site-deaths (à cette heure) et éliminé "their" afin de l'adapter à Twitter.

Révélation progressive du contenu

Une définition tweetable (ou minimale) simple libre de tout jargon est une première étape importante pour fournir un contenu qui soit compréhensible par un public plus large, tout en documentant toutes les recherches et les détails importants qui sont découverts ou inventés par la communauté.

Presque chaque page sur le wiki peut être améliorée à cet égard, afin de fournir une divulgation progressive du contenu pertinent..

Autrement dit, les pages wiki devraient commencer par offrir aux débutants des informations définitives et rapides.

Et ensuite documentez de manière incrémentale les détails si nécessaires pour le vrai monde et les cas d'utilisation qui fournissent des avantages aux lecteurs.

Par exemple Démarrer peut (encore) être à cet égard continuellement améliorée. Comme on pourrait le faire avec l'hébergement web.

Structure Commune de Page

Most pages on the wiki have evolved to have a fairly common page structure, starting with a simple definition, and then adding additional sections such as:

  • Why
  • How to
  • IndieWeb Examples
  • Brainstorming
  • See Also

For more details on these and more, see:

Pages pour les Cas Spéciaux

In addition to the common structure across many pages, there are also several clusters or instances of special case pages.

Pages Standards

The wiki has pages for standards / specifications that were developed on the indieweb wiki, and have started or been formalized at W3C, and thus their pages (and subpages) here have evolved in support of those specifications.

While these are rapidly evolving, take a look at:

There are also pages that are about the indieweb usage of standards developed elsewhere or in active collaboration across communities, e.g. the pages for various microformats. Though these are generally structured in the common structure noted above, they may as a set have special patterns worth noting:

(stub) - help expand this section with documentation of patterns across this type of special page.

Pages Historiques

Some pages help document history, e.g.:

(stub) - help expand this section with documentation of patterns across this type of special page.

Pages Inter-Génération

As certain IndieWeb building-blocks become more widespread, folks from later generations could benefit from re-organized content. In some cases, it may be beneficial to break out "introductory" content (including high-level explanations, examples with screenshots, tools and services, ...) from "developer" content (such as protocol diagrams, code snippets, brainstorming, ...) For example:

(stub) - help expand this section with documentation of patterns across this type of special page.


Articles en Rapport

Ce qui précède est très spécifique à ce qui est une bonne wikification pour IndieWebCamp, en particulier.

Voici les articles liés sur la bonne écriture, la structure et la wikification en général :

FAQ

Est-ce que cela devrait aller sur le wiki

Q : Avons-nous vraiment besoin de ça sur le wiki ?

R : Cela dépend ! En bref, tout ce qui concerne l'indieweb vaut la peine d'être posé sur le wiki, et bien sûr c'est à quelqu'un de prendre soin de le faire !

Voici quelques bons exemples de choses à mettre sur le wiki :

  • Tout sujet directement lié à l'IndieWeb, en particulier directement lié aux personnes dans la communauté avec leurs propres sites :
    • Technologies (par exemple Apache) les gens l'utilisent pour installer/construire/faire tourner/maintenir/surveiller leur site indieweb
    • Les services (par ex. l'hébergement web) que les gens utilisent pour leur site indieweb
    • Les événements ou podcasts qui discutent du web indépendant ou de l'IndieWeb en particulier, y compris les événements avec une seule conversation connexe (assurez-vous d'inscrire la présentation spécifique)
    • Le Jargon représentant une technologie utilisée dans le cadre d'un site IndieWeb
    • Les silos qui ont l'art et l'antécédent (UX, design, formats, protocoles) pour des choses que nous voulons reconstruire de façon indépendante.
  • Si vous n’êtes pas sûr, demandez simplement dans notre canal #meta. Si vous préférez poser la question off the record, vous pouvez essayer le canal #chat (Voir Discussion).

Qu'est ce qui ne devrait pas aller sur le wiki

Q: Si tout cela a du sens sur le wiki, qu'est-ce qui n'a pas de sens sur le wiki ?

R : Il y a tellement de choses qui ne nécessitent pas d'être sur le wiki qu'il est difficile de les énumérer toutes. De toute évidence, en dehors des choses comme les violations du code-de-conduite, voici quelques-unes que nous avons vu être ajoutées et décidé que ce serait mieux de les enlever. Ces choses semblent tomber dans le modèle-type de quand quelqu'un est passionné par quelque chose qui n'est pas lié à l'indieweb, et veut l'ajouter au wiki.

  • Les trucs aléatoires. En général, les trucs aléatoires qui ne disposent pas d'une connexion IndieWeb évidente sont mieux à déposer sur Wikipedia, et en utilisant les liens de Wikipedia plutôt que de créer des pages d'ébauches moins utiles sur le wiki IndieWeb. Par exemple.
  • Les termes techniques. Si un terme technique n'a pas de lien évident direct avec IndieWeb, pas besoin de le documenter ici.
  • Les organisations. Si une organisation n'a aucun rapport avec quoi que ce soit sur IndieWeb, elle peut être laissée de côté.
      • Exception : Comme indiqué ci-dessus sous les silos, nous documentons tout/tous les sites/services que tout le monde a utilisé dans la communauté (ou même si des amis l'ont utilisé) qui ont annoncé ou sont menacés de fermeture, ou s'il a en particulier une UX qui vaut la peine d’être saisie à des fins de recherche pour designer nos propres fonctionnalités indieweb.
    • Événements. Si un événement n'a rien à voir avec l'indieweb, il n'a pas besoin d'être inscrit sur la page événements.

Une foi de plus demander dans la discussion. Les personnes vous aideront à déterminer la pertinence du sujet, le lien vers les discussions antérieures dans les logs, ou vous pointeront vers une page existante.

Pour tous ces cas, envisagez plutôt de les ajouter à Wikipedia (ou d’augmenter là-bas les articles).

Dois-je utiliser le wiki et la syntaxe mediawiki ?

Bien qu'il soit agréable de mettre du contenu dans le wiki en utilisant la syntaxe standard, nous réalisons que tout le monde n'est pas un fan du wiki, ne sait pas comment faire, ou même peut ne pas avoir le temps d'apprendre à le faire. (Documenter ce que vous avez fait est à la fois important et suffisant.)

  • Alternative : Publiez sur votre propre site avec CC0 ! Une autre option consiste simplement à pratiquer le principe de publier d’abord sur votre propre site où vous avez le contrôle ultime. Ensuite, webmention "Indieweb" (pour Superfeedr) ou posez le lien dans le chat. Tant que vous votre contenu est publié sous CC0, quelqu'un l'ajoutera sûrement au wiki en votre nom.
  • Ajoutez simplement du contenu, avec des doubles sauts de ligne pour les paragraphes !

Les utilisateurs ne devraient pas se sentir coupables d'avoir ajouté du contenu du mieux qu'ils le peuvent (balisage / mis en page ou non) là où ils le jugent approprié. D'autres viendront et nettoieront des morceaux dans un avenir proche. Ils ne devraient pas non plus hésiter à demander de l'aide dans le chat s'ils souhaitent en savoir plus sur la wikification.

Discussions en rapport :

Où devrais-je ajouter quelque chose sur le wiki ?

Lorsque vous voyez un article, un post, un concept lié à IndieWeb et que vous souhaitez l'ajouter au wiki, il peut ne pas être évident de savoir où l'ajouter, même juste comme une section "Voir aussi". Voici quelques conseils pour savoir où ajouter quelque chose :

  1. Une page existante la plus pertinente.
  2. S'il existe quelques pages (par exemple peut-être un concept général comme confidentialité, et un silo spécifique comme Facebook), il est correct de l'ajouter sur les deux.
  3. Si vous pouvez penser à quelques pages liées différentes, alors créez une nouvelle page d‘ébauche , puis ajoutez un lien vers cette page d’ébauche dans les sections Voir aussi de ces pages en rapport.

Voir aussi