cards

MemoryOverflow - Cards & Editions

MemoryOverflow game is based on cards. Each one is unique and can be used in many different ways according to the strategy of the player. Cards are grouped by editions which represent different themes.

1. Editions
2. Contribute!

• Create a new card
• Improve/Fix existing card

Editions

Here are the list of all editions:

• Fundamentals edition

Contribute!

In this project, everyone is free to contribute. To do that, you must first learn how to use The Machine. It's very easy and takes 10min to start writing your first card. Of course, you don't have to learn writing code or something technical else. The Machine is here to generate your cards automatically.

Create a new card

To be used by The Machine, each card has a generic configuration. It's possible to create cards in differents programming languages and translations.

The folder structure

A card must be located inside an edition. Each card is composed of files inside a folder name.

Here is the folder configuration:

/cards/[edition name]/[card name]/
    -> README.md
    -> [card name].md
    -> [card name].en_US.po
    -> [card name].[translation].po

A card must have these files. It's possible to add all of the translation you want but you need to have JavaScript format and english translation by default.

README.md file

This file describe the card and its spirit. Its include:

• Its name
• Its description
• Its type
• Its languages supported
• Its translations supported
• A link to its configuration file
• Its changelog

[card name].md file

This file is a Markdown format. It describe in details the card divided in sections by title.

Here is the format:

# title

The full title of the card

# description

The description of the card

# status

Status can only be: "working", "playing" or "deprecated"

# edition

The name of the card edition

# type

Type can only be: "variable", "code", "event" or "the machine"

# author

The full name of the author followed by its Twitter account

# code:javascript

This block is only used for a card with "variable" or "code" type.

Write the specific code of your card and many other informations.

You can add all of the formatting tags like {code}
Use &{} to encapsulate your translated texts

# code:php

You can add all of the codes syntax you want. PHP, Java, C++, etc

# content

This block is used for cards with "event" or "the machine" type.

Write the card action description here.

You can add all of the formatting tags like {code}{/code}
Use &{} to encapsulate your translated texts

All translated text need to be encapsulated by &{my text}.

[card name].[translation].po files

Translations files are used to translate encapsulated texts inside card configuration.

A translation file use the international ISO language code in a Gettext format (.po):

[card name].en_US.po -> English format
[card name].fr_FR.card -> French format
...

Improve/Fix existing card

If a card needs to be fixed, you can:

• Contact the original author of the card so that he corrects himself.
• Add an issue.
• Send a new PR linked to your issue (see the Contribution guidelines)