SPIP-Contrib

SPIP-Contrib

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

288 Plugins, 197 contribs On SPIP-Zone, 221 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]

2 Votes

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 or on European Go Congress 2019 website

updated on 4 July 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) Le plugin ZotSpip

    28 mai 2012 – 138 commentaires

    Synchronise Spip avec une bibliothèque (personnelle ou partagée) de références bibliographiques Zotero. Utilisez Zotero pour gérer / importer / rédiger vos références bibliographiques, puis incorporez vos références bibliographiques dans votre Spip avec (...)

  • (fr) ScolaSPIP 4

    19 janvier 2016 – 213 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) MediaBox

    10 mai 2010 – 514 commentaires

    Avertissement Le présent plugin est installé et activé par défaut sur toute les version de SPIP > 3.0. Inutile donc de l’installer manuellement sauf si vous utilisez SPIP 2.1. Aperçu La MediaBox est une Boîte multimédia polyvalente et (...)

  • (fr) Sommaire automatique

    31 janvier 2013 – 14 commentaires

    Ce plugin repère les intertitres des textes de vos articles et s’en sert pour génèrer un sommaire. Ce dernier peut être inséré automatiquement au début de chaque article, ou utilisé dans les squelettes pour générer un sommaire sur n’importe quel autre (...)

  • (fr) La Fabrique

    20 avril 2012 – 316 commentaires

    La Fabrique est un outil pour webmestres ou développeurs qui souhaitent créer des plugins. La Fabrique est capable de générer le code source minimal d’un plugin pour SPIP 3 (elle accélère donc le démarrage d’un plugin) et peut s’occuper également de (...)