gama-platform / gama-platform.github.io Goto Github PK

As we now have a working model user folder on github, that would be great to get the update of this repository to get the news on the different models added. A link to the documentation of the model would be quite easy to do.

Hi,

I have been wondering if it is possible to have some custom gaml highlighting for code blocks in github markdown. For example, if you use a code block code block with a language preference for r , it highlights r keywords as below

library(gaml)
k=mean(rnorm(100,1,0.1)

or for python as below:

import numpy as n
float f = n.sin(90)

or java as below:

import numpy
float f = n.sin(90);

Is it possible to create a custom syntax highlight for gaml language on github markdown? I do not know how easy or difficult it is, but could be nice in sharing or exhibiting code on github tutorials.

In the page: https://github.com/gama-platform/gama/wiki/ThreeD_step3, the link to the model in the Complete model section is broken: https://github.com/gama-platform/gama/tree/master/msi.gama.models/models/Tutorials/3D/models/Model

In https://gama-platform.github.io/wiki/Agent-movement.html this link is broken for all the sections in that page such as https://gama-platform.github.io/wiki/references#AgentmovementFollowPath

However, it works in the wiki of the game-platform https://github.com/gama-platform/gama/wiki/Agent-movement

The tutorial on the page: https://github.com/gama-platform/gama/wiki/PredatorPrey_step2 is marked as to be In Progress.

Most of the slides can be found here
https://drive.google.com/drive/folders/0B8DTAk4nDgyNfkltU2VJQkdoRjlTcEpucXdMRzQzS01DcGR6WXZ0NjlZT1pzU2pYSUxyRmM

I will try in the future to add an online editor that will make possible the creation, modification and suppression (management) of the posts contained in the discussion section. It will need a user authentication but I think it will be a nice feature.

Hi

In the auto generated documentation, there is a blank section in all pages of the operators. The second section is always blank in all pages. I think by mistake, there is a misplaced # tag that creates this empty section.

Please modify, I cannot modify because it says auto-generated and do not modify.

When clicking on the link to go to a youtube page, a commit, an issue or a question in the mailing list, it would be nice to have a new tab opening instead of redirecting the user from gama-platform.github.io to the destination page.

In the page https://roiarthurb.github.io/BC2019-Gama-Site/wiki/InstallingPlugins There is a missing picture.

This happens when two pages are side by side, all over the web site.

(moved from https://github.com/gama-platform/gama/issues/2501)

Describe the bug
The page of documentation for the statements on the GAMA website is not properly rendered: https://gama-platform.github.io/wiki/Statements .
In particular, the end of code blocks is not correctly recognized.
For example, for the ask statement is displayed as follow.

To Reproduce
Steps to reproduce the behavior:

1. Go to statement webpage:
   https://gama-platform.github.io/wiki/Statements

Expected behavior
The block code should be properly recognized.

Screenshots

If you write a link

<a href=".." >
     <img src='http://img.youtube.com/vi/6ZlBU6xTcfw/0.jpg' width='425' height=344 />
</a>

The text of the link will be the html corresponding to the importation of the image (the img tag) and not the image itself.

Example :

In the page Home, section: Multiple application domains, the page of additional plugins is not created yet.
see: https://github.com/gama-platform/gama/wiki

See https://gama-platform.github.io/wiki/RoadTrafficModel_step4 in weigthed road network section

in the web page: https://github.com/gama-platform/gama/wiki/LuneraysFlu, the first link in the first paragraph is broken.

Hello,

There is no ressources provided all along the tutorial (map, 3D models, etc).
For the first part (in 2D) we can re-use png from other tutorials (Road Traffic for example), but not in the last step (we have to do some 3D Display).

Also, on that last page, the images are not displayed (probably because of the tiff extension).

Thanks

In the page: https://github.com/gama-platform/gama/wiki, the developer teams are introduced, but it seems that they should be updated. For instance, the link to the MSI Research Team web site is no longer working. And Ummisco seems not well introduced (Address, institution, ..)

In a GitHUb repo, github can recognize automatically the langage use (java, python, etc), however it's not able (yet?) to recognize GAML

The way to do it is to update the Github repository languages.

Starting point is here:
https://help.github.com/articles/about-repository-languages/

What do you think? I think it make sense to add GAML in this folder, I was thinking that maybe @hqnghi88 you could be interested to do it?

In the web page: https://github.com/gama-platform/gama/wiki/LuneraysFlu, there is a missing picture.

Please see that this link leads to nowhere. It comes from
https://github.com/gama-platform/gama/wiki/Headless para 2.

The current page is this one:
https://gama-platform.github.io/wiki/G__GraphicalEditor

By, one more up to date exists:
https://github.com/gama-platform/gama/wiki/G__GraphicalEditor

We should replace the first page by the second one.

The aspect link seems to be broken?
https://gama-platform.github.io/wiki/Statements#aspect

In the page: https://github.com/gama-platform/gama/wiki/ThreeD_step2, Section: Complete Model,
the link to the model is Broken (https://github.com/gama-platform/gama/tree/master/msi.gama.models/models/Tutorials/3D/models/Model). Model missing.

The search filed ( top right of the website) does not work.
Note that it was working a few days ago!

When, using Google Chrome browser to open the website, and use the Inspect tool, each time I am looking for something, I have the following error message:

FINISHING INDEX
(index):3332 FINISHING INDEX ARCHITECTURES
(index):3334 FINISHING INDEX CONSTANTS
(index):3336 FINISHING INDEX LITERALS
lunr.js:2298 Uncaught TypeError: Cannot read property 'fieldVectors' of null
at Function.lunr.Index.load (lunr.js:2298)
at search ((index):3337)
at checkEntry ((index):39)
at HTMLInputElement.onkeypress ((index):21)
lunr.Index.load @ lunr.js:2298
search @ (index):3337
checkEntry @ (index):39
onkeypress @ (index):21

For most of the pages, at the end of the page, there is this kind of text :
//: # (endConcept|export_files)

We need to remove from display (at least).

Hello,

Some images from that tutorial don't load (the link is broken) : https://gama-platform.github.io/wiki/LuneraysFlu

Also, there is some TIFF images (which are not supported by most browsers) to change.

Thanks

Is your request related to a problem? Please describe.
There are many operators which belong to a skill/ plugin that are not useful for a general beginner. These are also available or combined together with all other general core operators.

a beginner browsing through the documentation cannot differentiate if an operator is from the core or from any specific plugin.

Describe the solution you'd like
Group operators of skills/ plugins to a separate page.

Describe alternatives you've considered
use an extra # to create a sub-section right under operator that indicates which plugin the operator belongs to. For example if an operator name has ## level, a### level can mention e.g., BDI. Now this can, in markdown syntax ()[] link to a page ..... GitHub.com/gama-platform/plugins/BDI.wiki

So if I am browsing through the documentation, I quickly notice that it is not the core operator and if I interested further, I can click the hyperlink.

I propose collecting all searched phrases from the GAMA website into a database. This database can then highlight most frequently used phrases. This will help us to improve the documentation on those operators, skills etc etc.

thank you

It would be nice to have a research toolbar (just as on the website gama-platform ). It will need change though, as it uses a database that will give the results of a query. Also it could be great if it is server-side so the user can easily return to the results by using the previous button.

Some plug-in in Jekyll already exist for that kind of job.

• coloured buttons are not left-aligned with the text (maybe it is the case elsewhere, but the visual effect is odd, as if elements were put randomly)
• GIF seems to be loading but it's not playing.

In full screen, the logo appears OK.
But when reducing the size of the screen, the logo is wrongly resized, to become to thin.

In https://gama-platform.github.io/wiki/Batch.html this link is broken
https://gama-platform.github.io/wiki/references#BatchBatch

In the page https://github.com/gama-platform/gama/wiki/New-Version-Changes listing the changes in the new version of GAMA, several points have been noted as coming changes. The page needs to be updated. For example :

Serialization
Serialize simulations and replay them (to come)
Serialization and deserialization of agents between simulations (to come)
Allow TCP, UDP and MQQT communications between agents in different simulations (to come)

Hi all,

I'm the new gama bot !

It's time to create some documentation (How To) on the wiki for users and developers :

• Introduction of the new build system using maven
• Creation of gama extension which use the p2 site on ovh
• Travis build run, configuration
• Using maven with Eclipse
• Add, Modify, Remove dependencies (good pratice ?)

We need also to document future enhancement, linked to this thread gama-platform/gama#146 :

• Simplify the pipeline with only one unique parent.xml ?
• One pom for product and plugin on msi.gama.product generation ?
• Automatic deployment of the P2 site (deployment is possible directly after build, but the command is manual ) ?
• Finish to integrate msi.ext in the build pipeline process
• Tycho pomless activation ?
• Link to gradle building system ?

Other things ?

https://github.com/gama-platform/gama/wiki/Troubleshooting#Ubuntu

There used to be one page called Operators.md which contained all the operators documented in GAMA. I believe that it has been removed due to the fact that the git wiki could not load it due to limitations. However, it was used by the github.io repository for indexing and links for search results because github.io does not have such limitations.

The question is should we consider that this site is different and can use this page (and in that case, restore it) or should we consider this site as a duplicate of the git wiki... Because the operators page was really useful.

Describe the bug
Some items are completely missing from the online, incl. types defined in plugins (like emotion in simple_bdi) or in the core, statements defined in the plugins, etc.

Hello,

The tutorial Co-Modeling Tutorial is incomplete (there is only the skeleton of the tutorial display on the page linked).

Thanks.

The SapeFiles building.shp, road.shp and bounds.shp are needed to start the Road Traffic tutorial, but they are impossible to find on the website.
https://gama-platform.github.io/wiki/RoadTrafficModel_step1

Is your request related to a problem? Please describe.
Currently, when reading the documentation of operators at random, we see the name of the operator, its syntax to use, and a result and an example.

However, a beginner may never know how an operator can be used, which context or what possible problems can be solved. For example, simplex_generator. Reader may not know what it is, and why it is used or in which variable initialisations can be generated using this operator.

Similarly, simplification , reader can never know what it is for. An introduction like: this operator can be used to simplify complex geometries by reducing number of vertices within some acceptable tolerance. Reader is advised to refer to xyz algorithm

Others: signum, solid, strahler

Users are seen asking questions on the forum and then they get a repl from the expert “use the following operator to get what you want, for example you can do something like ......: “

These type of questions can be reduced and makes the documentation more engaging to read and gives the reader opportunity to learn new things. Currently the descriptions are very dry and discuss syntax and input and output .

Describe the solution you'd like
An introduction starting with: This operator can be used to efficiently/automatically check/ generate/ deliver/ create/ solve/ draw ...

Do we want to keep this page as a tab in the top?

https://gama-platform.github.io/news

It sounds pretty empty and pretty old no?

there is already the news in the download and contribute on the left so I think we need to be coherent here, 2 solutions:

1. we keep the news "div" by default for every page (maybe on the right?)?
2. we only display it in the news tab?

The documentation for FIPA is somewhat lacking. For a newbie in the field, it is almost impossible to use.

I'm refering to Using FIPA ACL and Built-in Skills. I could not find any other resource regarding FIPA in GAMA.

Things that should be fixed in the docs

• The first page describes the variable messages as a list containing messages for all performatives; as of GAMA 1.8 RC 2, this variable does not appear to exist; it might have been renamed to mailbox; the second page, on the other hand, does not talk about either messages or mailbox.

• There is no documentation for the fields of the message type. What can I access through it? Contents? Performative? Sender? Protocol? Send time? Delivery time? Reference to the conversation?

• There is no documentation for the fields of the conversation type. What can I access through it? Participants? Map of the last message for each participant? Start time? Protocol?

• For each performative there is a variable containing its messages. But how can I access the contents of end_conversation messages? No specific variable is documented for that. Can I only access them through the mailbox?

• Might be obvious to experts in the field, but it might be worth specifying that messages are removed from all the lists they appear in, once they are replied to by using one of the provided methods.

• Formatting of the documentation appears to be broken (pieces of sentence missing, pieces of markup code appearing as text), but this might be worth another issue, as it is not limited to the FIPA page, but extends to many pages of the GAMA docs, sometimes in a very disruptive way.

On the page download the new release, most of the links are broken.

We can not search for operators of the BDI plugin from search box.

The title should be something else ... "GAMA" or "Welcome"

in the page: https://github.com/gama-platform/gama/wiki/ThreeD_step1, the link : https://github.com/gama-platform/gama/tree/master/msi.gama.models/models/Tutorials/3D/models/Model is broken.

The tutorial for Different types of chart is not finishing:
https://github.com/gama-platform/gama/wiki/DefiningCharts

Hi,

Does the automated updating of the wiki + the GitHub.io websites work ? I understood it should be handled by Travis, but I've added some artifacts to GAML recently and they dont show up anywhere.

Alexis

Hello,

All over the website are some TIFF images.
As you can see on that Wikipedia link, switching them on JPEG, PNG or GIF will turn the website in a greater compatibility.

Also, I recommend using JPEG or PNG more than GIF (this format is very heavy for nothing). And if the image doesn't use any transparency, prefer JPEG (a little lighter than PNG in general).

Thanks =)

It would be great to be able to acces some dynamic map representing different data about GAMA for instance:

• Developper map (who is contributing)
• User Map (ideally could be linked to IP adress)
• Workshop map
  etc etc

I am starting to look at tools like MapBox or Carto that could be used to realize such a map.
Many example can be found here
https://docs.mapbox.com/mapbox-gl-js/examples/

This is for instance a quick one that I did for CityScience Network