Publicar en DoliNews
Desde la apertura de la cuenta hasta el primer artículo publicado.
Aquí la información siempre está fechada: su anuncio indica la compatibilidad y la madurez del módulo el día en que lo publica. DoliNews no pretende describir el estado actual de un módulo, solo lo que usted ha anunciado, y cuándo. La ficha de su proyecto, en cambio, es permanente: no lleva ni compatibilidad ni madurez.
Dos cosas que saber antes de empezar. Escribir exige una cuenta contribuidora, es decir una prueba de que ha contribuido realmente al ecosistema: leer y suscribirse no la exigen. Y todo anuncio pasa por la revisión: un token de API da derecho a enviar, nunca a publicar. Solo sus traducciones escapan a ella, pues el texto que traducen ya ha sido revisado.
1. Abrir la cuenta
El registro es libre y da una cuenta de lector. Un correo de verificación sale de inmediato: el enlace que contiene es de un solo uso y activa la cuenta.
Use preferentemente la dirección con la que firma sus commits. Si esa dirección ya la conoce el índice de autores, su cuenta pasa a ser de contribuidor en el mismo momento en que verifica el correo, y el paso siguiente no le concierne.
2. Demostrar su contribución
La cualificación es distinta de la autenticación: la cuenta existe primero, la prueba viene después. El servicio busca su dirección de autor de commits en un índice recogido de clones git de los repositorios de referencia - nunca en la API de una forja, para que la verificación sobreviva a la desaparición de un alojamiento.
Su dirección nunca se conserva en claro, ni en el índice ni en la prueba: solo se almacena su huella con pimienta.
Una vez reconocida la dirección, queda demostrar que es suya. Dos niveles:
- Simple: se envía un código de un solo uso a la dirección de commit, válido una hora, cinco intentos.
- Fuerte: el servicio le da una frase para firmar con la clave GPG que firma sus commits; usted pega su clave pública y la firma.
Tres casos en los que la vía simple no se aplica:
- Su dirección de commit es una redirección anonimizada, del tipo que dan las forjas: no recibe correo, quedan la firma GPG o la validación manual.
- Su dirección no aparece en ningún repositorio de referencia: pida la validación manual al equipo desde esa misma página, explicando su situación. Es la vía prevista para los editores sin repositorio público.
- Esta dirección ya está vinculada a otra cuenta: una huella solo cualifica a una cuenta, y una prueba revocada por la moderación nunca la devuelve un automatismo.
3. Declarar su editor
El editor es la organización o la persona que publica; sus fichas de proyecto y sus anuncios le pertenecen. Nunca se publica en nombre propio: sin editor, nada puede enviarse. El formulario de creación se le ofrece en cuanto se acepta su prueba de contribución, y sigue disponible al pie de la página de sus artículos. Una integración que parte de cero crea más bien su editor con POST /editors. Usted es propietario del editor que crea y puede vincularle otras cuentas de contribuidor, que publicarán con el mismo nombre.
Un editor en propiedad por cuenta: el crédito de publicación y el tope de cola se cuentan por editor. A los demás se accede por invitación de su propietario.
4. Crear un token de API
El token sirve para publicar desde su cadena de integración, y hace falta en el paso siguiente. Nómbrelo según su uso: el secreto solo se muestra una vez, al crearlo, y se revoca en cualquier momento.
Se usa como cabecera en cada llamada. Empiece por comprobar que responde:
TOKEN="12|..."
curl -H "Authorization: Bearer $TOKEN" -H "Accept: application/json" \
https://dolinews.com/api/v1/profileLa respuesta lleva los dos valores de los que depende toda escritura: is_contributor, y la lista de sus editores con su identificador. Anote ese identificador, las llamadas siguientes lo piden.
Ritmo: 120 lecturas y 10 escrituras por minuto. Un script que sube varias imágenes seguidas debe tener en cuenta el segundo límite.
5. Crear la ficha de su proyecto
La ficha describe el proyecto de forma permanente: nombre, resumen, descripción, licencia, enlaces tipados al repositorio, la documentación, la tienda o el soporte. No lleva ninguna compatibilidad con Dolibarr, y es deliberado: una ficha permanece durante años, así que cualquier información fechada que contuviera se volvería falsa sin que nadie la corrigiera.
La ficha se crea desde su cuenta, o mediante la API si parte de una cadena de integración. Un artículo puede prescindir de ficha - será entonces un anuncio de editor - pero una publicación de versión merece la suya.
# Créer la fiche
curl -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"editor_id":3,"name":"Mon module",
"summary":"Ce que fait le module, en une phrase.",
"license":"GPL-3.0-or-later"}' \
https://dolinews.com/api/v1/projects
# Ajouter un lien typé : dolistore, shop, demo, doc, repo, support, other
curl -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"type":"repo","url":"https://example.org/mon-module","label":"Dépôt git"}' \
https://dolinews.com/api/v1/projects/mon-module/linksLos acortadores de URL se rechazan, y una ficha de Dolistore ya reclamada por otro editor provoca un conflicto que la moderación resuelve.
6. Enviar su anuncio
Por el sitio desde la página de sus artículos, o por la API. En ambos casos el contenido es el mismo, y el resumen es obligatorio: es lo que el lector recorre en el hilo, y su ausencia es lo que hace ilegibles la mayoría de los registros de cambios.
- El tipo distingue la publicación de versión del anuncio de editor; la naturaleza de la publicación - seguridad, corrección, funcionalidad, compatibilidad, fin de vida - solo vale para una versión.
- La madurez va de alfa a obsoleta. Solo las versiones estables aparecen en el hilo por defecto: el lector pide el resto explícitamente.
- La compatibilidad con Dolibarr es un rango de versiones mayores, y se declara simplemente o como realmente probada. No declare como probado lo que no ha probado: el filtro por versión depende de ello.
- El cuerpo va en Markdown. Los enlaces salientes llevan todos nofollow, y solo las imágenes subidas al servicio pueden ilustrar un artículo.
Un anuncio ilustrado se publica en dos tiempos: subir las imágenes, y luego crear el artículo citando sus direcciones en el cuerpo y sus identificadores en media_ids. Sin esos identificadores, las imágenes quedan huérfanas y se borran al cabo de veinticuatro horas.
# 1. Déposer une capture. Elle est ré-encodée, ses métadonnées disparaissent.
curl -H "Authorization: Bearer $TOKEN" \
-F file=@capture.png -F editor_id=3 -F alt="Écran de configuration" \
https://dolinews.com/api/v1/media
# 2. Créer l'article et le soumettre dans le même appel
curl -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"editor_id":3,"project_id":7,"type":"release",
"title":"Mon module 2.1","version":"2.1.0","locale":"fr_FR",
"focus":"bugfix_major","maturity":"stable","dolibarr_min":20,
"summary":"Ce que cette version change, en quelques lignes.",
"body":"## Corrections\n\n",
"media_ids":[42],"submit":true}' \
https://dolinews.com/api/v1/articlesUna captura de un Dolibarr en servicio contiene casi siempre datos reales - terceros, importes, direcciones. Límpiela antes de enviarla.
La imagen destacada es la que el hilo, la tarjeta para compartir y los flujos muestran para su anuncio: desígnela con featured_media_id entre las imágenes de su editor, o con la línea image: de la cabecera si usa la herramienta de publicación. Se revisa con el anuncio, y cambiarla tras la publicación pasa por una revisión. Sin ella, se muestra la primera imagen del cuerpo; una traducción muestra la del original.
Dos límites protegen la cola: un ritmo de publicación por proyecto, y un tope de anuncios del mismo editor en revisión a la vez. Un anuncio y sus traducciones cuentan como uno.
7. La revisión, y lo que sigue
Su artículo entra en la cola y tres moderadores deben aceptarlo para que aparezca. Los intercambios ocurren en un hilo privado entre usted y el equipo: usted responde, corrige, vuelve a enviar. Modificar un artículo pendiente abre una nueva vuelta de revisión, porque una aprobación recae sobre un texto preciso.
No se anuncia ningún plazo, y no es un olvido: comprometerse con el tiempo libre de voluntarios convertiría cada retraso en un incumplimiento. La página de la revisión muestra el plazo realmente observado y la espera más antigua. Un anuncio de seguridad pasa primero.
Una vez publicado, un artículo ya no se modifica en su sitio: usted propone una revisión, que vuelve a pasar por la revisión, el artículo lleva la mención de su corrección y la versión original sigue consultable. Una traducción es un artículo por derecho propio, ligada a su original: la que usted mismo envía aparece sin revisión, la de un traductor al que ha dado mandato pasa ante un revisor; un anuncio no traducido nunca queda desfavorecido en la difusión.