Exportación masiva de fuentes de publicaciones sin procesar con marcado

Hola,

nuestra empresa utiliza Discourse para dar soporte a nuestros clientes y fortalecer las relaciones con ellos. Para la incorporación de personal, creamos documentación utilizando Categorías de Documentación y DiscoTOC, lo cual funciona muy bien.

Sin embargo, me gustaría solicitar una función que permita exportar las fuentes de la documentación – específicamente el texto sin formato con marcado – a un archivo de texto plano.

:information_source: Soy consciente de la opción de impresión PDF del navegador, que no ayuda cuando se necesitan fuentes sin procesar en lugar de analizadas. También conozco la función de copia de seguridad integrada y las consultas a la base de datos, pero estas no son soluciones prácticas para la administración del frontend.

Por ahora, mi flujo de trabajo es: Editar la publicaciónSTRG-A, STRG-Ccrear / abrir un archivo de textoSTRG-V, STRG-SDescartar Edición… siguiente publicación.

Una opción de exportación masiva integrada proporcionaría varios beneficios:

  • Mantenimiento mucho más fácil de las bases de conocimiento
  • Mejores flujos de trabajo de copia de seguridad y versionado para administradores en el frontend
  • Reutilización flexible del contenido fuera de Discourse

:right_arrow: Dicha función sería una verdadera ganancia de productividad para las comunidades que utilizan Discourse como centro de documentación, no solo para soporte.

Me interesaría conocer sus opiniones.

Saludos

2 Me gusta

Uno de mis problemas es tratar las solicitudes de características como si fueran solicitudes de soporte. Oops, lo he vuelto a hacer. Perdón si esto no ayuda.

Así que quieres algo como esto: https://meta.discourse.org/posts/1849580/raw o esto: https://meta.discourse.org/raw/381447 o esto https://meta.discourse.org/raw/381447/1

Oh. Quieres el texto sin formato de todas las publicaciones del tema.

Esto no es una solución, pero una versión mejorada de eso sí lo es. Pero eso no ahorra muchos clics.

Eso es bastante fácil de automatizar con algunas herramientas de línea de comandos. Una inteligente obtendría el json del tema para ver cuántas publicaciones había y luego las obtendría todas, quizás haciendo una pausa para lidiar con la limitación de velocidad.

Un componente temático podría darte enlaces al texto sin formato de cada publicación. Un plugin podría hacer lo que quieres.

3 Me gusta

Hola Jay,

Gracias por tu respuesta.

Esta solución ya se discute en How to iterate over all the topics in order to export them as Markdown?, pero no es práctica para documentaciones más grandes (→ eficiencia) y administración de frontend (→ competencia).

Así que sí… no es soporte, sino una solicitud de función real de mi parte :wink:

Saludos

2 Me gusta

Creo que 📄 Copy Post Component, que copia la publicación directamente, podría ser útil en este caso. Reduce

a un solo clic. Pero todavía no es una copia masiva.

5 Me gusta

Alivia el dolor… guardado en marcadores.

Gracias

3 Me gusta

Puedes crear una consulta de Explorador de datos que devuelva posts.raw y llamar a la consulta usando la API.

7 Me gusta

Gracias por el consejo, Richard :slight_smile: Le echaré un vistazo a Data Explorer y a las llamadas API cuando tenga oportunidad. Aun así, eso es solo un gancho, no una característica.

Toma el plugin Doc Categories como ejemplo: para construir documentación, todo lo que técnicamente necesitas es una publicación de índice que contenga los enlaces a todos los temas. Pero el plugin añade algo extra: navegación automática de páginas.

Esa es exactamente la clase de solicitud de característica que estoy haciendo: una funcionalidad adicional que ayude a los usuarios habituales, no solo otra solución alternativa para usuarios avanzados o personal de TI.

3 Me gusta

Si deseara tal función, me gustaría que me diera un archivo zip que contuviera todas las fuentes de markdown referenciadas por el índice de documentos.

¿Cómo se querría nombrar los archivos individuales en ese caso?

¿Podría describir su flujo de trabajo previsto con más detalle?

Si fuera a construir un flujo de trabajo de documentación como el que describe, preferiría crear una opción para montar markdown sin procesar en el sistema de archivos, lo que permitiría que herramientas automatizadas adicionales funcionaran con él.

No entiendo este punto.
¿Por qué no quiere presentar su documentación a través de Discourse?

Hola Thomas, un contenedor zip funcionaría perfectamente :wink: No hay ningún flujo de trabajo detrás, solo el deseo de mantener una copia de seguridad simple.

1 me gusta

No puedo imaginar cómo un usuario habitual usaría las fuentes de publicación sin procesar.

3 Me gusta

Quizás sea porque no eres un usuario normal.

1 me gusta

Quizás puedas darme un buen ejemplo en lugar de responder con un ataque ad hominem. Incluso tu publicación inicial habla sobre administradores y personas que gestionan bases de conocimiento.

Lo siento, compartiste tus opiniones personales y yo solo estaba respondiendo, sin ninguna intención de ofender.

Por ejemplo, las personas que administran bases de conocimiento, como los administradores de conocimiento que crean contenido como administradores pero tienen un conocimiento técnico limitado, quieren manejar su contenido ellos mismos y poder respaldarlo localmente.

3 Me gusta

No consideraría a un administrador de conocimientos un usuario habitual, es un rol muy específico.

Dejemos el debate sobre el “usuario normal” para otro momento, por favor.

1 me gusta

Entonces, el explorador de datos sería una solución perfectamente válida.
También puedes hacer que esa consulta esté disponible para usuarios que no sean administradores.

1 me gusta

¡Hola @soeren-1 y bienvenido a nuestra comunidad! :hugs:

¡Tu solicitud de función parece interesante! Creo que es genial tener este tema disponible para que otros que tengan una configuración similar puedan participar. Quizás algún día algo así llegue a la interfaz de usuario. Pero creo que aún no has presentado un caso para que sea una función de uso generalizado.

Eres nuevo aquí, así que déjame contarte algunas cosas que quizás no te resulten obvias. Agregar funciones lleva tiempo y recursos, por lo que normalmente se agregan nuevas funciones a Discourse cuando uno de nuestros clientes empresariales lo solicita o cuando hay mucha demanda, por ejemplo, regla de tres. A menudo, comienzan como complementos o componentes antes de llegar finalmente a nuestro producto principal.

Para muchos casos únicos, la API de Discourse y el explorador de datos proporcionan soluciones rápidas y sencillas que suelen ser “suficientemente buenas”. ¡Reconozco que no es lo que estás pidiendo aquí! Pero a veces, intentar resolver un problema utilizando la API o una consulta del explorador de datos puede ayudar a justificar la adición de funcionalidad o a encontrar una mejor manera de resolver un problema en particular.

¿Has visto cómo las consultas del explorador de datos se pueden poner a disposición de grupos y pueden tener una interfaz de usuario para especificar parámetros? Esto es adecuado para “usuarios habituales” y podría funcionar para ti y tu equipo como una solución provisional y para ayudarte a defender tu nueva idea de función aquí. No sé si ya existe una consulta adecuada para que empieces, el lugar para buscarla es Data & reporting.

@rgj ¡Creo que eres un tipo normal, sin importar lo que digan los demás!

d he's just a regular guy like you and me..gif

3 Me gusta

Gracias por la bienvenida, las aclaraciones y los consejos, Tobias.

No estoy tan seguro de las funciones de uso generalizado: hay muchas opciones y configuraciones en Discourse donde me he preguntado: “¿quién demonios necesita eso?”.

La gente tiende a usar las herramientas que están disponibles y le resultan familiares. Si ya tienes un martillo, podrías preguntarte para qué sirve una maza.

Quizás otros usuarios vean un caso de uso para la función propuesta y se unan a la discusión.

¡Gracias a todos los colaboradores!

2 Me gusta