Documentación de dokieli

¡Gracias por dedicar tu tiempo a contribuir al proyecto dokieli! Todas las contribuciones son bienvenidas: código, ideas, comentarios y mucho más.

El repositorio de dokieli contiene el código fuente y hay una guía de contribución para empezar. Utiliza dokieli. Pruébalo. Informa de errores o corrígelos. Mejora la documentación. Escribe o traduce artículos y compártelos. Añade ejemplos. Únete al chat para obtener ayuda o debatir. Comparte ideas o abre incidencias sobre las funciones que te gustaría ver. Cada pequeño gesto ayuda a que el proyecto avance.

Ilustraciones de Patrick Hochstenbach, Creative Commons Attribution 4.0 International.

Descripción

Combatir la desinformación, mejorar la alfabetización digital y las habilidades de lectura crítica, y fomentar la publicación fiable mediante herramientas para el análisis de contenidos y la extracción de conocimientos, la validación de contenidos, la evaluación de fuentes y la verificación de datos.

Previsto para

segundo trimestre de 2025–primer trimestre de 2026

Contribuir

Apoyo financiero, código.

Descripción

Reconstruir la extensión utilizando estándares modernos para mejorar la funcionalidad, la experiencia de usuario y la seguridad.

Previsto para

tercer trimestre de 2025–tercer trimestre 2026de2025

Contribuir

Apoyo financiero, código.

Descripción

Reestructurar las partes principales de dokieli (anotaciones, notificaciones, uso compartido) en paquetes npm independientes.

Previsto para

primer trimestre de 2026–segundo trimestre 2026

Contribuir

Apoyo financiero, código.

Descripción

Permitir la edición de documentos en tiempo real por parte de múltiples usuarios.

Previsto para

segundo trimestre de 2026–tercer trimestre 2026

Contribuir

Apoyo financiero, código.

Descripción

Añadir cifrado del lado del cliente para todo el contenido compartido. Ya está disponible una primera implementación para documentos (véase Cifrar y descifrar).

Previsto para

segundo trimestre de 2026–cuarto trimestre 2026

Contribuir

Apoyo financiero, código.

Descripción

Adaptar la interfaz para un uso fluido en dispositivos móviles.

Previsto para

segundo trimestre de 2027–cuarto trimestre 2027

Contribuir

Apoyo financiero, código.

Descripción

Apoyo a la estructuración, búsqueda y vinculación del contenido de los documentos.

Previsto para

cuarto trimestre de 2027–segundo trimestre 2028

Contribuir

Apoyo financiero, código.

La interfaz de usuario (UI) puede ser social o de autor. Los modos se pueden cambiar desde el menú dokieli mediante la operación Editar de .

Social

El modo social se centra en funciones que permiten a los usuarios ver, anotar y compartir contenido. Este es el modo predeterminado cuando el documento se carga sin directivas específicas.

Autor

El modo autor se centra en funciones que permiten a los usuarios editar y publicar el artículo. Permite editar el contenido, la estructura y las anotaciones semánticas.

El menú « » proporciona acceso a funciones clave de primer nivel, como iniciar sesión, crear y publicar contenido, gestionar enlaces y datos, ver la estructura del documento y exportar o compartir el artículo.

Las funciones de dokieli permiten ver, crear y compartir contenido.

Idioma de la interfaz de usuario

El idioma de la interfaz de usuario se puede cambiar en función de las traducciones disponibles. Esta función es independiente de la configuración del idioma del contenido del artículo y las anotaciones.

Iniciar sesión

El inicio de sesión permite al usuario identificarse en dokieli utilizando su identificador personal en línea. dokieli recopila la información vinculada al perfil del usuario para adaptar la interfaz de usuario y personalizar las interacciones en función de sus preferencias.

WebID

¿Qué es WebID?

Un WebID es su identidad digital única en la web descentralizada. A diferencia de las cuentas tradicionales, usted es el propietario y controla su WebID y los datos personales y la información de perfil asociados a él.

¿Por qué utilizarlo?

Le permite iniciar sesión en cualquier aplicación compatible sin compartir datos personales. Sus datos permanecen en su almacén de datos personales, no en los servidores de la aplicación.

¿Dónde obtener una cuenta?

Solid Community Almacenamiento gratuito y WebID mantenidos por la comunidad.

Una vez que tiene un WebID, suele tener el aspecto de una URL. Por ejemplo:

https://username.solidcommunity.net/profile/card#me

Compartir

Compartir permite notificar a personas y grupos específicos sobre un artículo o una parte específica del mismo. Compartir solo anuncia el artículo; quién puede abrirlo se define en Permisos. Los contactos que aparecen en la lista son los que se han descubierto a través del perfil del usuario registrado y que tienen la posibilidad de recibir notificaciones en sus bandejas de entrada. La notificación incluye información mínima sobre el artículo, como quién envió la notificación, cuándo se creó, su licencia y la motivación.

Permisos

Los permisos deciden quién puede leer, editar o controlar un artículo. El usuario que controla un artículo puede concederlos a personas y grupos por su WebID, y el almacenamiento donde está el artículo comprueba quién lo pide en cada solicitud. A las personas con acceso se les puede notificar desde el mismo panel.

Es un acceso basado en la identidad: protege el artículo mientras esté en un almacenamiento que lo haga cumplir. Para proteger el contenido en sí, acabe donde acabe una copia, el artículo también puede cifrarse de modo que solo quienes tengan las claves indicadas puedan leerlo. Ambas opciones pueden usarse por separado o juntas.

Claves

dokieli puede cifrar un documento o una anotación para que solo puedan leerlo las personas con quienes se comparte, y firmar lo que se publica para que otros puedan comprobar de quién viene y que no se ha alterado desde entonces. Ambas cosas se apoyan en claves que el usuario crea en su propio navegador. A diferencia de los permisos, que dependen del almacenamiento, lo que protege una clave sigue protegido allá donde se copie el documento.

Hay dos tipos de clave, cada una con una parte pública y una privada. Una clave de cifrado permite a otras personas cifrar documentos para el usuario y al usuario leer lo que se comparte con él. Una clave de firma permite al usuario firmar lo que publica. Una sola frase de contraseña protege ambas, así que desbloquear una vez cubre las dos.

Las claves se añaden, nunca se reemplazan. dokieli no tiene forma de retirar una clave ni de revocar una que ya se ha publicado, porque todo lo cifrado con una clave anterior tiene que seguir siendo legible. Una clave expuesta sigue siendo válida, y el único remedio está fuera de dokieli.

Crear claves

Cada clave se crea en el navegador, en el propio dispositivo del usuario, y la mitad privada nunca se envía a ninguna parte de forma legible. La clave de cifrado y la de firma se crean por separado: la primera al activar el cifrado, la segunda desde la sección Claves en los ajustes del menú.

Frase de contraseña

Una sola frase de contraseña, de al menos doce caracteres, protege tanto la clave de cifrado como la de firma. Bloquea las claves privadas dondequiera que se guarden, se pide una vez por sesión y nunca se envía a ninguna parte. No hay recuperación si se olvida: las claves, y todo lo cifrado con ellas, quedan ilegibles.

Claves en el almacenamiento remoto

Cuando el usuario tiene un almacenamiento personal, cada clave se guarda allí, todavía bloqueada por la frase de contraseña, en un lugar que solo esa persona puede leer. Una clave guardada se escribe una vez y no se modifica después, así que se añade una nueva en lugar de sobrescribir la anterior. La ubicación se registra en el índice de tipos del usuario, que es como dokieli vuelve a encontrar las mismas claves desde otro dispositivo.

Claves en el dispositivo

Una copia de cada clave, también bloqueada por la frase de contraseña, se conserva en el navegador del dispositivo, de modo que las claves siguen siendo utilizables sin almacenamiento personal y sin red. Borrar los datos del navegador la elimina. Sin almacenamiento personal, esta copia y cualquier archivo que el usuario haya descargado son las únicas que existen.

Desbloquear claves

Las claves se desbloquean una vez por sesión introduciendo la frase de contraseña, y permanecen desbloqueadas hasta que se vuelven a bloquear, se cierra la pestaña del navegador o el usuario cierra sesión.

Publicar una clave pública

La mitad pública de cada clave se publica en el perfil WebID del usuario: la clave de cifrado para que otros puedan cifrar documentos para esa persona, y la clave de firma para que otros puedan verificar sus firmas.

Encontrar la clave de un contacto

Para cifrar un documento para los contactos del usuario, dokieli necesita poder descubrir sus claves públicas. Los contactos que no han publicado ninguna siguen apareciendo en la lista, con un aviso de que el documento no se puede descifrar para ellos.

Cifrar y descifrar

El documento entero se cifra en el navegador antes de guardarse, metadatos incluidos, de modo que el servidor que lo almacena nunca ve el contenido legible y el documento no se puede encontrar, consultar ni indexar mientras está cifrado. El documento cifrado no nombra a las personas para quienes se cifró. Quien lo recibe y lo abre inicia sesión, desbloquea su propia clave con su frase de contraseña y el contenido se descifra en el momento. Activar o desactivar el cifrado guarda el documento de inmediato cuando el usuario está conectado y tiene permiso de escritura.

Destinatarios

Quién puede leer un documento cifrado se decide en Permisos. Dar acceso a alguien vuelve a cifrar el documento para esa persona usando la clave de su perfil, y se le puede notificar desde el mismo sitio. Compartir un documento solo lo anuncia, y avisa cuando la persona no podría leerlo.

Exportar claves

Las claves se pueden descargar desde la sección Claves en los ajustes del menú, ya sea como un archivo de copia de seguridad que sigue protegido por la frase de contraseña, o como el par de claves en sí, en archivos PEM, para usarlas con otras herramientas. Lo segundo no está protegido: quien tenga ese archivo puede leer todo lo cifrado para el usuario y firmar en su nombre.

Importar claves

Un archivo de copia de seguridad o un par de claves descargado antes se puede importar, que es como se llevan las claves a otro dispositivo o se restauran cuando ya no está la copia del navegador. Un par de claves llega sin protección, así que al importarlo se pide una frase de contraseña para protegerlo en este dispositivo.

Responder

Se puede responder a un artículo con una nota y tener su propio idioma y licencia. El usuario puede especificar dónde desea guardar su respuesta navegando hasta una ubicación en un almacenamiento personal o un servicio de anotaciones.

Notificaciones

La función Notificaciones ayuda a ver tus propias interacciones y actividades en los documentos, así como las de tus contactos, como comentarios, anotaciones, reacciones y marcadores. Inicia sesión en dokieli para que pueda encontrar estas notificaciones.

Marcadores

El documento o el texto seleccionado se pueden marcar con un marcador, donde el usuario puede incluir una nota y asignar etiquetas.

Comentarios

Selección a nivel de nodo o de texto para una anotación que incluye una descripción y etiquetas.

Descripción

Una nota para indicar una nota al pie. Se utiliza como parte del propósito de marcar y comentar.

Resaltar

Selección a nivel de nodo o texto que proporciona al usuario un URI que puede utilizar para enlaces profundos y referencias.

Etiquetado

El usuario puede asociar etiquetas (texto en lenguaje natural) al texto seleccionado, que se utiliza como parte del propósito de las anotaciones, como marcar, responder y comentar.

Aprobar

Acuerdo general con el texto seleccionado. Una nota opcional puede indicar por qué la selección es un punto fuerte o un argumento convincente.

Desaprobar

Desacuerdo general con el texto seleccionado. Una nota opcional puede indicar por qué la selección es un punto débil, un error o inexacta.

Especificidad

Solicitud de aumentar la especificidad del texto seleccionado. Una nota opcional puede indicar que se necesita una cita o más especificidad.

Nuevo

Se puede crear temporalmente un nuevo artículo hasta que se guarde en el almacenamiento personal o en el almacenamiento local. Para conservar el artículo a largo plazo, el usuario puede Guardar o Guardar como el artículo.

Abrir

Un documento se puede abrir (importar) desde un sistema de archivos local o especificando la URL del recurso en la web. El navegador de recursos se puede utilizar para navegar hasta el documento de interés en el almacenamiento personal o el servicio de anotaciones. Hay vistas personalizadas disponibles al importar algunos formatos de datos, como:

Documentos HTML

Al abrir un documento (X)HTML, solo se importa el contenido. CSS, JavaScript y otros elementos adicionales se excluyen por motivos de seguridad. Tras la importación, dokieli se puede utilizar como de costumbre con todas sus funciones.

Geo y estadísticas

El usuario puede ver un mapa (OpenStreetMap) que incluye una ruta, junto con datos detallados de GPS y extensión en una tabla. Estos datos incluyen el periodo de tiempo, la latitud, la longitud, la altitud, la frecuencia cardíaca, la cadencia, la velocidad, la temperatura del aire, la temperatura del agua y la profundidad. La tabla también proporciona un resumen de la fecha de publicación, el editor, el actor, la distancia total, el tiempo total, el ritmo medio, la frecuencia cardíaca media, el desnivel positivo y el desnivel negativo. Además, se identifica la ciudad más cercana a la ruta y se enlaza con Wikidata.

Recopilación de actividades

El usuario puede ver una lista cronológica de interacciones sociales y actividades relacionadas con el contenido, como publicar, dar me gusta, seguir y compartir, dentro de una recopilación.

Otros datos

Los datos en formatos no compatibles o no reconocidos se mostrarán tal cual, sin ningún tipo de procesamiento.

Guardar

Un artículo se puede guardar en su estado y ubicación actuales, lo que permite volver al mismo contenido y URL más tarde, cuando se disponga de acceso.

Guardar como

Un artículo se puede guardar en su estado actual en una ubicación específica del almacenamiento personal. Esta función utiliza el navegador de recursos para navegar por las URL HTTP.

Configurar bandeja de entrada

Se puede asignar una bandeja de entrada a un artículo o anotación especificando su ubicación mediante el explorador de recursos, de modo que se puedan compartir las notificaciones sobre el artículo o la anotación.

Establecer anotación

Se puede asignar un servicio de anotación a un artículo o anotación especificando su ubicación mediante el explorador de recursos, de modo que las anotaciones de otros usuarios se puedan copiar opcionalmente a esta ubicación.

dokielizar

Normaliza el documento para que sea válido y normalizado, e incluye los scripts dokieli para que la aplicación se pueda utilizar en la versión derivada.

Datos de derivación

Cuando se comprueba la inclusión de datos de derivación, la información derivada y sobre se incluye en el documento creado.

Informe de accesibilidad

Proporciona información adicional sobre la accesibilidad del documento actual para que el autor pueda encontrar formas de mejorar la accesibilidad del contenido.

Detalles de almacenamiento

El usuario puede examinar la información sobre el almacenamiento, como su ubicación, nombre, descripción, propietarios, política de persistencia de URI y políticas de derechos digitales, así como estar informado sobre cualquier conflicto con sus políticas preferidas, y las opciones de suscripción a notificaciones y suscripción a cambios en directo.

Versión

Genera una copia derivada del documento actual como un recurso mutable que incluye la procedencia.

Inmutable

Genera una copia derivada del documento actual como un recurso Memento inmutable o congelado, incluyendo la procedencia. Crea o actualiza un Memento TimeMap que incluye una referencia al recurso inmutable.

Memento

El usuario puede acceder al memento (historial de versiones) de un documento.

Enlaces robustos

Para ayudar a mitigar la deriva de contenido y la rotura de enlaces, estos se pueden mejorar con contexto adicional, como una URI de instantánea del Archivo de Internet, una marca de tiempo de cuándo se creó el enlace y otros metadatos relevantes.

Archivar

Envía una solicitud de archivo del artículo actual a Internet Archive Wayback Machine.

¿Ah, sí?

Ayuda a evaluar la credibilidad de un fragmento seleccionado o de todo el documento. Busca nombres de personas, organizaciones y lugares, los consulta en Wikidata y en la red Nanopub, consulta quién registró el dominio del documento y puede indicar qué frases son afirmaciones factuales que vale la pena verificar. Se abre desde la barra de herramientas para una selección, o desde Herramientas en el menú para todo el documento. Cada servicio web solo se contacta con el consentimiento de quien lee; véase servicios de terceros.

Búsqueda de nombres

Los nombres de personas, organizaciones, lugares y otras cosas los encuentra el servicio de análisis de texto de ¿Ah, sí? con modelos de aprendizaje automático de pesos abiertos: los modelos de spaCy para inglés y español. El texto solo se envía al servicio con el consentimiento de quien lee. Si no se permite, o no se puede contactar con el servicio, los nombres se buscan en el navegador con compromise para el inglés y es-compromise para el español, que usan listas de palabras y reglas gramaticales y son mucho menos precisos. En ambos casos pueden pasarse nombres por alto o clasificarse mal, y en otros idiomas no se buscan nombres. Los nombres encontrados se resaltan en el texto según su tipo: personas, organizaciones, lugares, otros nombres y siglas. Al señalar un nombre resaltado se muestra cómo se ha marcado y con qué método, y al seleccionarlo se muestran sus coincidencias en Wikidata.

Verificación de afirmaciones

Etiqueta cada frase como afirmación factual que vale la pena verificar, afirmación factual poco importante o no factual, con la confianza del modelo. No indica si una frase es verdadera. El servicio de dokieli usa ClaimBuster mDeBERTa, un clasificador de aprendizaje automático entrenado con el conjunto ClaimBuster de frases etiquetadas de debates presidenciales de Estados Unidos (1960 a 2016). No es IA generativa ni un gran modelo de lenguaje. Se entrenó solo con textos en inglés, así que no funciona de forma fiable en otros idiomas. Cada frase se analiza por separado, sin el resto del documento, así que una afirmación puede estar explicada o respaldada en otra parte del documento sin que el análisis lo vea. Al analizar una selección se muestran todas las frases; al analizar todo el documento solo se muestran las que vale la pena verificar, subrayadas en el texto. Las explicaciones de cada resultado vienen de reglas sencillas del servicio, no del modelo. No se envía nada hasta seleccionar «Verificar afirmaciones». El texto enviado se usa solo para responder a la solicitud: el servicio de dokieli no lo guarda, no lo usa para entrenar ningún modelo y no lo vincula con quien lee. Véase también la política de privacidad de los servicios de dokieli.

Reglas de las explicaciones

El «Por qué» de cada resultado de la verificación viene de reglas sencillas del servicio de verificación, independientes del modelo que elige la etiqueta. Los tipos de explicación vienen del artículo del conjunto de datos ClaimBuster (A Benchmark Dataset of Check-worthy Factual Claims): su tabla 1 y su guía de anotación, que sirvieron de guía a quienes etiquetaron los datos. Una afirmación que vale la pena verificar puede presentar datos con una cantidad, afirmar algo sobre un hecho pasado o mezclar opinión con un hecho verificable. Una afirmación factual poco importante contiene hechos que el público no querría verificar. Una frase no factual puede ser una pregunta, una promesa o un plan futuro, una opinión o una expresión retórica. Qué palabras activan cada explicación es decisión del servicio, por ejemplo «creo que» o «debería» para las opiniones y «vamos a» o el tiempo futuro para los planes, con listas para el inglés y el español. Las explicaciones describen la frase; no son las razones del modelo para su etiqueta.

Servicio de verificación propio

Se puede ejecutar el servicio de análisis de texto de ¿Ah, sí? por cuenta propia, por ejemplo en el propio ordenador para que el texto no salga de él, y escribir su dirección en la pestaña de verificación. Entonces se usa para buscar nombres y verificar afirmaciones. La dirección solo se guarda en ese dispositivo. El servicio usa el modelo ClaimBuster mDeBERTa para etiquetar frases y el modelo spaCy para inglés para dividir el texto en frases; ambos se pueden descargar. Las consultas WHOIS siempre usan el servicio de dokieli.

Modelo piloto para español

Para quienes participan en el piloto, el servicio de dokieli puede analizar textos en español con un modelo entrenado en español. Parte de sus datos de entrenamiento, el conjunto CLEF CheckThat! 2024 en español, solo se puede usar con fines no comerciales, así que el modelo solo se usa con un código de acceso, que se guarda en el dispositivo. El modelo también se puede descargar y ejecutar en un servicio propio.

Wikidata, nanopublicaciones y WHOIS

Los nombres encontrados se consultan en Wikidata, que muestra posibles coincidencias con su descripción, y en la red Nanopub, que muestra nanopublicaciones que mencionan el nombre exacto, con su autor, fecha y contenido, y su procedencia e información de publicación en más detalles. Las consultas se hacen para un máximo de los 20 nombres más mencionados. La consulta del dominio muestra quién registró el dominio del documento y cuándo. Se pregunta directamente al registro del dominio con RDAP, encontrando el registro mediante la lista RDAP de IANA, y solo se usa WHOIS a través del servicio de dokieli para los registros que no admiten RDAP. Solo se envía el nombre del dominio. Algunos registros no publican datos de registro.

Generar feed

Permite la creación y publicación de una fuente web personalizada a partir de una lista seleccionada de documentos del almacenamiento personal, con opciones para establecer el título, el idioma, la licencia y el formato de la fuente, por ejemplo, RSS o Atom.

Exportar

El usuario puede exportar el artículo como HTML y guardarlo en su sistema de archivos local.

Imprimir

Activa el navegador para imprimir el documento actual.

Editar

La función Editar ofrece herramientas de autoría para dar formato, vincular y estructurar artículos. Las ediciones son locales, a menos que se habilite el autoguardado o se confirmen los cambios mediante Guardar, Guardar como, Versión o Inmutable. Las opciones de formato estándar incluyen encabezados, cursiva, negrita, listas ordenadas y sin ordenar, código en línea, texto preformateado, hipervínculos, citas en línea, imágenes y tablas. Entre las capacidades adicionales se incluyen:

Objetos interactivos e incrustables

Se pueden incrustar gráficos y otros elementos visuales, como minigráficos, basados en datos estadísticos.

Anotación semántica

El contenido se puede marcar semánticamente para mejorar la legibilidad por parte de las máquinas (RDFa), sin dejar de ser legible para los humanos.

Fuentes de datos

Las búsquedas, por ejemplo de citas o de datos para tablas, consultan Specref, Wikidata y Open Library. Los identificadores se resuelven directamente en un enlace: ISBN, DOI, ORCID o entidad de Wikidata.

Notas al pie y citas

Se pueden añadir notas al pie y citas al texto seleccionado, lo que proporciona referencias contextuales y sólidas. Se puede notificar a las entidades citadas para que hagan referencia a ellas. Las referencias pueden incluir ISBN o URL. En el caso de las citas contextuales, por ejemplo, una entidad citada (un argumento) puede hacer referencia a una entidad citada (resultados de observación) como prueba factual. También se admiten búsquedas bibliográficas de especificaciones técnicas con fines de cita.

Widgets de autoría

Las opciones de creación adicionales incluyen añadir colaboradores y notificarles, establecer el idioma del documento, la licencia, la bandeja de entrada, la respuesta, el estado, el tipo y el conjunto de pruebas.

Autoguardado

Mientras el usuario edita su artículo, el documento se guarda automáticamente en el almacenamiento local. Cuando la opción de guardado automático está activada, los cambios se sincronizan con el recurso remoto.

Fuente

Permite la edición directa del estado actual del artículo. La actualización es temporal hasta que se confirma mediante funciones como Guardar, Guardar como, Versión o Inmutable.

Incrustar datos

Permite incrustar y actualizar datos complementarios que se almacenarán con el artículo utilizando sintaxis RDF como Turtle, JSON-LD y TriG.

Registro de mensajes

Muestra todos los mensajes generados por dokieli, por ejemplo, comentarios o notificaciones resultantes de acciones específicas.

Eliminar

Elimina el artículo o la anotación del almacenamiento personal, cuando se dispone de acceso.

Vistas

El menú dokieli muestra las hojas de estilo principales y alternativas que se detectan en el HTML. La opción «Nativa» siempre está disponible y desactiva todas las demás hojas de estilo, lo que permite aplicar los estilos predeterminados del agente de usuario. Cuando se selecciona una vista, por ejemplo, «Básica» (que es la hoja de estilo principal actual para este artículo), esta se convierte en la hoja de estilo principal, mientras que las demás se establecen como alternativas y se desactivan.

Vista gráfica

Muestra una visualización gráfica de la semántica subyacente del documento, incluyendo una lista de recursos, el número de declaraciones, nodos únicos, creador, licencia y una leyenda. La visualización se puede exportar como SVG.

Revisar cambios

La función de revisión de cambios permite comparar las versiones locales y remotas de un documento cuando ambas han cambiado, y elegir entre conservar las ediciones locales, descartarlas en favor de la versión remota o conciliar manualmente y aplicar los cambios a ambas.

Lista de elementos

Opciones para generar e incluir varios tipos de contenido, como:

Contenido

Genera una tabla de contenidos.

Figuras

Enumera todas las figuras del documento con enlaces a cada una de ellas.

Tablas

Enumera todas las tablas del documento con enlaces a cada una de ellas.

Abreviaturas

Enumera las abreviaturas del documento junto con sus definiciones.

Citas

Enumera todas las citas del documento con enlaces a cada una de ellas.

Conceptos

Enumera los esquemas conceptuales y los conceptos del documento con enlaces. También se pueden incluir conceptos adicionales de recursos externos referenciados, junto con una visualización gráfica de los conceptos.

Requisitos

Crea una tabla de requisitos de conformidad y cobertura de pruebas (para especificaciones técnicas), que muestra el tema del requisito, el nivel, la declaración y los casos de prueba relacionados con enlaces. Opcionalmente, muestra los cambios entre la versión actual y la anterior del documento, junto con los detalles del registro de cambios.

Advertencias

Crea una tabla de advertencias (en especificaciones técnicas), incluyendo sus niveles, declaraciones y enlaces.

Referencias

Enumera las referencias del documento con enlaces a cada una de ellas.

Metadatos del documento

Basándose en los datos estructurados subyacentes del documento, muestra información sobre sus colaboradores, como editores y autores, número de citas, requisitos, avisos, conceptos, declaraciones, así como el tiempo estimado de lectura, el número de caracteres, palabras y bytes.

Los artículos, las anotaciones y las notificaciones pueden incluir componentes comunes que proporcionan información o funcionalidades adicionales.

Licencia

Las licencias y los derechos se pueden especificar para los artículos y las anotaciones a partir de una lista de opciones de Creative Commons, por ejemplo, CC BY 4.0. Las notificaciones, por defecto, utilizan la licencia CC0 1.0 Universal.

Idioma

El idioma de un artículo o anotación se puede establecer a partir de una lista (182 idiomas disponibles, por ejemplo, armenio). Alternativamente, el idioma se puede aplicar a selecciones de texto o nodos específicos utilizando el anotador semántico.

En respuesta a

Identifica un recurso al que el recurso actual es una respuesta.

Explorador de recursos

El explorador de recursos forma parte de funciones como Nuevo, Abrir, Guardar como y Generar fuente, y le permite navegar por ubicaciones como un almacenamiento personal, un servicio de anotación o una colección de actividades. Si se conoce una ubicación de almacenamiento personal, se utiliza de forma predeterminada; de lo contrario, la ubicación de inicio puede basarse en un servicio de anotación al que hace referencia el artículo.

Selección de la URL base

Al crear o guardar documentos, los recursos multimedia (por ejemplo, enlace principal, [src], objeto[datos]) se normalizan para utilizar la URL base del documento como su ruta absoluta (la opción Usar referencias tal cual ). Si se selecciona Copiar al almacenamiento, las URL relativas permanecen sin cambios, ya que el proceso de copia reutiliza las mismas rutas de archivo.

Portapapeles

Se puede copiar texto, código y tablas (en formato CSV) al portapapeles.

Fragmentos

Hay fragmentos en los que se puede hacer clic para facilitar las referencias específicas dentro del documento.

Vista de pestañas

Los elementos de navegación se presentan en una vista con pestañas para facilitar el acceso.

dokieli es una aplicación que se ejecuta en el navegador y puede alojarse en cualquier servidor web. No recopila, transmite ni almacena datos sobre sus usuarios en servidores remotos, y no vende ni distribuye los datos que procesa. La aplicación no incluye analíticas, telemetría ni seguimiento. El contenido producido con dokieli se envía solo a los destinos que elige el usuario. Algunas acciones también envían notificaciones en nombre del usuario; una notificación identifica al usuario por su WebID cuando ha iniciado sesión. Esta política refleja los deberes del agente de usuario que guían a dokieli.

dokieli no usa cookies.

El sitio web dokie.li es un servidor estático sencillo. Cuando los recursos de la aplicación (HTML, CSS, JavaScript) se sirven desde dokie.li, el servidor recibe y registra las solicitudes HTTP habituales, como cualquier servidor web. Esos registros no se procesan para analíticas, elaboración de perfiles ni ningún otro fin más allá del funcionamiento normal del servidor. Cuando dokieli se despliega en otro lugar, el servidor de dokie.li no interviene en servir la aplicación. Sin embargo, la ayuda integrada (los botones de información) obtiene la documentación de https://dokie.li/docs de forma predeterminada, o de otro origen si quien despliega dokieli lo configura. Son solicitudes normales del navegador entre orígenes y no revelan nada más de lo que el navegador ya envía, incluido el origen del sitio que despliega dokieli, que se envía al origen de la documentación. El sitio web y los servicios de dokie.li funcionan en servidores en Suiza, alojados por Infomaniak, donde se aplica la ley suiza de protección de datos; la Unión Europea reconoce que Suiza ofrece una protección adecuada de los datos personales.

Algunas funciones usan servicios web que el proyecto dokieli ofrece en dokie.li, como el servicio de análisis de texto de ¿Ah, sí? en ohyeah.dokie.li. Como los demás servicios web, solo se contactan con el consentimiento del usuario y cuando se usa una función. Una solicitud lleva solo lo que la función necesita, como el texto que se analiza y su idioma, o un nombre de dominio; no lleva el WebID del usuario, sus credenciales ni cookies, ni la dirección del documento que se está leyendo.

El contenido de una solicitud se usa solo para responderla: no se guarda ni se usa para entrenar o mejorar ningún modelo, y los códigos de acceso, como los de los modelos piloto, se comprueban pero no se guardan. Como en el sitio web dokie.li, el servidor guarda los registros habituales de solicitudes HTTP, con la dirección IP, la hora y la dirección solicitada, pero no el contenido de las solicitudes. Para evitar un uso excesivo, también guarda brevemente, solo en memoria, la cuenta de las solicitudes recientes de cada dirección IP. Cuando un servicio necesita a un tercero para responder, como un registro de dominios para una consulta WHOIS, el propio servicio hace esa solicitud, así que la dirección IP del usuario no se revela a ese tercero. Los modelos se descargan al instalar el servicio, así que no se envía contenido de las solicitudes al lugar donde están publicados. Quien prefiera que su texto no salga de su dispositivo puede ejecutar el servicio por su cuenta.

dokieli hace solicitudes salientes a recursos y servicios según lo indique el usuario. Esas solicitudes salen directamente del navegador del usuario, lo que revela su dirección IP al servidor de destino. Es una característica habitual de la navegación web, no algo propio de dokieli. Se aplica al obtener documentos, anotaciones, perfiles u otros datos enlazados, así como al enviar notificaciones o iniciar sesión mediante un proveedor de WebID. Los documentos y perfiles pueden apuntar a recursos relacionados en otros servidores, como sus anotaciones, su bandeja de entrada o su historial de versiones; cuando dokieli sigue esos enlaces como parte de una acción, la solicitud va al servidor que indica el enlace. Los usuarios pueden configurar un proxy preferido si quieren limitar la revelación de su IP a servidores externos.

Algunas acciones envían notificaciones a bandejas de entrada, como se describe en Linked Data Notifications. dokieli muestra qué bandejas de entrada pueden recibir notificaciones, como la de un documento o la de un contacto, y el usuario elige a cuáles se notifica; de forma predeterminada solo se anuncia contenido público y sin cifrar. Una notificación identifica el elemento al que se refiere, su licencia, la hora y, cuando el usuario ha iniciado sesión, su WebID como actor. Los resultados de la entrega se guardan en el registro de mensajes, y lo que conservan los servidores destinatarios depende de sus propias políticas.

dokieli usa el almacenamiento local del navegador para el guardado automático y el acceso sin conexión. Cuando el usuario ha iniciado sesión, también se guarda un token de actualización para mantener la sesión activa sin tener que iniciar sesión una y otra vez. También se guarda en el almacenamiento del navegador un registro de los mensajes de dokieli y de los resultados de las entregas, para que siga disponible entre sesiones; al cerrar sesión se borra, y puede borrarse en cualquier momento desde el panel Mensajes. Las decisiones de consentimiento del usuario sobre los servicios web también se guardan en el dispositivo. Como la preferencia de idioma, son ajustes y no registros de actividad: no están vinculadas a una cuenta, no se borran al cerrar sesión, y pueden cambiarse en Ajustes, en el menú de dokieli, o eliminarse borrando los datos del sitio en el navegador. En un dispositivo compartido, el contenido y las credenciales guardados en el almacenamiento local pueden quedar visibles para otras personas que usen el mismo perfil del navegador. Al cerrar sesión se borran del almacenamiento local las credenciales de autenticación y los datos de la sesión, incluidos los tokens guardados. En el modo de navegación privada o de invitado, el almacenamiento local se borra automáticamente al terminar la sesión. En dispositivos compartidos conviene cerrar sesión al terminar, o usar la navegación privada, para que también se elimine el contenido que quede. Puede conservarse en el almacenamiento del navegador, entre sesiones y por comodidad, la preferencia de idioma de la interfaz. No contiene información identificativa ni está vinculada a ninguna cuenta o perfil.

dokieli usa un service worker para guardar en caché los recursos propios de la aplicación y poder usarla sin conexión. El service worker no guarda datos del usuario, contenido ni información identificativa, y no hace ningún seguimiento.

Algunas funciones hacen solicitudes salientes a servicios de terceros. Esto incluye los recursos que los autores incrustan o referencian en documentos y anotaciones, que pueden provocar solicitudes a servidores externos cuando se carga ese contenido. También incluye funciones específicas. La función de archivo, por ejemplo, envía una solicitud de captura a la Wayback Machine del Internet Archive, que incluye la URL que se archiva y la dirección IP del usuario. Al usar esas funciones, el usuario interactúa directamente con el tercero correspondiente, y se aplican las políticas propias de ese servicio. Los recursos protegidos quedan excluidos del archivo público, ya que la solicitud de captura no lleva credenciales.

A continuación se enumeran los servicios web con los que pueden contactar las funciones de dokieli. Solo se hace una solicitud cuando el usuario usa la función correspondiente, y la primera vez que una función contactaría con un servicio, dokieli pide el consentimiento del usuario. Las decisiones pueden cambiarse en cualquier momento en Ajustes, en el menú de dokieli. Los servicios que configura el propio usuario, como proveedores de identidad, almacenamiento, forjas git o un punto de consulta personalizado, se contactan según sus propios ajustes.

DOI

Resuelve identificadores de objetos digitales en metadatos, para citas y consultas de tablas.

Internet Archive

Crea capturas de recursos para el archivo y los enlaces robustos.

Linked Open Research Cloud

Un destino opcional para compartir documentos con la comunidad de Linked Research.

Nanopub network

Encuentra anotaciones del documento actual publicadas como nanopublicaciones. Solo se envía la dirección del documento. ¿Ah, sí? también busca nanopublicaciones que mencionan nombres encontrados en el texto; solo se envían esos nombres.

Oh yeah? text analysis service

Lo usa ¿Ah, sí?. Encuentra nombres en el texto, indica qué frases son afirmaciones factuales que vale la pena verificar y consulta el registro del dominio del documento. La búsqueda de nombres y la verificación de afirmaciones envían el texto que se analiza; la verificación de afirmaciones solo se hace cuando el lector la pide. WHOIS se usa solo para los registros que no tienen RDAP, y solo envía el nombre de dominio. Sin consentimiento, los nombres se buscan en el navegador, con menos precisión. Los lectores pueden usar un servicio que ejecuten por su cuenta para la búsqueda de nombres y la verificación de afirmaciones. Véase también la política de los servicios de dokie.li.

Open Library

Consulta metadatos de libros, por ejemplo por ISBN, para citas y consultas de tablas.

OpenStreetMap

Nombra y describe ubicaciones geográficas.

ORCID

Consulta información de investigadores y colaboradores, para citas y consultas de tablas.

RDAP domain registries

Lo usa ¿Ah, sí? para consultar quién registró el dominio del documento y cuándo. dokieli lee la lista de la IANA para encontrar el registro de la terminación del dominio y le hace la consulta. Solo se envía el nombre de dominio.

Specref

Consulta datos bibliográficos de especificaciones técnicas, para citas y consultas de tablas.

Wikidata

Proporciona datos de entidades para citas, consultas de tablas, conceptos y sugerencias, y posibles coincidencias para los nombres que encuentra ¿Ah, sí?; solo se envían los nombres.

Para preguntas o inquietudes sobre privacidad, abra una incidencia en el gestor de incidencias en https://git.dokie.li/dokieli/.