SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

288 Plugins, 197 contribs On SPIP-Zone, 213 visitors now

Home > Interactivité, échanges > Jeux > Go diagrams with maxiGos > Go diagrams with maxiGos.

Go diagrams with maxiGos.

20 May 2017 – by Robert Sebille

All the versions of this article: [English] [français]

1 vote

Cette contribution ou ce plugin est en phase de test. Des bugs peuvent subsister. N’hésitez pas à les signaler dans le forum ci-dessous.

Maxigos is a plugin for SPIP which allows the use of the main features of maxiGos, “a set of tools to insert games, problems and go diagrams saved in sgf format in a web page.”

The plugin works on basis of a model. The sgf code can be written as a parameter of the model or contained in an sgf (Smart Game Format) file.

The plugin was tested under SPIP 3.1, but there is no reason it should not work under SPIP 3.0, or 2.1 and 2.0. You have to test. Feedbacks from users are welcome.

Installation.

As any spip plugin

Authorization of SGF documents

SPIP has “forgotten”;) to allow .sgf extension files and compresses them as zip files. They have to be authorized directly in the database, by adding a row in the “spip_type_documents” table. The plugin performs this operation on activation.

Third party.

The plugin embeds its own version of maxiGos, v6.64 (standalone players only + editor + language files), licensed BSD.

Rules for sgf format.

If you want to write sgf directly into the content, refer to the spécifications. But, most of the time, you will probably prefer to use sgf files.

Model parameters

formatting
-  langue=[langue] where [langue] can take the values : fr (for French, default), en (for English), ja (for Japanese), zh (for Chinese), zh-tw (for Chinese-taiwan)
-  style=[style] where [style] can take the values: classic (default), neo (for neo-classic), tatami, minimal (for minimalist), cameleon, [which are multitype values] or fm, kifu, tiger [which are monotype values]
-  type=[type] where [type] can take the values: basic (default), comment, diagram, game, problem, tree [which are multistyle values], edit, lesson [which are monostyle values]

For the meaning of the style and type parameters, refer to the examples on this page http://jeudego.org/maxiGos/_maxigos/_doc/_en/download.php from the maxiGos website under the heading “Download stand-alone players only” and view the examples.

Multitypes or monotypes, and multistyles or monostyles

  • Multitypes style values ​​and multistyles type values ​​can be associated, for example: | style=neo | type=comment or | style=cameleon | type=problem
  • On the other hand,
    • The monotype style values ​​(fm, kifu, tiger) have their own type (and therefore the | type=[something] parameter will not do anything with these styles.
    • And the monostyle types (edit, lesson) have their own style (and therefore the | style=[something] parameter will not work with these types.

SGF content
If the two following parameters (id_doc and contenu) are present, only the id_doc parameter will be taken into account.
-  id=XX or <maxigosXX|[...]> - the content is in a file of id=XX, with extension .sgf, downloaded via SPIP. Regardless of whether the file is linked to the object (such as the article) where the model call is inserted
-  contenu=a_sgf_content_directly_written - the SGF content is written directly or copied/pasted into the SPIP object. Beware, sgf content manually written in an article, does not support the “|” (pipe). This applies only to the contenu parameter.

Customization parameters, by types and styles

  • All types
    • init=[init] where [init] can take the values: first (default, =go to the start of the SGF) or last (=go to the end of the main variant of the SGF file) - maxiGos parameter: initMethod
    • ombre=X where X can take the values: 0 (default, =does not display a shadow on stone bottom right) or 1 (=displays a shadow on stone bottom right). - maxiGos parameter: stoneShadowOn
  • Types basic, comment, game, tree, edit, lesson and styles fm, tiger
    • demo=X where X can take the values: 0 (=the visitor can place stones on the goban and thus create variants) or 1 (=the visitor can not place a stone on the goban or create variants). Practical for demonstrations. - Parameter maxiGos: (opposite to) canPlaceVariation
  • Types comment, diagram, problem, tree, lesson, styles fm, tiger, kifu and all tatami style types
    • indices=X where X can take the values: 0 (=The indices are not displayed arround the goban), 1 (=The indices are displayed arround the goban) or undefined (=the SGF decides via the FG property). - Parameter maxiGos: indicesOn
    • numeros=X where X can take the values: 0 (=the stones on the goban are not numbered), 1 (=the stones on the goban are numbered) or undefined (=the SGF decides via the PM property). - MaxiGos parameter: numberingOn
  • Types tree, edit, and tiger style
    • commentaire_arbre=X where X can take the values: 0 or 1 (= If X is 1, replaces in the tree commented move numbers by a “?”). - maxiGos parameter: markCommentOnTree
  • Type problem only.
    • recommencer_tout=X where X can take the values: 0 or 1 (=If recommencer_tout is 1, displays a retry button). - maxiGos parameter: canRetry
    • reprendre_coup=X where X can take the values: 0 or 1 (= If reprendre_coup is 1, displays an undo button). - MaxiGos parameter: canUndo
    • montrer_suite=X where X can take the values: 0 or 1 (= If montrer_suite is 1, displays a continuation button. A click on this button shows moves of the first branch of the sgf tree from the current position). - MaxiGos parameter: canContinuation

Examples of use.

In an article, since the use in a template appears here irrelevant.

<maxigos|content=(;FF[4]GM[1]SZ[19]VW[aa:ii]FG[1]AW[ee]AB[de][fe][ed];B[ef]C[Correct !])> will present an example of a problem (taking a stone), in classic style, basic type.

<MaxigosXX|style=tatami|type=tree|language=zh> will display a tatami-style player, with a tree type, in Chinese language, from the game or the problem contained in a .sgf file of id=XX.

Temporary demonstration

In the articles of this section

updated on 20 May 2017

Back to top

Comment on this article

Who are you?
  • [Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Add a document

Back to top

Here they're talking

  • (fr) Rubriqueur

    1er octobre 2014 – 19 commentaires

    Créer rapidement une arborescence complète de rubriques et d’articles Ce plugin permet de créer rapidement une arborescence complète de rubriques et d’articles à partir d’une simple liste saisie dans un formulaire. L’arborescence peut être créée à la (...)

  • (fr) Slick

    17 mai – commentaires

    Intégration à SPIP du carrousel Slick : https://kenwheeler.github.io/slick/ Fonctions de Slick Son utilisation permet d’afficher une liste d’éléments défilants, en l’occurrence ici une série de photographies. Par les configurations proposées, il est (...)

  • (fr) BootStrap pour SPIP

    18 mars 2015 – 37 commentaires

    Documentation source http://spipr.nursit.com/bootstrap Présentation BootStrap est un framework qui facilite et accélère le développement Front-End. Il inclue une base CSS très complète (au format LESS) configurée à partir d’un (...)

  • (fr) ScolaSPIP 4

    19 janvier 2016 – 198 commentaires

    ScolaSPIP est plugin-squelette responsive personnalisable pour sites Web d’établissements scolaires basé sur SPIPr Présentation de ScolaSPIP Ce plugin pour SPIP 3 est développé par la Dane de l’académie de Versailles pour les webmestres de cette (...)

  • (fr) Import ICS 2 et supérieur (agenda distant)

    2 août 2016 – 52 commentaires

    La version 2 du plugin « import ICS » en reprend la principale fonctionnalité, à savoir l’ajout automatique d’évènements distants dans la liste des évènements d’un site. À la différence de la première version, elle ne dépend pas du plugin « Séminaire » et est (...)

There they're spiping