Changes between Version 1 and Version 2 of WikiStart

Dec 9, 2005, 1:55:02 PM (14 years ago)



  • WikiStart

    v1 v2  
    1 = Welcome to Trac 0.8.4 =
     1= libmines =
    3 Trac is a '''minimalistic''' approach to '''web-based''' management of
    4 '''software projects'''. Its goal is to simplify effective tracking and handling of software issues, enhancements and overall progress.
     3This project is brand-new, so don't expect to find much here just yet.
    6 All aspects of Trac have been designed with the single goal to
    7 '''help developers write great software''' while '''staying out of the way'''
    8 and imposing as little as possible on a team's established process and
    9 culture.
     5"{{{libmines}}}" is yet another implementation of the infamous Minesweeper game--but as a library this time.
    11 As all Wiki pages, this page is editable, this means that you can
    12 modify the contents of this page simply by using your
    13 web-browser. Simply click on the "Edit this page" link at the bottom
    14 of the page. WikiFormatting will give you a detailed description of
    15 available Wiki formatting commands.
     7I'm sure you know the Minesweeper game: you start out with a rectangle of water, divided into squares.  Each of the squares may or may not contain a mine; you find out by clicking on it.  If it held a mine, you die.  If it didn't, it shows the total number of mines present in the eight surrounding squares.  This hopefully gives you enough information to figure out that some neighbouring square is also "safe," and so on.  Sometimes the game helps you a bit by revealing the squares that are absolutely obvious automatically.
    17 "[wiki:TracAdmin trac-admin] ''yourenvdir'' initenv" created
    18 a new Trac environment, containing a default set of wiki pages and some sample
    19 data. This newly created environment also contains
    20 [wiki:TracGuide documentation] to help you get started with your project.
     9== Why? ==
    22 You can use [wiki:TracAdmin trac-admin] to configure
    23 [ Trac] to better fit your project, especially in
    24 regard to ''components'', ''versions'' and ''milestones''.
    27 TracGuide is a good place to start.
    29 Enjoy! [[BR]]
    30 ''The Trac Team''
    32 == Starting Points ==
    34  * TracGuide --  Built-in Documentation
    35  * [ The Trac project] -- Trac Open Source Project
    36  * [ Trac FAQ] -- Frequently Asked Questions
    37  * TracSupport --  Trac Support
    39 For a complete list of local wiki pages, see TitleIndex.
    41 Trac is brought to you by [ Edgewall Software],
    42 providing professional Linux and software development services to clients
    43 worldwide. Visit for more information.
     11Believe it or not, there were still reasons to write a new Minesweeper.  Some of these were:
     12 * Clean separation of user interface and game logic.  This project is currently all about the game logic.  Others write better user interfaces than I can!
     13 * Different rules.  Viewing the game logic separately from presentation allows for variations on the game.  For instance, most Minesweeper games won't ever reveal mines--all you can do is set little flags to remind you where you deduce the mines must be.  That's different here, if your user interface will support it.  Also, the library can reveal the safe squares around the minefield right away to help get you started.  Most other versions of the game let you gamble and die a few times before you get a decent start!
     14 * Intelligence.  "Normal" Minesweeper games will help you a bit if you hit a square with no nearby mines: they will automatically reveal the neighbouring squares, and if any of those is also near 0 mines, that square's neighbours are also revealed and so on.  This still leaves a lot of squares that are "obviously safe" to me, but need to be clicked anyway.  This is where I usually make most of my mistakes.  Instead, this library has multiple levels of intelligence.
     15 * Keep the brain working.  With smarter "auto-completion" of the game, the player is left with the interesting problems--the little puzzles that make the game fun.  Now you can tackle much larger minefields at higher difficulty levels, without wasting time on the easy parts.