Diferencias

Muestra las diferencias entre dos versiones de la página.

--- t:acad:library [2025/05/09 10:39]
[Modificar artículo de la biblioteca virtual] , kvaldez
+++ t:acad:library [2026/09/15 13:10] (actual)
wiki: t:acad:library gana la sección "Consultar el detalle de un artículo de la biblioteca virtual" (título, adjuntos por tipo, planeaciones relacionadas, apartado Opciones, clases asignadas y los botones Eliminar/Modificar/Copiar según de quién sea el artículo), y corrige el icono de papelera citado en "Eliminar artículo de la biblioteca virtual" (era fa-trash-alt, es fa-trash-can)., algebraix
@@ Línea 7: / Línea 7: @@
 Sigue estos pasos para ingresar y compartir los materiales de apoyo en la **Biblioteca Virtual**:
   - Haz clic en el menú lateral en la opción de **Biblioteca virtual**.
-  - Luego, haz clic en el icono {{icon>fas fa-plus}}, ubicado en la esquina inferior derecha de la pantalla.
+  - Luego, haz clic en el icono **Agregar** {{icon>fas fa-plus}}, ubicado en la esquina inferior derecha de la pantalla.
   - Serás dirigido a la pestaña **Agregar artículo**, donde deberás llenar los siguientes campos del formulario:
     * **Título:** Escribe el nombre del artículo que deseas compartir.
@@ Línea 18: / Línea 18: @@
        * **Documento:** Puedes adjuntar archivos como Word, Excel, TXT, entre otros.
        * **Imagen:** Podrás adjuntar imágenes en formatos como JPG, PNG o GIF.
-       * **Sitios de internet:** Ingresa el enlace del sitio web que deseas compartir.
+       * **Sitio de Internet:** Ingresa el enlace del sitio web que deseas compartir.
-       *** Embed (YouTube):** Ingresa la URL del video o especifica el código de inclusión del video.
+       * **Embed:** Ingresa la URL del video o especifica el código de inclusión del video.
        * **Texto:** Se habilitará un cuadro donde podrás redactar un texto directamente.
        * **Otro:** Para archivos que no correspondan a las categorías anteriores.
@@ Línea 28: / Línea 28: @@
      * **Ubicación:** Al seleccionar la clase (s) habilitará el campo "Folder", donde deberás marcar la ubicación donde agregarás el artículo:
         * ** Folder:**
-        * Haz clic en el icono {{icon>fa fa-plus text-green}},  para crear una nueva carpeta y escribe el nombre.
+          * Haz clic en el icono **Agregar folder nuevo** {{icon>fa fa-plus text-green}},  para crear una nueva carpeta y escribe el nombre.
-        * Si ya tienes carpetas creadas, simplemente despliega el menú y selecciona la que desees.
+          * Si ya tienes carpetas creadas, simplemente despliega el menú y selecciona la que desees.
-        * Si deseas eliminar un folder, haz clic en el icono {{icon>fa fa-times text-red}}.
+        * Si no seleccionas un folder, el artículo aparecerá como un archivo independiente en la vista del estudiante.
-      * **Notas:** Si no seleccionas un folder, el artículo aparecerá como un archivo independiente en la vista del estudiante.
+   - Una vez completado el formulario, haz clic en el botón **Agregar** {{icon>fa fa-check}} para crear el artículo.
-   - Una vez completado el formulario, haz clic en el botón {{icon>fa fa-check}} para agregar el artículo.
+===== Agregar archivos a la biblioteca virtual desde Google drive =====
+Para poder hacer la carga de archivos desde tu cuenta de Google drive, tu colegio debe tener la configuración necesaria en donde debió darse de alta tu usuario de Google.\\
+**Nota:** Para que los estudiantes puedan hacer la consulta de este tipo de archivos deberán tener dada de alta su cuenta de Google en Algebraix.
+  - En tu barra de navegación del lado izquierdo selecciona **Biblioteca virtual.**
+  - Da clic en el ícono de más {{icon>fas fa-plus}}
+  - En el apartado "Agregar artículo" da de alta la siguiente información:
+    * **Título:** Agrega el título que darás a tu artículo.
+    * **Fecha visible:** La fecha a partir de la cuál quieres que los estudiantes puedan visualizar el artículo.
+    * **Fecha de expiración:** La fecha en la que deseas que el artículo deje de estar disponible para su consulta.
+    * **Descripción:** Puedes agregar una descripción que se útil para este artículo.
+    * **Compartir artículo con otros profesores:** El artículo estará disponible para que algún otro profesor pueda utilizarlo en sus propias clases.
+    * Para adjuntar archivos desde tu drive, da clic en el ícono de Google drive {{icon>icon-google-drive-2 material-list__icon  text-orange}}
+    * Se te redirigirá a tu sesión de drive para que selecciones el archivo que relacionarás a tu artículo.
+    * **Nota:** Podrás seleccionar hasta 5 archivos.
+  - **Asignar artículo a clases:** Selecciona la o las clases a las que deseas relacionar el artículo.
+    * En la columna **Ubicación** despliega el apartado de "Folder" para seleccionar la carpeta a la que deseas integrar este artículo.
+    * Si no tienes creada una carpeta o deseas crear una nueva, da clic en el ícono de más. {{ :t:acad:agregar_folder_biblioteca_virtual.png?direct&400 |}}
+    * Ingresa el nombre que darás a la carpeta nueva.
+  - Da clic en el botón **Agregar** {{icon>fas fa-check}} que aparece en la parte inferior derecha de la pantalla.
+    * **IMPORTANTE:** Al consultar un artículo de otro profesor que incluya archivos vinculados desde su cuenta de Google Drive, se te concederá un permiso de lectura con una vigencia de 60 días.
+    * Si copias un artículo de otro profesor que incluya archivos desde su cuenta de Google Drive, se generará una copia de esos documentos en tu propia cuenta de Google Drive.
+===== Consultar el detalle de un artículo de la biblioteca virtual =====
+Al dar clic sobre cualquier artículo, ya sea desde **Mis artículos de biblioteca virtual**, **Buscar** o desde una clase, entras a su vista general con toda su información:
+  - En la parte superior se muestra el **Título** del artículo, seguido del nombre del profesor que lo agregó y la fecha en que lo hizo.
+  - Si el artículo tiene una descripción, se muestra debajo.
+  - Si el artículo está relacionado con alguna planeación de clases, verás el panel plegable **Planeaciones relacionadas** con las agrupaciones y planeaciones asociadas.
+  - El apartado **Adjuntos** muestra cada archivo del artículo según su tipo:
+    * Las **Imagen** se muestran en miniatura; da clic para verlas en una vista ampliada.
+    * Los de tipo **Sitio de Internet** se muestran como un enlace que abre el sitio en una pestaña nueva.
+    * Los **Embed** muestran el video o contenido incluido directamente en la pantalla.
+    * Los **Documento**, **Audio** y **Otro** se muestran con su nombre y tamaño; da clic para descargarlos (el audio se reproduce directamente en la pantalla).
+    * Los de tipo **Texto** muestran el contenido redactado completo.
+  - Si el artículo tiene archivos adjuntos desde Google Drive, se listan en un apartado aparte con su nombre y tipo.
+  - El apartado **Opciones** muestra:
+    * **Compartir artículo con otras clases:** un icono verde o rojo indica si el artículo está compartido con otros profesores o no.
+    * **Fecha de expiración** y **Fecha visible** del artículo.
+  - El apartado **Clases a las que se encuentra asignado** lista cada clase (y, si aplica, el **Folder** dentro de ella) a la que está asignado el artículo.
+  - Según de quién sea el artículo, en la esquina inferior derecha encontrarás:
+    * Si el artículo es tuyo: el icono de papelera para **Eliminar** y el de lápiz para **Modificar**.
+      * Al dar clic en **Eliminar** se muestra una ventana de **Confirmación** con el mensaje "¿ Está seguro que desea eliminar el artículo de biblioteca virtual ?"; si el artículo está relacionado con alguna agrupación o planeación de clases, el aviso incluye además cuántas relaciones se perderán. Da clic en **Eliminar** para confirmarlo.
+        * **IMPORTANTE:** Esta acción elimina el artículo de forma permanente para todas las clases a las que estaba asignado, y no podrá recuperarse.
+    * Si el artículo es de otro profesor: el icono **Copiar**, que te lleva al formulario para crear tu propia copia.
+      * **Nota:** Si tu colegio tiene habilitada la integración con Google Drive, el artículo incluye adjuntos de esa fuente y tu usuario de Google no es válido, el icono **Copiar** aparece deshabilitado y al intentar usarlo verás el aviso "No es posible crear la copia del artículo ya que el usuario de Google no es válido."
+<notes>FALTA_CAPTURA — pantalla: Biblioteca virtual → vista general de un artículo propio; mostrar: el panel con título, adjuntos, apartado Opciones, Clases a las que se encuentra asignado y los iconos de Eliminar y Modificar en la esquina inferior derecha; archivo sugerido: :t:acad:library_vista_general.png</notes>
 ===== Modificar artículo de la biblioteca virtual =====
+Puedes editar un artículo previamente publicado en la Biblioteca Virtual para actualizar su contenido, archivos adjuntos o clases asignadas. Sigue estos pasos para realizar la modificación:
   - Haz clic en el menú lateral en la opción de **Biblioteca virtual**.
-  - En la pestaña de **Mis artículos de biblioteca virtual** localiza el artículo por clase, o si prefieres puedes usar la pestaña **Buscar** para localizarlo.
+  - Dirígete a la pestaña **Mis artículos de biblioteca virtual** y localiza el artículo que deseas modificar por clase, o utiliza la pestaña **Buscar** para encontrarlo más fácilmente.
-  - Una vez que hayas ingresado al artículo, visualizarás la información general como el título, opciones y la clase asignada.
+  - Haz clic en el artículo para ingresar a su vista general. Aquí podrás ver el título, las clases asignadas y otras opciones relacionadas.
-  - En la parte inferior derecha, encontrarás el botón de lápiz {{icon>fas fa-pen}}.
+  - En la parte inferior derecha, haz clic en el ícono de lápiz {{icon>fas fa-pen}} para entrar a la pestaña **Modificar**.
-  - Al hacer clic, abrirá el artículo para su modificación.
+  - Ajusta los campos que necesites:
-  -
+    * **Título, Fecha visible, Fecha de expiración** y **Descripción:** se muestran precargados con la información actual del artículo y puedes cambiarlos igual que al agregar un artículo nuevo.
+    * **Compartir artículo con otros profesores:** solo se muestra cuando el artículo es tuyo desde el origen; si estás editando una copia que tú mismo hiciste de un artículo de otro profesor, esta casilla no aparece y el artículo permanece sin compartir.
+    * **Adjuntos:** los archivos ya agregados se listan cada uno con un ícono para eliminarlo {{icon>fa fa-xmark text-red}}; ese ícono no aparece si es el único adjunto del artículo y tu colegio no tiene habilitada la integración con Google Drive, para impedir que el artículo se quede sin ningún adjunto. Para sumar archivos nuevos hasta completar 8 en total, haz clic en el ícono del clip {{icon>fa fa-paperclip}}.
+    * **Asignar artículo a clases:** marca o desmarca la(s) clase(s) igual que al agregar un artículo, y ajusta el **Folder** de cada clase marcada o crea uno nuevo con el ícono **Agregar folder nuevo** {{icon>fa fa-plus text-green}}.
+    * **Nota:** Si cambias la **Fecha visible** o la **Fecha de expiración** a un rango inválido (la de expiración anterior a la visible), verás el aviso "El rango de fechas es inválido." y no podrás guardar hasta corregirlo.
+  - Una vez realizados los cambios, haz clic en el botón **Guardar** {{icon>fas fa-check}} para guardarlos.
+===== Copiar un artículo compartido por otro profesor =====
+Cuando otro profesor comparte un artículo, puedes crear tu propia copia independiente para editarla y asignarla a tus clases sin afectar el artículo original. Sigue estos pasos:
+  - Localiza el artículo compartido, por ejemplo desde la pestaña **Buscar** con la opción **Artículos compartidos**, y da clic sobre él para ver su vista general.
+  - En la parte inferior derecha de la pantalla, haz clic en el ícono **Copiar** {{icon>fas fa-copy}}.
+    * **Nota:** Si el artículo incluye archivos adjuntos desde Google Drive y no tienes una cuenta de Google asociada válida, verás el aviso "No es posible crear la copia del artículo ya que el usuario de Google no es válido." y no podrás continuar.
+  - Se abrirá la pestaña **Copiar** con un formulario prellenado con la información del artículo original:
+    * **Título:** Puedes conservar el nombre original o cambiarlo.
+    * **Fecha visible** y **Fecha de expiración:** Puedes ajustarlas para tu copia.
+    * **Descripción:** Puedes conservarla o modificarla.
+    * **Adjuntos:** Se muestran los archivos del artículo original; puedes agregar hasta 8 en total con el ícono del clip {{icon>fa fa-paperclip}}.
+  - En el apartado **Asignar artículo a clases**, marca la(s) clase(s) a las que asignarás tu copia y, si lo deseas, selecciona un **Folder** para organizarla, igual que al agregar un artículo nuevo.
+  - Da clic en el botón de guardar {{icon>fas fa-check}}.
+    * **Nota:** Es necesario marcar al menos una clase y conservar o agregar al menos un artículo (adjunto o archivo de Google Drive) para poder guardar la copia; de lo contrario verás el aviso "No se han agregado artículos de biblioteca virtual."
+  - Tu copia queda registrada como un artículo propio e independiente en tu **Biblioteca virtual**: modificarla o eliminarla no afecta el artículo original del otro profesor.
 ===== Eliminar artículo de la biblioteca virtual =====
+Si ya no deseas que un artículo esté disponible en tu Biblioteca Virtual, puedes eliminarlo de forma permanente. A continuación se describen los pasos para hacerlo:
+  - Haz clic en el menú lateral en la opción de **Biblioteca virtual**.
+  - Dirígete a la pestaña **Mis artículos de biblioteca virtual** y localiza el artículo que deseas modificar por clase, o utiliza la pestaña **Buscar** para encontrarlo más fácilmente.
+  - Haz clic en el artículo para ingresar a su vista general. Aquí podrás ver el título, las clases asignadas y otras opciones relacionadas.
+  - En la parte inferior derecha, haz clic en el ícono de papelera {{icon>far fa-trash-can}} y se mostrará una ventana de confirmación.
+  - Haz clic en **Aceptar** para confirmar la eliminación.
+       * **Nota**: Esta acción elimina el artículo de forma permanente para todas las clases a las que estaba asignado. Una vez eliminado, no podrá recuperarse.
+===== Mis artículos de biblioteca virtual =====
+  - Haz clic en el menú lateral en la opción de **Biblioteca virtual**.
+  - Serás dirigido automáticamente a la pestaña **Mis artículos de biblioteca virtual**.
+  - **Nota:** Solo se listan las clases que el administrador o el operador dieron de alta previamente con la opción de biblioteca virtual habilitada. Si ninguna de tus clases la tiene habilitada, verás el aviso "No se han encontrado clases con opción de biblioteca virtual." y no se mostrará ningún apartado.
+  - Si al menos una de tus clases tiene la opción habilitada, se muestran los siguientes apartados:
+    * **Clases:** lista cada una de esas clases junto al icono {{icon>fas fa-folder text-yellow}} y, en una etiqueta numérica, la cantidad de artículos que tiene agregados.
+      * Da clic en la flecha de la clase para desplegarla. Dentro puedes encontrar:
+        * Los artículos agregados directamente a la clase (sin carpeta), con la cuenta de cuántos son.
+        * Una entrada por cada **Folder** que hayas creado en esa clase, con el nombre de la carpeta y la cantidad de artículos que contiene.
+      * Da clic en el artículo, la clase sin carpeta o la carpeta para ver el listado correspondiente en la pestaña **Buscar**.
+    * **Tipo de archivo:** solo aparece cuando ya agregaste al menos un artículo; si no has agregado ninguno verás el aviso "No se han agregado artículos de biblioteca virtual." en su lugar.
+      * Lista cada tipo de archivo que tengas en uso (**Documento**, **Imagen**, **Audio**, **Sitio de Internet**, **Texto**, **Otro**) con la cantidad de artículos de ese tipo.
+      * Si tu colegio tiene habilitada la integración con Google Drive y tienes artículos con adjuntos de esa fuente, aparece además un renglón **Google Drive** con la cantidad de esos adjuntos.
+      * Al seleccionar un tipo de archivo, serás dirigido a la pestaña **Buscar** con el listado de tus artículos de ese tipo, en todas tus clases.
-===== Mis artículos de biblioteca virtual =====
+===== Consultar la biblioteca virtual desde una clase =====
-  - Haz clic en el menú lateral en la opción de **Biblioteca virtual**.
+Además de la opción del menú lateral, puedes consultar los artículos de biblioteca virtual de una clase específica desde la propia clase. Es necesario que la clase tenga habilitada la opción de biblioteca virtual para que esta pestaña aparezca.
-  - Serás dirigido automáticamente a la pestaña ** Mis artículos de biblioteca virtual**.
+  - Entra a la clase y selecciona la pestaña **Biblioteca virtual**.
-  - Se mostrarán los siguientes apartados:
-    * **Clases:**
-      * Se mostrará el listado de las clases indicando junto al icono {{icon>fas fa-folder text-yellow}} la cantidad de artículos agregados.
-        ***Nota:** Solo se mostrarán las clases que hayan sido configuradas previamente con esta opción habilitada por el administrador o el operador del sistema.
-      * Haz clic en el ícono de la flecha para desplegar los artículos asociados a esa clase.
-      * Selecciona el artículo para ver más detalles.
-    * **Tipo de archivo:**
-      *Este apartado estará visible siempre que hayas agregado al menos un artículo.
-      *Se mostrará un listado por tipo de archivo (documentos, imágenes, sitio de internet, etc.), junto con la cantidad correspondiente de artículos por cada tipo.
-      *Al seleccionar un tipo de archivo, serás redirigido a la pestaña Buscar, donde en la parte inferior se mostrará el listado de artículos correspondientes al tipo seleccionado.
+<notes>FALTA_CAPTURA — pantalla: Clase → pestaña Biblioteca virtual; mostrar: el listado de la clase con el apartado Folders y el apartado Artículos con la lupa de búsqueda visible; archivo sugerido: :t:acad:library_biblioteca_clase.png</notes>
+  - Si la clase tiene carpetas creadas, se muestra primero el apartado **Folders** con el nombre de cada una y, junto a él, la cantidad de artículos que contiene.
+    * Da clic en una carpeta para ver únicamente los artículos que contiene.
+  - Cuando estás dentro de una carpeta, un botón con el nombre de la clase te permite regresar al listado general, y junto a él se muestra el nombre de la carpeta que estás consultando.
+  - El apartado **Artículos** lista los artículos de la clase (o de la carpeta, si entraste a una) con su icono según el tipo de adjunto —o el de Google Drive, con un número si combina varios adjuntos o tipos— y, a la derecha, su fecha de expiración.
+    * Da clic en un artículo para ver su vista general.
+    * **Nota:** El listado se pagina; usa las flechas junto al encabezado **Artículos** para avanzar o retroceder entre páginas.
+  - Para buscar dentro de esta clase da clic en el icono de la lupa {{icon>fas fa-magnifying-glass}}; se abre el mismo formulario de búsqueda por título y tipo de artículo descrito en **Buscar artículo de biblioteca virtual**.
+  - Si entraste a una carpeta y esta no tiene ningún artículo agregado, puedes eliminarla con el icono de papelera {{icon>far fa-trash-can}}:
+    * Al dar clic se muestra una ventana de confirmación con el mensaje "¿ Está seguro que desea eliminar el folder de biblioteca virtual"; da clic en **Eliminar** para confirmar.
+    * **IMPORTANTE:** Esta acción elimina la carpeta de forma permanente; no está disponible si la carpeta todavía tiene artículos.
 ===== Buscar artículo de biblioteca virtual =====
@@ Línea 64: / Línea 154: @@
   - Haz clic en el menú lateral en la opción de **Biblioteca virtual**.
   - Luego, selecciona la pestaña **Buscar**.
-  - Tienes varias formas de buscar artículos:
+  - Elige el contexto de la búsqueda:
-    * **Mis artículos**:
+    * **Mis artículos:** Busca solo entre los artículos que tú has agregado. Esta opción está seleccionada por defecto.
-       * Esta opción estará seleccionada por defecto.
+    * **Artículos compartidos:** Busca entre los artículos que otros profesores marcaron como compartidos.
-       * Haz clic en el icono búsqueda {{icon>fas fa-search}} para ver el listado de los artículos que has agregado.
+  - Si quieres, escribe una parte del título en el campo **Buscar**.
-    * ** Artículos compartidos**.
+  - Activa **Mostrar opciones avanzadas de búsqueda** para aplicar filtros adicionales antes de buscar:
-       * Selecciona esta opción si deseas buscar artículos compartidos por otros profesores.
+    * **Mostrar artículos en fechas inactivas ( Aún no visibles o expirados ):** Marca esta casilla si quieres incluir artículos cuya fecha visible aún no llega o cuya fecha de expiración ya pasó; si la dejas sin marcar solo verás los que están vigentes hoy.
-       * Haz clic en el ícono de búsqueda {{icon>fas fa-search}} para visualizar el listado.
+    * **Tipo:** Lista de casillas por tipo de artículo (**Audio**, **Documento**, **Embed**, **Imagen**, **Sitio de Internet**, **Otro**, **Texto** y, si tu colegio tiene habilitada la integración, **Google Drive**), todas marcadas por defecto. Desmarca las que no quieras incluir.
-    * **Buscar**: Escribe el nombre del artículo en el campo "Buscar" y haz clic en el ícono de búsqueda {{icon>fas fa-search}}.
+      * **IMPORTANTE:** Debes dejar al menos un tipo marcado; si intentas buscar sin ninguno verás el aviso "Es necesario especificar al menos un tipo de artículo para la búsqueda." y la búsqueda no se ejecutará.
-    * **Mostrar opciones avanzadas de búsqueda:** Al habilitar esta opción, podrás realizar una búsqueda más detallada aplicando diferentes filtros:
+    * **Clases:** Solo aparece con el contexto **Mis artículos**. Lista tus clases con la opción de biblioteca virtual habilitada, todas marcadas por defecto; desmarca las que no quieras incluir en la búsqueda.
-      * **Mostrar artículos en fechas inactivas(Aún no visibles o expirados)**: Marca esta casilla si deseas incluir artículos que aún no están visibles o que ya expiraron.
+      * **Nota:** Solo se listan las clases que el administrador o el operador dieron de alta previamente con la opción de biblioteca virtual habilitada.
-      * **Tipo**: Selecciona uno o más tipos de archivo que deseas buscar.
+      * **IMPORTANTE:** Debes dejar al menos una clase marcada; si intentas buscar sin ninguna verás el aviso "Es necesario especificar al menos una clase." y la búsqueda no se ejecutará.
-      * **Clases:** (Solo para tus artículos) Marca las clases en las que deseas realizar la búsqueda.
+    * **Profesor:** Solo aparece con el contexto **Artículos compartidos**. Escribe el nombre de un profesor para que te sugiera coincidencias; al seleccionar una se agrega como una etiqueta removible, y puedes agregar varios profesores para acotar la búsqueda a ellos. Si no seleccionas ninguno, la búsqueda incluye a todos los profesores que comparten artículos.
-      * **Profesor:**(Solo para artículos compartidos) Ingresa el nombre del profesor que compartió el artículo, si lo conoces.
+  - Da clic en el ícono de búsqueda {{icon>fas fa-magnifying-glass}} para ejecutar la búsqueda con el contexto y los filtros seleccionados.
+  - Los resultados aparecen en la columna **Artículos**:
+    * Cada artículo muestra su icono según el tipo de adjunto (o el de Google Drive si todos sus adjuntos vienen de ahí), con un número junto al icono cuando el artículo tiene más de un adjunto o combina varios tipos.
+    * Debajo del título se muestra la descripción, si el artículo la tiene, y el nombre del profesor que lo compartió cuando el artículo no es tuyo.
+    * A la derecha de cada artículo se muestra su fecha de expiración.
+    * Da clic en un artículo para ver su vista general.
+    * Si tu búsqueda no encuentra artículos, verás el aviso "No se han encontrado artículos de biblioteca utilizando la búsqueda especificada."
+    * **Nota:** Los resultados se muestran en páginas de hasta 50 artículos; usa las flechas junto al encabezado **Artículos** para avanzar o retroceder entre páginas.
+<notes>REVISION_PENDIENTE — redactado por el canal automático y publicado sin revisión de un segundo lector. Para revisarlo: ARTICULOS="t:acad:library" make -C pipeline revisar</notes>