Re: [fr-doc] Mise à jour des aide-mémoires Basic
Bonjour Jean-François et tous,
Le 22/04/2021 à 08:04, Jean-Francois Nifenecker a écrit :
> Bonjour Sophie,
[...]
>> Tu préfèrerais qu'il y ait un lien vers les macros et un lien vers la
>> doc générale ?
>
> Ce serait l'idéal.
>
> Je pense qu'il y a deux catégories de personnes qui recherchent de la
> doc (pas que sur les macros, bien sûr) : ceux qui recherchent une doc
> particulière ("je veux réaliser un publipostage") et ceux qui vont dans
> les pages "doc" pour voir ce qui existe et qui pourrait les intéresser
> ("tiens, il y a un doc qui parle publipostage. C'est quoi ? Voyons").
oui, je suis d'accord
>
> Ces publics doivent pouvoir accéder à la doc selon ces deux angles. Et
> cet accès doit être simple et rapide : lorsqu'il faut cliquer puis
> re-cliquer puis encore cliquer, changer de langue (qui s'en aperçoit ?),
> c'est beaucoup trop et il y a des chances qu'on ait perdu des visiteurs
> à cause de ça. On pourrait se dire que si ils ont abandonné c'est qu'ils
> n'étaient pas trop motivés, mais ça participe du sentiment que LibO
> serait élitiste et pas pour MMme Toulemonde, juste réservé aux geeks.
ok, il me semblait que le wiki (à cause de Wikipédia) était un bon
endroit pour chercher et trouver plus facilement que sur un site.
>
> Pour ce qui est des macros, nous savons tous que c'est un sujet délicat
> : "les macros sous LibO c'est compliqué", "on n'y comprend rien", "l'API
> est touffue", etc. Oui, leur abord est compliqué. C'est une réalité. Il
> *faut* donc que la doc soit visible.
>
> -> Il est toujours bon (lire : indispensable) de mettre en valeur ce qui
> existe : le livre de Godard & Marcelly, celui/ceux de Pitonyak, ceux qui
> existent pour Base, un point d'entrée vers les docs historiques de OOo
> sur l'API, etc. et que ces docs soient *immédiatement* visibles pour les
> visiteurs (même lorsque les doc sont en anglais, ils doivent être
> visibles sur le site FR).
>
> Question au passage : quid des nombreuses docs présentes sur le site OOo
> en cas de disparition d'iceluy ? Il y a des choses très intéressantes
> qu'il serait idiot de perdre.
Pour les documents réalisés au temps de OOo, la licence a peu de
compatibilité, ce n'est donc pas évident (mon travail sur les fonctions
Calc a maintes fois failli être supprimé du wiki pour ces raisons).
Dennis doit importer la documentation développeur. Je crois que Olivier
souhaite développer la documentation sur les api (api.libreoffice.org).
Il serait sans doute utile de recenser la doc a conserver.
[Pour info au passage, TDF a financé un Xray like UNO object inspector
qui devrait arrivé dans la 7.2
https://wiki.documentfoundation.org/ReleaseNotes/7.2/fr#Noyau_.2FG.C3.A9n.C3.A9ral]
Et j'en profite pour envoyer des grands mercis à Pierre-Yves pour ces
notes de version en français :)
>
>>
>>>
>>> mais aussi
>>> Découvrir > Modèles et extensions > LibreOffice extensions [1] >
>>> BASIC xxx
>>>
>>> [1] Actuellement cassé, impossible de sélectionner un tag
>>
>> C'est réparé, n'hésite pas à signaler sur Redmine lorsqu'il y a un bug.
>> Christian fait encore pas mal de modifications sur le site et cela peut
>> avoir des effets de bord pénalisants.
>
> Ah, merci. Oui, je pratique Redmine mais c'est un peu lassant d'avoir N
> outils différents à gérer en matière de rapport de bugs, et j'avoue
> aussi que j'ai bcp de mal avec le SSO.
Nous avons dû séparer ce qui est relatif à l'infrastructure et ce qui
est relatif au produit pour plus de réactivité côté infra, et disons que
tout TDF est gérée via Redmine. Mais bon, je comprends que cela
complique donc n'hésite pas à me dire ici lorsque tu rencontres un bug.
>
>>
>> Je suis d'accord. Le site principale va bientôt être complètement
>> modifié. Peut-être que c'est le bon moment pour repenser comment
>> organiser la documentation si ce qui est en place ne vous convient pas.
>
> Magnifique ! Il y a un vrai travail à faire. Je n'ose proposer de l'aide
> car j'ai déjà promis... et pas tenu, faute de temps pour le moment :(
Je n'ai pas non plus beaucoup de temps libre, la l10n en mange pas mal,
mais je veux bien agir sur le site. Je ne connais pas encore Hugo, le
moteur du nouveau site, mais je devrais l'apprendre de toute façon. Par
contre je veux bien que vous fassiez le brainstorming et que je n'ai
plus qu'à exécuter :)
Note: le site peut aussi renvoyer sur le site Documentation ici
https://documentation.libreoffice.org/fr/documentation-en-francais/
Je n'ai pas développé et ai renvoyé sur le wiki, mais on pourrait aussi
copier la page Anglaise (y compris la partie Read in your browser
https://books.libreoffice.org/en/GS70/GS7000-Preface.html).
Bref c'est assez ouvert et qui veut participer à l'amélioration est le
bienvenu bien sûr.
À bientôt
Sophie
--
Sophie Gautier so...@libreoffice.org
GSM: +33683901545
IRC: sophi
Foundation coordinator
The Document Foundation
--
Envoyez un mail à doc+unsubscr...@fr.libreoffice.org pour vous désinscrire
Les archives de la liste sont disponibles à
Re: [fr-doc] Mise à jour des aide-mémoires Basic
Bonjour Sophie,
Le 21/04/2021 à 11:15, sophi a écrit :
Aparté à propos de ce type de documentation
---
Je constate que ce type de doc est compliqué à trouver pour un néophyte
(la cible primaire) car (1) dispersé sur le site, (2) variable selon la
langue choisie et (3) présent à des endroits improbables et, à mon avis,
inadaptés.
Compliqué :
Pages FR
Aide > Documentation > Wiki (EN !) > Wiki FR > Macros -> perdu !
c'est
Aide > Documentation > Wiki (EN !) > Wiki FR > Guides officiels (en bas,
rubrique Antisèches)
Note : le lien Aide > Documentation > "à partir de cette page"
mène directement à la page voulue mais ce lien peu contrasté est noyé
dans le texte et son libellé n'explicite pas clairement ce vers quoi il
pointe.
Tu préfèrerais qu'il y ait un lien vers les macros et un lien vers la
doc générale ?
Ce serait l'idéal.
Je pense qu'il y a deux catégories de personnes qui recherchent de la
doc (pas que sur les macros, bien sûr) : ceux qui recherchent une doc
particulière ("je veux réaliser un publipostage") et ceux qui vont dans
les pages "doc" pour voir ce qui existe et qui pourrait les intéresser
("tiens, il y a un doc qui parle publipostage. C'est quoi ? Voyons").
Ces publics doivent pouvoir accéder à la doc selon ces deux angles. Et
cet accès doit être simple et rapide : lorsqu'il faut cliquer puis
re-cliquer puis encore cliquer, changer de langue (qui s'en aperçoit ?),
c'est beaucoup trop et il y a des chances qu'on ait perdu des visiteurs
à cause de ça. On pourrait se dire que si ils ont abandonné c'est qu'ils
n'étaient pas trop motivés, mais ça participe du sentiment que LibO
serait élitiste et pas pour MMme Toulemonde, juste réservé aux geeks.
Pour ce qui est des macros, nous savons tous que c'est un sujet délicat
: "les macros sous LibO c'est compliqué", "on n'y comprend rien", "l'API
est touffue", etc. Oui, leur abord est compliqué. C'est une réalité. Il
*faut* donc que la doc soit visible.
-> Il est toujours bon (lire : indispensable) de mettre en valeur ce qui
existe : le livre de Godard & Marcelly, celui/ceux de Pitonyak, ceux qui
existent pour Base, un point d'entrée vers les docs historiques de OOo
sur l'API, etc. et que ces docs soient *immédiatement* visibles pour les
visiteurs (même lorsque les doc sont en anglais, ils doivent être
visibles sur le site FR).
Question au passage : quid des nombreuses docs présentes sur le site OOo
en cas de disparition d'iceluy ? Il y a des choses très intéressantes
qu'il serait idiot de perdre.
mais aussi
Découvrir > Modèles et extensions > LibreOffice extensions [1] > BASIC xxx
[1] Actuellement cassé, impossible de sélectionner un tag
C'est réparé, n'hésite pas à signaler sur Redmine lorsqu'il y a un bug.
Christian fait encore pas mal de modifications sur le site et cela peut
avoir des effets de bord pénalisants.
Ah, merci. Oui, je pratique Redmine mais c'est un peu lassant d'avoir N
outils différents à gérer en matière de rapport de bugs, et j'avoue
aussi que j'ai bcp de mal avec le SSO.
Je suis d'accord. Le site principale va bientôt être complètement
modifié. Peut-être que c'est le bon moment pour repenser comment
organiser la documentation si ce qui est en place ne vous convient pas.
Magnifique ! Il y a un vrai travail à faire. Je n'ose proposer de l'aide
car j'ai déjà promis... et pas tenu, faute de temps pour le moment :(
Très cordialement,
--
Jean-Francois Nifenecker, Bordeaux
--
Envoyez un mail à doc+unsubscr...@fr.libreoffice.org pour vous désinscrire
Les archives de la liste sont disponibles à
https://listarchives.libreoffice.org/fr/doc/
Privacy Policy: https://www.documentfoundation.org/privacy
Re: [fr-doc] Mise à jour des aide-mémoires Basic
Le 21/04/2021 à 17:35, sophi a écrit : Je vois ce lien, mais comme je l'ai dit, je veux bien reformuler, réorganiser, mais pas supprimer ce lien. Il pointe vers d'autres documentations pas forcément disponibles en français et dont il serait dommage de priver les utilisateurs. Alors il faut préciser qu'il s'agit bien de la version anglophone, et rajouter une ligne pour la version française. Sinon pour voir le wiki francophone (*Bienvenue sur la page d'accueil de la documentation francophone)*, il faut suivre ce lien, puis changer la langue de la pagepas d'autre moyen d'accès. Et la page dédiée à la programmation n'est accessible qu'à partir de là. A + -- Jean-Michel -- Envoyez un mail à doc+unsubscr...@fr.libreoffice.org pour vous désinscrire Les archives de la liste sont disponibles à https://listarchives.libreoffice.org/fr/doc/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [fr-doc] Mise à jour des aide-mémoires Basic
Le 21/04/2021 à 17:11, Jean-Michel COSTE a écrit : > Le 21/04/2021 à 16:05, sophi a écrit : >> Le lien pointe vers: >> https://wiki.documentfoundation.org/Documentation/Publications/fr#Guides_utilisateur_officiels >> >> Si tu lis la page, le premier lien pointe vers la documentation en >> Anglais (car tout n'est pas traduit). >> La deuxième ligne (sur trois) pointe dit: Les chapitres individuels de >> chaque livre déjà traduit en français (incluant les anciennes versions >> de LibreOffice), sont disponibles à partir de cette page. > > Visiblement, nous n'avons pas les mêmes lunettes. > > Je parle bien de cette page : > https://fr.libreoffice.org/get-help/documentation/ oui, moi aussi > > La PREMIERE dit "Les guides LibreOffice officiels sont disponibles sur > le wiki. Certains sont déjà traduits en français et pour d'autres le > travail est en cours." > > Derrière le mot "wiki" il y a la page > https://wiki.documentfoundation.org/Documentation (wiki anglais) et > devrait être (selon Jean-François et moi) : > https://wiki.documentfoundation.org/Documentation/fr qui est sa > traduction très fidèle> > Ca doit être ce lien que tu ne vois pas ? Je vois ce lien, mais comme je l'ai dit, je veux bien reformuler, réorganiser, mais pas supprimer ce lien. Il pointe vers d'autres documentations pas forcément disponibles en français et dont il serait dommage de priver les utilisateurs. À bientôt Sophie -- Sophie Gautier so...@libreoffice.org GSM: +33683901545 IRC: sophi Foundation coordinator The Document Foundation -- Envoyez un mail à doc+unsubscr...@fr.libreoffice.org pour vous désinscrire Les archives de la liste sont disponibles à https://listarchives.libreoffice.org/fr/doc/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [fr-doc] Mise à jour des aide-mémoires Basic
Le 21/04/2021 à 16:05, sophi a écrit : Le lien pointe vers: https://wiki.documentfoundation.org/Documentation/Publications/fr#Guides_utilisateur_officiels Si tu lis la page, le premier lien pointe vers la documentation en Anglais (car tout n'est pas traduit). La deuxième ligne (sur trois) pointe dit: Les chapitres individuels de chaque livre déjà traduit en français (incluant les anciennes versions de LibreOffice), sont disponibles à partir de cette page. Visiblement, nous n'avons pas les mêmes lunettes. Je parle bien de cette page : https://fr.libreoffice.org/get-help/documentation/ La PREMIERE dit "Les guides LibreOffice officiels sont disponibles sur le wiki. Certains sont déjà traduits en français et pour d'autres le travail est en cours." Derrière le mot "wiki" il y a la page https://wiki.documentfoundation.org/Documentation (wiki anglais) et devrait être (selon Jean-François et moi) : https://wiki.documentfoundation.org/Documentation/fr qui est sa traduction très fidèle Ca doit être ce lien que tu ne vois pas ? Pour les autres lignes, ça correspond bien à ta description. Ce problème de lien peu visible est ce qu'évoquait Jean-François dans son premier message -- Jean-Michel -- Envoyez un mail à doc+unsubscr...@fr.libreoffice.org pour vous désinscrire Les archives de la liste sont disponibles à https://listarchives.libreoffice.org/fr/doc/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [fr-doc] Mise à jour des aide-mémoires Basic
Le 21/04/2021 à 15:58, Jean-Michel COSTE a écrit : > Le 17/04/2021 à 16:02, Jean-Francois Nifenecker a écrit : >> Bonjour, >> j'ai mis à jour les aide-mémoires pour Basic (9 fiches FR et EN). Avec >> les versions ODF et PDF, cela fait donc 9 x 2 x 2 = 36 documents. >> Les mises à jour concernent essentiellement deux points : mise en >> forme générale (adoption des polices Source Sans) et actualisation des >> copies d'écrans pour la v7. Quelques corrections aussi. >> J'ai également restructuré la numérotation : les fiches n°2 et n°9 >> sont devenues 2A et 2B respectivement, en raison de leur proximité de >> contenu. >> Les aide-mémoires sont donc maintenant en version 2.0. >> -> Où puis-je les téléverser ? > > Bonjour, > > Je trouve qu'elles sont à leur place avec la documentation générale ici > : > https://wiki.documentfoundation.org/Documentation/Publications/fr#Antis.C3.A8ches_Basic. > > > Ensuite, la question est de les référencer là où cela semble nécessaire. > > Je viens de mettre un lien depuis la page > https://wiki.documentfoundation.org/Macros/fr dans la rubrique > Documents/Exemples. Est-ce que ça convient ? > > Il reste un dernier souci, car le wiki francophone n'est pas accessible > directement depuis la page Documentation francophone : > https://fr.libreoffice.org/get-help/documentation/. > > C'est la version anglaise qui est pointée par le lien. Le lien pointe vers: https://wiki.documentfoundation.org/Documentation/Publications/fr#Guides_utilisateur_officiels Si tu lis la page, le premier lien pointe vers la documentation en Anglais (car tout n'est pas traduit). La deuxième ligne (sur trois) pointe dit: Les chapitres individuels de chaque livre déjà traduit en français (incluant les anciennes versions de LibreOffice), sont disponibles à partir de cette page. > > Quelqu'un peut-il corriger ça ? Ce serait dommage de priver les utilisateurs d'une partie de la documentation. Je veux bien reformuler suivant les propositions faites ici, mais pas supprimer le lien vers le wiki. À bientôt Sophie -- Sophie Gautier so...@libreoffice.org GSM: +33683901545 IRC: sophi Foundation coordinator The Document Foundation -- Envoyez un mail à doc+unsubscr...@fr.libreoffice.org pour vous désinscrire Les archives de la liste sont disponibles à https://listarchives.libreoffice.org/fr/doc/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [fr-doc] Mise à jour des aide-mémoires Basic
Le 17/04/2021 à 16:02, Jean-Francois Nifenecker a écrit : Bonjour, j'ai mis à jour les aide-mémoires pour Basic (9 fiches FR et EN). Avec les versions ODF et PDF, cela fait donc 9 x 2 x 2 = 36 documents. Les mises à jour concernent essentiellement deux points : mise en forme générale (adoption des polices Source Sans) et actualisation des copies d'écrans pour la v7. Quelques corrections aussi. J'ai également restructuré la numérotation : les fiches n°2 et n°9 sont devenues 2A et 2B respectivement, en raison de leur proximité de contenu. Les aide-mémoires sont donc maintenant en version 2.0. -> Où puis-je les téléverser ? Bonjour, Je trouve qu'elles sont à leur place avec la documentation générale ici : https://wiki.documentfoundation.org/Documentation/Publications/fr#Antis.C3.A8ches_Basic. Ensuite, la question est de les référencer là où cela semble nécessaire. Je viens de mettre un lien depuis la page https://wiki.documentfoundation.org/Macros/fr dans la rubrique Documents/Exemples. Est-ce que ça convient ? Il reste un dernier souci, car le wiki francophone n'est pas accessible directement depuis la page Documentation francophone : https://fr.libreoffice.org/get-help/documentation/. C'est la version anglaise qui est pointée par le lien. Quelqu'un peut-il corriger ça ? Bonne après-midi... -- Jean-Michel -- Envoyez un mail à doc+unsubscr...@fr.libreoffice.org pour vous désinscrire Les archives de la liste sont disponibles à https://listarchives.libreoffice.org/fr/doc/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [fr-doc] Mise à jour des aide-mémoires Basic
Bonjour Jean-François, Le 17/04/2021 à 16:02, Jean-Francois Nifenecker a écrit : > Bonjour, > > j'ai mis à jour les aide-mémoires pour Basic (9 fiches FR et EN). Avec > les versions ODF et PDF, cela fait donc 9 x 2 x 2 = 36 documents. > > Les mises à jour concernent essentiellement deux points : mise en forme > générale (adoption des polices Source Sans) et actualisation des copies > d'écrans pour la v7. Quelques corrections aussi. > > J'ai également restructuré la numérotation : les fiches n°2 et n°9 sont > devenues 2A et 2B respectivement, en raison de leur proximité de contenu. > > Les aide-mémoires sont donc maintenant en version 2.0. > > -> Où puis-je les téléverser ? > > > Aparté à propos de ce type de documentation > --- > > Je constate que ce type de doc est compliqué à trouver pour un néophyte > (la cible primaire) car (1) dispersé sur le site, (2) variable selon la > langue choisie et (3) présent à des endroits improbables et, à mon avis, > inadaptés. > > Compliqué : > > Pages FR > Aide > Documentation > Wiki (EN !) > Wiki FR > Macros -> perdu ! > c'est > Aide > Documentation > Wiki (EN !) > Wiki FR > Guides officiels (en bas, > rubrique Antisèches) > > Note : le lien Aide > Documentation > "à partir de cette page" > mène directement à la page voulue mais ce lien peu contrasté est noyé > dans le texte et son libellé n'explicite pas clairement ce vers quoi il > pointe. Tu préfèrerais qu'il y ait un lien vers les macros et un lien vers la doc générale ? > > mais aussi > Découvrir > Modèles et extensions > LibreOffice extensions [1] > BASIC xxx > > [1] Actuellement cassé, impossible de sélectionner un tag C'est réparé, n'hésite pas à signaler sur Redmine lorsqu'il y a un bug. Christian fait encore pas mal de modifications sur le site et cela peut avoir des effets de bord pénalisants. > > > Variable selon la langue : > FR (ci-dessus) > > EN > Get Help > Documentation > Macro Books > > > Endroits improbables : > > Sur le site des extensions et modèles ! Qui irait chercher de la > *documentation* là ? > J'ai interrogé Olivier Hallot à plusieurs reprises sur ce point mais > sans réponse. Je suis d'accord. Le site principale va bientôt être complètement modifié. Peut-être que c'est le bon moment pour repenser comment organiser la documentation si ce qui est en place ne vous convient pas. À bientôt Sophie -- Sophie Gautier so...@libreoffice.org GSM: +33683901545 IRC: sophi Foundation coordinator The Document Foundation -- Envoyez un mail à doc+unsubscr...@fr.libreoffice.org pour vous désinscrire Les archives de la liste sont disponibles à https://listarchives.libreoffice.org/fr/doc/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [fr-doc] Mise à jour des aide-mémoires Basic
Le 17/04/2021 à 16:02, Jean-Francois Nifenecker a écrit : Bonjour, j'ai mis à jour les aide-mémoires pour Basic (9 fiches FR et EN). Avec les versions ODF et PDF, cela fait donc 9 x 2 x 2 = 36 documents. Les aide-mémoires sont donc maintenant en version 2.0. -> Où puis-je les téléverser ? Bonjour Jean-François, Moi je ne les voyais que sur la page des publications du wiki : https://wiki.documentfoundation.org/Documentation/Publications/fr#Antis.C3.A8ches_Basic), tout en bas, mais avec un lien depuis le menu en haut. Je pense que c'est la bonne place ? Aparté à propos de ce type de documentation --- Je constate que ce type de doc est compliqué à trouver pour un néophyte (la cible primaire) car (1) dispersé sur le site, (2) variable selon la langue choisie et (3) présent à des endroits improbables et, à mon avis, inadaptés. Compliqué : Pages FR Aide > Documentation > Wiki (EN !) > Wiki FR > Macros -> perdu ! Il faudrait impérativement corriger ce lien, celui (ou celle, égalité oblige) qui s'occupe de cette page (https://fr.libreoffice.org/get-help/documentation/) n'a-t-il jamais testé les liens qui s'y trouvent ? Recopie servile de la page anglophone ? Et mettre un lien direct vers ces documents dans la page Macros du wiki. Bonne soirée, -- Jean-Michel COSTE -- Envoyez un mail à doc+unsubscr...@fr.libreoffice.org pour vous désinscrire Les archives de la liste sont disponibles à https://listarchives.libreoffice.org/fr/doc/ Privacy Policy: https://www.documentfoundation.org/privacy
