# HG changeset patch # User veltr # Date 1346771722 -7200 # Node ID 13fed6c21d5174efa84876257a71190f8b167808 # Parent b7e236e4ec1c847a6f76116fca9fb21693543c8b Docs update diff -r b7e236e4ec1c -r 13fed6c21d51 doc/architecture.en.md --- a/doc/architecture.en.md Tue Sep 04 17:14:53 2012 +0200 +++ b/doc/architecture.en.md Tue Sep 04 17:15:22 2012 +0200 @@ -14,7 +14,7 @@ - **License**: MIT. - **Role**: Loads other librairies and widgets. - **Used in**: Metadataplayer core. -- As LAB.js is used to load other libraries, it's the only library called before loading the Metadataplayer core. +- As LAB.js is used to load other libraries, it’s the only library called before loading the Metadataplayer core. - **Library homepage**: http://labjs.com/ ### jQuery ### @@ -65,6 +65,14 @@ - **Used in**: Arrow and Sparkline widgets - **Library homepage**: http://raphaeljs.com/ +### ZeroClipboard ### + +- **Files**: ZeroClipboard.js and ZeroClipboard.swf +- **License**: MIT. +- **Role**: Manages access to the Clipboard (using Flash) +- **Used in**: Social widget +- **Library homepage**: http://code.google.com/p/zeroclipboard/ + ### ktbs4js Tracemanager ### - **File**: tracemanager.js @@ -81,7 +89,7 @@ ### header.js ### -Contains credits and licence information (The license is CEA, CNRS and Inria's *CeCILL-C*) +Contains credits and licence information (The license is CEA, CNRS and Inria’s *CeCILL-C*) ### LAB.js ### @@ -95,7 +103,7 @@ ### pop.js ### Defines the *IriSP.PopcornReplacement* class, i.e. a simplified version of the Popcorn API used to interface with video players (jwplayer, dailymotion) not supported by Popcorn. -When this part of the Metadataplayer was written, Popcorn and jwplayer didn't interface well, but it should be replaced by a real Popcorn.js plugin. +When this part of the Metadataplayer was written, Popcorn and jwplayer didn’t interface well, but it should be replaced by a real Popcorn.js plugin. ### utils.js ### @@ -134,7 +142,7 @@ Widgets are modules, visible or not, adding functionalities to the Metadataplayer. -Located in the *src/widgets* directory, they're composed of a mandatory JavaScript file, *WidgetName.js* and an optional stylesheet, *WidgetName.css* +Located in the *src/widgets* directory, they’re composed of a mandatory JavaScript file, *WidgetName.js* and an optional stylesheet, *WidgetName.css* #### Common Widget Options #### @@ -145,32 +153,29 @@ - *Array of string*: to display several annotation types. Example: "Segments" - *false*: to display all annotations related to the media. -Here's a list of available widgets: +Here’s a list of available widgets: -### HelloWorld ### +### Annotation ### -- **Role**: Example widget demonstration the API capabilities +- **Role**: Displays information relative to a single segment/annotation while it is being played - **Options**: - - **text**: (default: "world"), text to display after "Hello, " + - **annotation\_type**: (default: "chapitrage"), see *Common widget options*. + - **show\_top\_border**: (default: false), show top widget border (useful depending on whether it is used in combination with the *Arrow* widget) + - **site\_name**: "Lignes de Temps", site name to display when users click on "Share on social networks". - Uses a CSS stylesheet: yes -### Slider ### +### AnnotationsList ### -- **Role**: A combination of a Progress bar and a Slider displaying and allowing repositioning of the current video playback position. +- **Role**: Show a list of annotations. - **Options**: - - **minimized\_height**: (default: 4), height in pixels of the *Slider* in minimized mode - - **maximized\_height**: (default: 10), height in pixels du *Slider* in maximized mode (on mouseover) - - **minimize\_timeout**: (default: 1500), duration in milliseconds before the *Slider* is automatically minimized. If set to 0, *Slider* stays maximized. -- Uses external library: jQuery UI -- Uses a CSS stylesheet: yes - -### Controller ### - -- **Role**: Play, Pause, Search, Annotate buttons and volume control -- **Options**: - - **disable\_annotate\_btn**: (default: false), disables Annotate button if set to *true* - - **disable\_search\_btn**: (default: true), disables Search button -- Uses external library: jQuery UI + - **ajax\_url**: (default: false), specifies an API template when annotations have to be loaded from an external source. In the URL, {{media}} will be replaced by the media ID, {{begin}} by the start *timecode* in milliseconds, {{end}} by the end *timecode* in milliseconds. If set to *false*, displayed annotations will be the ones loaded from the default metadata source. On the *Lignes de Temps*, the URL of the segments API is http://ldt.iri.centrepompidou.fr/ldtplatform/api/ldt/segments/{{media}}/{{begin}}/{{end}}?callback=? + - **ajax\_granularity**: (default: 300000 ms = 5 minutes), specifies the timespan to be loaded from the segment API, around the current timecode. + - **default\_thumbnail**: thumbnail to display when an annotation doesn’t have one. + - **foreign\_url**: Specifies an URL template for when an annotation doesn’t have an URL and is not in the current project. In that template, {{media}} will be replaced by the media ID, {{project}} by the project ID, {{annotationType}} by the annotation type ID and {{annotation}} by the annotation ID. For the *Lignes de temps* platform, this URL is http://ldt.iri.centrepompidou.fr/ldtplatform/ldt/front/player/{{media}}/{{project}}/{{annotationType}}#id={{annotation}} + - **annotation\_type**: (default: false), see *Common widget options*, above + - **refresh\_interval**: (default: 0), Ajax refresh interval, to get annotations added while watching (works with either the default source or the external segment API) + - **limit\_count**: (default: 10), Maximum number of annotations to display at once. + - **newest\_first**: (default: false), When *true*, annotations are sorted by decreasing creation date. When *false*, annotations are sorted by increasing timecode. - Uses a CSS stylesheet: yes ### Arrow ### @@ -190,13 +195,13 @@ - Uses external library: Raphael - Uses a CSS stylesheet: no -### Annotation ### +### Controller ### -- **Role**: Displays information relative to a single segment/annotation while it is being played +- **Role**: Play, Pause, Search, Annotate buttons and volume control - **Options**: - - **annotation\_type**: (default: "chapitrage"), see *Common widget options*. - - **show\_top\_border**: (default: false), show top widget border (useful depending on whether it is used in combination with the *Arrow* widget) - - **site\_name**: "Lignes de Temps", site name to display when users click on "Share on social networks". + - **disable\_annotate\_btn**: (default: false), disables Annotate button if set to *true* + - **disable\_search\_btn**: (default: true), disables Search button +- Uses external library: jQuery UI - Uses a CSS stylesheet: yes ### CreateAnnotation ### @@ -217,6 +222,28 @@ - **close\_widget\_timeout**: (default: 0), duration in milliseconds before widget is closed after send. If value is set to 0, the widget stays open. - Uses a CSS stylesheet: yes +### HelloWorld ### + +- **Role**: Example widget demonstration the API capabilities +- **Options**: + - **text**: (default: "world"), text to display after "Hello, " +- Uses a CSS stylesheet: yes + +### Media ### + +- **Role**: Shows current media, as well as other medias in the project. Mostly used for mashups +- **Options**: + - **default\_thumbnail**: thumbnail to display when a media doesn’t have one + - **media\_url\_template**: Specifies an URL template for when a media doesn’t include URL information, e.g.: "http://ldt.iri.centrepompidou.fr/ldtplatform/ldt/front/player/{{media}}/" +- Uses a CSS stylesheet: yes + +### Mediafragment ### + +- **Role**: Handles *Media fragments*-compliant URIs (W3C Recommandation): Changing the playing position changes the URL and vice-versa. +- An URL ending with #id=*annotation ID* points to an annotation, one with #t=*time in seconds* to a precise position. +- No options +- Uses a CSS stylesheet: no + ### Polemic ### - **Role**: Shows the *polemical timeline*, i.e. tweets colored according to the polemical syntax. Depending on the number of tweets, two visualization modes exist: @@ -232,30 +259,61 @@ - **polemics**: polemical colors to display, as an array of objects, e.g. [ { name: "OK", keywords: [ "++" ], color: "#1D973D" } ] - Uses a CSS stylesheet: yes -### Tweet ### +### Renkan ### + +- **Role**: Interface with the *Renkan* project. +- Uses external libraries: jQuery Mousewheel, Backbone, Backbone Relational, Renkan-Publish +- Uses a CSS stylesheet: oui + +### Segments ### + +- **Role**: Displays segments of a media as rectangles on an horizontal line. +- **Options**: + - **colors**: colors to use when annotations don’t have colour metadata. + - **height**: height of the widget, in pixels +- Uses a CSS stylesheet: yes + +### Slider ### -- **Role**: Show the contents on a tweet when clicj +- **Role**: A combination of a Progress bar and a Slider displaying and allowing repositioning of the current video playback position. - **Options**: - - **hide_timeout**: (default: 5000), durée en milliseconds, avant que l’affichage du Tweet ne se referme - - **polemics**: identique au paramètre *polemics* du widget *Polemic* + - **minimized\_height**: (default: 4), height in pixels of the *Slider* in minimized mode + - **maximized\_height**: (default: 10), height in pixels du *Slider* in maximized mode (on mouseover) + - **minimize\_timeout**: (default: 1500), duration in milliseconds before the *Slider* is automatically minimized. If set to 0, *Slider* stays maximized. +- Uses external library: jQuery UI +- Uses a CSS stylesheet: yes + +### Social ### + +- **Role**: Adds buttons to share an URL on social networks +- **Options**: + - **text**: displays a text + - **url**: the URL to share + - **show_url**: Shows a button to copy/paste an URL + - **show_twitter**: Shows a button to share on Twitter + - **show_fb**: Shows a button to share on Facebook + - **show_gplus**: Shows a button to share on Google+ + - **show_mail**: Shows a button to share by e-mail +- Uses a CSS stylesheet: yes +- Uses external library: ZeroClipboard ### Sparkline ### -- **Role**: Affiche une courbe indiquant l’évolution du volume d’annotations au cours du temps. +- **Role**: Displays a curve showing the volume of tweets across time. - **Options**: - **annotation\_type**: see *Common widget options*, above - - **lineColor**: (default: "#7492b4" = gris-bleu), couleur de la courbe - - **fillColor**: (default: "#aeaeb8" = gris), couleur de la surface sous la courbe - - **lineWidth**: (default: 2), épaisseur en pixels de la courbe - - **slice\_count**: (default: 20), nombre des tranches horaires dans lesquelles les annotations sont réparties pour calculer la courbe - - **height**: (default: 50), hauteur en pixels de la courbe - - **margin**: (default: 5), marge en pixels au-dessus de la courbe + - **lineColor**: (default: "#7492b4" = blue-grey), line color + - **fillColor**: (default: "#aeaeb8" = grey), color of the surface below the curve + - **lineWidth**: (default: 2), line width in pixels + - **slice\_count**: (default: 20), number of slices used to sample volumes + - **height**: (default: 50), curve height + - **margin**: (default: 5), margin above the curve - Uses external library: Raphael - Uses a CSS stylesheet: no ### Tagcloud ### -- **Role**: Shows a tag cloud - WARNING: Doesn't work well with Japanese language because of word splitting issues +- **Role**: Shows a tag cloud - WARNING: Doesn’t work well with Japanese language because of word splitting issues - **Options**: - **include\_titles**: (default: true), includes annotation titles when computing tag cloud. - **include\_descriptions**: (default: true), includes annotation descriptions when computing tag cloud. @@ -265,31 +323,9 @@ - **custom\_stopwords**: (default: []), custom stopwords to filter out. - **exclude\_pattern**: (default: false), regexp to filter out. - **annotation\_type**: (default: false), see *Common widget options*, above. The annotation type of the annotations whose text is extracted to compute the cloud. - - **segment\_annotation\_type**: (default: false), permet de définir la segmentation du nuage de mots-clés et de calculer un nuage pour chaque segment du type d’annotation choisi. Lorsque ce paramètre est à *false*, un seul nuage est calculé pour toute la durée de la vidéo. - - **min\_font\_size**: (default: 10), taille de caractères (en pixels) pour le mot le moins fréquent. - - **max\_font\_size**: (default: 26), taille de caractères (en pixels) pour le mot le plus fréquent. -- Uses a CSS stylesheet: yes - -### AnnotationsList ### - -- **Role**: Show a list of annotations. -- **Options**: - - **ajax\_url**: (default: false), specifies an API template when annotations have to be loaded from an external source. In the URL, {{media}} will be replaced by the media ID, {{begin}} by the start *timecode* in milliseconds, {{end}} by the end *timecode* in milliseconds. If set to *false*, displayed annotations will be the ones loaded from the default metadata source. On the *Lignes de Temps*, the URL of the segments API is http://ldt.iri.centrepompidou.fr/ldtplatform/api/ldt/segments/{{media}}/{{begin}}/{{end}}?callback=? - - **ajax\_granularity**: (default: 300000 ms = 5 minutes), specifies the timespan to be loaded from the segment API, around the current timecode. - - **default\_thumbnail**: thumbnail to display when an annotation doesn't have one. - - **foreign\_url**: Specifies an URL template for when an annotation doesn't have an URL and is not in the current project. In that template, {{media}} will be replaced by the media ID, {{project}} by the project ID, {{annotationType}} by the annotation type ID and {{annotation}} by the annotation ID. For the *Lignes de temps* platform, this URL is http://ldt.iri.centrepompidou.fr/ldtplatform/ldt/front/player/{{media}}/{{project}}/{{annotationType}}#id={{annotation}} - - **annotation\_type**: (default: false), see *Common widget options*, above - - **refresh\_interval**: (default: 0), Ajax refresh interval, to get annotations added while watching (works with either the default source or the external segment API) - - **limit\_count**: (default: 10), Maximum number of annotations to display at once. - - **newest\_first**: (default: false), When *true*, annotations are sorted by decreasing creation date. When *false*, annotations are sorted by increasing timecode. -- Uses a CSS stylesheet: yes - -### Media ### - -- **Role**: Shows current media, as well as other medias in the project. Mostly used for mashups -- **Options**: - - **default\_thumbnail**: thumbnail to display when a media doesn't have one - - **media\_url\_template**: Specifies an URL template for when a media doesn't include URL information, e.g.: "http://ldt.iri.centrepompidou.fr/ldtplatform/ldt/front/player/{{media}}/" + - **segment\_annotation\_type**: (default: false), defines a segmentation of the tag-cloud, so as to display a distinct tag cloud for each segment of this annotation type. When set to *false*, a single tag cloud is created for the whole media. + - **min\_font\_size**: (default: 10), font size for the most frequent word. + - **max\_font\_size**: (default: 26), font size for the least frequent word. - Uses a CSS stylesheet: yes ### Tooltip ### @@ -309,23 +345,9 @@ - Uses external library: ktbs4js tracemanager - Uses a CSS stylesheet: no -### Mediafragment ### - -- **Role**: Handles *Media fragments*-compliant URIs (W3C Recommandation): Changing the playing position changes the URL and vice-versa. -- An URL ending with #id=*annotation ID* points to an annotation, one with #t=*time in seconds* to a precise position. -- No options -- Uses a CSS stylesheet: no - -### Social ### +### Tweet ### -- **Role**: Adds buttons to share an URL on social networks +- **Role**: Show the contents on a tweet when clicked (in Polemic Widget) - **Options**: - - **text**: displays a text - - **url**: the URL to share - - **show_url**: Shows a button to copy/paste an URL - - **show_twitter**: Shows a button to share on Twitter - - **show_fb**: Shows a button to share on Facebook - - **show_gplus**: Shows a button to share on Google+ - - **show_mail**: Shows a button to share by e-mail -- Uses a CSS stylesheet: yes -- Uses external library: ZeroClipboard + - **hide_timeout**: (default: 5000), time (in milliseconds) before hiding the Tweet. + - **polemics**: See *Polemic* widget diff -r b7e236e4ec1c -r 13fed6c21d51 doc/architecture.fr.md --- a/doc/architecture.fr.md Tue Sep 04 17:14:53 2012 +0200 +++ b/doc/architecture.fr.md Tue Sep 04 17:15:22 2012 +0200 @@ -62,9 +62,17 @@ - **Fichier**: raphael-min.js - **Licence**: MIT. - **Rôle**: Fournit une interface de dessin vectoriel (utilise SVG ou VML selon les navigateurs) -- **Utilisé par**: Widgets et Sparkline +- **Utilisé par**: Widgets Arrow et Sparkline - **Site**: http://raphaeljs.com/ +### ZeroClipboard ### + +- **Fichiers**: ZeroClipboard.js et ZeroClipboard.swf +- **Licence**: MIT. +- **Rôle**: Permet l’accès au presse-papiers (using Flash) +- **Utilisé par**: Widget Social +- **Site**: http://code.google.com/p/zeroclipboard/ + ### ktbs4js Tracemanager ### - **Fichier**: tracemanager.js @@ -148,30 +156,27 @@ Voici la liste des widgets actuellement disponibles, avec leurs options: -### HelloWorld ### +### Annotation ### -- **Rôle**: Widget d’exemple démontrant l’API de création de widgets +- **Rôle**: Affiche les informations relatives à une annotation au moment où celle-ci est jouée - **Options**: - - **text**: (défaut: "world"), texte à afficher après "Hello, " + - **annotation\_type**: (défaut: "chapitrage"), cf. *Options courantes*, plus haut. + - **show\_top\_border**: (défaut: false), afficher ou non la bordure en haut du widget (au cas où il est utilisé sans/avec le widget *Arrow*) + - **site\_name**: "Lignes de Temps", nom du site à afficher lorsque l’on clique sur les boutons de partage pour réseaux sociaux. - Utilise un fichier CSS: oui -### Slider ### +### AnnotationsList ### -- **Rôle**: Barre de progression et *Slider* indiquant la position de la tête de lecture vidéo et permettant de la déplacer. +- **Rôle**: Affiche une liste d’annotations - **Options**: - - **minimized\_height**: (défaut: 4), hauteur en pixels du *Slider* en mode minimisé - - **maximized\_height**: (défaut: 10), hauteur en pixels du *Slider* en mode maximisé (lorsque la souris passe dessus) - - **minimize\_timeout**: (défaut: 1500), durée en millisecondes avant que le *Slider* ne se minimise. À une valeur de 0, le *Slider* ne se minimise plus. -- Utilise la bibliothèque: jQuery UI -- Utilise un fichier CSS: oui - -### Controller ### - -- **Rôle**: Boutons Lecture/Pause, Rechercher, Ouvrir l’annotateur et contrôle du volume -- **Options**: - - **disable\_annotate\_btn**: (défaut: false), permet de désactiver le bouton d’ouverture de l’annotateur s’il est à *true* - - **disable\_search\_btn**: (défaut: true), permet de désactiver le bouton de recherche d’annotations -- Utilise la bibliothèque: jQuery UI + - **ajax\_url**: (défaut: false), spécifie un gabarit d’URL lorsque les annotations doivent être chargées par une API spécifique (API de segment). Dans l’URL, {{media}} sera remplacé par l’ID du média, {{begin}} par le *timecode* de début en millisecondes, {{end}} par le *timecode* de fin en millisecondes. Si le réglage est à *false*, les annotations affichées seront celles chargées à l’initialisation du Widget. Sur la plateforme *Lignes de Temps*, cette URL est http://ldt.iri.centrepompidou.fr/ldtplatform/api/ldt/segments/{{media}}/{{begin}}/{{end}}?callback=? + - **ajax\_granularity**: (défaut: 300000 ms = 5 minutes), spécifie la durée qui doit être chargée par l’API de segment, de part et d’autre du timecode courant (cf. ci-dessus) + - **default\_thumbnail**: imagette à afficher par défaut à côté d’une annotation lorsque l’annotation n’a pas d’imagette. + - **foreign\_url**: spécifie un gabarit d’URL lorsque l’annotation n’a pas d’information d’URL et que l’annotation est dans un autre projet. Dans l’URL, {{media}} sera remplacé par l’ID du média, {{project}} par l’ID du projet, {{annotationType}} par l’ID du type d’annotation, {{annotation}} par l’ID de l’annotation. Sur la plateforme *Lignes de temps*, cette URL est http://ldt.iri.centrepompidou.fr/ldtplatform/ldt/front/player/{{media}}/{{project}}/{{annotationType}}#id={{annotation}} + - **annotation\_type**: (défaut: false), cf. *Options courantes*, plus haut. + - **refresh\_interval**: (défaut: 0), intervalle auquel le widget recharge en Ajax la liste des annotations (que l’on utilise l’API de segment ou non) + - **limit\_count**: (défaut: 10), nombre maximum d’annotations à afficher simultanément. + - **newest\_first**: (défaut: false), *true*: classe les annotations par ordre antéchronologique de création, *false*: classe les annotations par ordre chronologique de leur timecode vidéo. - Utilise un fichier CSS: oui ### Arrow ### @@ -191,13 +196,13 @@ - Utilise la bibliothèque: Raphael - Utilise un fichier CSS: non -### Annotation ### +### Controller ### -- **Rôle**: Affiche les informations relatives à une annotation au moment où celle-ci est jouée +- **Rôle**: Boutons Lecture/Pause, Rechercher, Ouvrir l’annotateur et contrôle du volume - **Options**: - - **annotation\_type**: (défaut: "chapitrage"), cf. *Options courantes*, plus haut. - - **show\_top\_border**: (défaut: false), afficher ou non la bordure en haut du widget (au cas où il est utilisé sans/avec le widget *Arrow*) - - **site\_name**: "Lignes de Temps", nom du site à afficher lorsque l’on clique sur les boutons de partage pour réseaux sociaux. + - **disable\_annotate\_btn**: (défaut: false), permet de désactiver le bouton d’ouverture de l’annotateur s’il est à *true* + - **disable\_search\_btn**: (défaut: true), permet de désactiver le bouton de recherche d’annotations +- Utilise la bibliothèque: jQuery UI - Utilise un fichier CSS: oui ### CreateAnnotation ### @@ -217,6 +222,28 @@ - **close\_widget\_timeout**: (défaut: 0), durée en millisecondes avant que le widget ne soit refermé après l’envoi d’une annotation. Si la valeur est 0, le widget ne se referme pas. - Utilise un fichier CSS: oui +### HelloWorld ### + +- **Rôle**: Widget d’exemple démontrant l’API de création de widgets +- **Options**: + - **text**: (défaut: "world"), texte à afficher après "Hello, " +- Utilise un fichier CSS: oui + +### Media ### + +- **Rôle**: Affiche le média en cours, ainsi que la liste des autres médias du projet. Utilisé principalement pour les mashups +- **Options**: + - **default\_thumbnail**: imagette à afficher par défaut à côté d’un média lorsque le média n’a pas d’imagette. + - **media\_url\_template**: spécifie un gabarit d’URL lorsque le média n’a pas d’information d’URL, par exemple: "http://ldt.iri.centrepompidou.fr/ldtplatform/ldt/front/player/{{media}}/" +- Utilise un fichier CSS: oui + +### Mediafragment ### + +- **Rôle**: Gère les URLs à la norme *Mediafragment*: change la position de la tête de lecture en fonction de l’URL et inversement. +- Une URL finissant par #id=*id de l’annotation* pointe sur une annotation, par #t=*temps en secondes* vers un timecode de la vidéo. +- Pas d’options +- Utilise un fichier CSS: non. + ### Polemic ### - **Rôle**: Affiche la *timeline polémique*, c’est à dire les tweets colorés en fonction de la syntaxe polémique. Selon le volume de tweets, deux modes de représentation existent: @@ -232,12 +259,43 @@ - **polemics**: couleurs polémiques à afficher, en fonction d’une recherche de termes, type [ { keywords: [ "++" ], color: "#1D973D" } ] - Utilise un fichier CSS: oui -### Tweet ### +### Renkan ### + +- **Rôle**: Interface avec le projet *Renkan* +- Utilise les bibliothèques: jQuery Mousewheel, Backbone, Backbone Relational, Renkan-Publish +- Utilise un fichier CSS: oui + +### Segments ### + +- **Rôle**: Affiche le *chapitrage* du média, en horizontal. +- **Options**: + - **colors**: liste de couleurs à utiliser lorsque les annotations ne contiennent pas d’information de couleur. + - **height**: hauteur du widget +- Utilise un fichier CSS: oui + +### Slider ### -- **Rôle**: Affiche furtivement le contenu d’un tweet +- **Rôle**: Barre de progression et *Slider* indiquant la position de la tête de lecture vidéo et permettant de la déplacer. - **Options**: - - **hide_timeout**: (défaut: 5000), durée en millisecondes, avant que l’affichage du Tweet ne se referme - - **polemics**: identique au paramètre *polemics* du widget *Polemic* + - **minimized\_height**: (défaut: 4), hauteur en pixels du *Slider* en mode minimisé + - **maximized\_height**: (défaut: 10), hauteur en pixels du *Slider* en mode maximisé (lorsque la souris passe dessus) + - **minimize\_timeout**: (défaut: 1500), durée en millisecondes avant que le *Slider* ne se minimise. À une valeur de 0, le *Slider* ne se minimise plus. +- Utilise la bibliothèque: jQuery UI +- Utilise un fichier CSS: oui + +### Social ### + +- **Role**: Affiche des boutons pour partager une URL sur les réseaux sociaux +- **Options**: + - **text**: un texte à afficher (dans le tweet, etc.) + - **url**: l’URL à partager + - **show_url**: Affiche un bouton pour copier-coller une URL. + - **show_twitter**: Affiche un bouton pour partager sur Twitter. + - **show_fb**: Affiche un bouton pour partager sur Facebook. + - **show_gplus**: Affiche un bouton pour partager sur Google+. + - **show_mail**: Affiche un bouton pour partager par e-mail. +- Utilise un fichier CSS: oui. +- Utilise la bibliothèque: ZeroClipboard ### Sparkline ### @@ -270,28 +328,6 @@ - **max\_font\_size**: (défaut: 26), taille de caractères (en pixels) pour le mot le plus fréquent. - Utilise un fichier CSS: oui -### AnnotationsList ### - -- **Rôle**: Affiche une liste d’annotations -- **Options**: - - **ajax\_url**: (défaut: false), spécifie un gabarit d’URL lorsque les annotations doivent être chargées par une API spécifique (API de segment). Dans l’URL, {{media}} sera remplacé par l’ID du média, {{begin}} par le *timecode* de début en millisecondes, {{end}} par le *timecode* de fin en millisecondes. Si le réglage est à *false*, les annotations affichées seront celles chargées à l’initialisation du Widget. Sur la plateforme *Lignes de Temps*, cette URL est http://ldt.iri.centrepompidou.fr/ldtplatform/api/ldt/segments/{{media}}/{{begin}}/{{end}}?callback=? - - **ajax\_granularity**: (défaut: 300000 ms = 5 minutes), spécifie la durée qui doit être chargée par l’API de segment, de part et d’autre du timecode courant (cf. ci-dessus) - - **default\_thumbnail**: imagette à afficher par défaut à côté d’une annotation lorsque l’annotation n’a pas d’imagette. - - **foreign\_url**: spécifie un gabarit d’URL lorsque l’annotation n’a pas d’information d’URL et que l’annotation est dans un autre projet. Dans l’URL, {{media}} sera remplacé par l’ID du média, {{project}} par l’ID du projet, {{annotationType}} par l’ID du type d’annotation, {{annotation}} par l’ID de l’annotation. Sur la plateforme *Lignes de temps*, cette URL est http://ldt.iri.centrepompidou.fr/ldtplatform/ldt/front/player/{{media}}/{{project}}/{{annotationType}}#id={{annotation}} - - **annotation\_type**: (défaut: false), cf. *Options courantes*, plus haut. - - **refresh\_interval**: (défaut: 0), intervalle auquel le widget recharge en Ajax la liste des annotations (que l’on utilise l’API de segment ou non) - - **limit\_count**: (défaut: 10), nombre maximum d’annotations à afficher simultanément. - - **newest\_first**: (défaut: false), *true*: classe les annotations par ordre antéchronologique de création, *false*: classe les annotations par ordre chronologique de leur timecode vidéo. -- Utilise un fichier CSS: oui - -### Media ### - -- **Rôle**: Affiche le média en cours, ainsi que la liste des autres médias du projet. Utilisé principalement pour les mashups -- **Options**: - - **default\_thumbnail**: imagette à afficher par défaut à côté d’un média lorsque le média n’a pas d’imagette. - - **media\_url\_template**: spécifie un gabarit d’URL lorsque le média n’a pas d’information d’URL, par exemple: "http://ldt.iri.centrepompidou.fr/ldtplatform/ldt/front/player/{{media}}/" -- Utilise un fichier CSS: oui - ### Tooltip ### - **Rôle**: Affiche une infobulle, utilisé uniquement comme *widget inclus* dans d’autres widgets. @@ -309,23 +345,9 @@ - Utilise la bibliothèque: ktbs4js tracemanager - Utilise un fichier CSS: non. -### Mediafragment ### - -- **Rôle**: Gère les URLs à la norme *Mediafragment*: change la position de la tête de lecture en fonction de l’URL et inversement. -- Une URL finissant par #id=*id de l’annotation* pointe sur une annotation, par #t=*temps en secondes* vers un timecode de la vidéo. -- Pas d’options -- Utilise un fichier CSS: non. - -### Social ### +### Tweet ### -- **Role**: Affiche des boutons pour partager une URL sur les réseaux sociaux +- **Rôle**: Affiche furtivement le contenu d’un tweet - **Options**: - - **text**: un texte à afficher (dans le tweet, etc.) - - **url**: l’URL à partager - - **show_url**: Affiche un bouton pour copier-coller une URL. - - **show_twitter**: Affiche un bouton pour partager sur Twitter. - - **show_fb**: Affiche un bouton pour partager sur Facebook. - - **show_gplus**: Affiche un bouton pour partager sur Google+. - - **show_mail**: Affiche un bouton pour partager par e-mail. -- Utilise un fichier CSS: oui. -- Utilise la bibliothèque: ZeroClipboard + - **hide_timeout**: (défaut: 5000), durée en millisecondes, avant que l’affichage du Tweet ne se referme + - **polemics**: identique au paramètre *polemics* du widget *Polemic*