You are previewing Mastering Redmine.
O'Reilly logo
Mastering Redmine

Book Description

Redmine is an open source gem for project management, and this book shows you how to exploit its features to the max. Written as a practical tutorial, it’s also the perfect reference guide to have by your side.

  • Use Redmine in the most effective manner and learn to master it

  • Become an expert in the look and feel with behavior and workflow customization

  • Utilize the natural flow of chapters, from initial and simple topics to advanced ones

  • In Detail

    Redmine is well-known as one of the best open source project management applications. But, it's also one of the best project hosting and issue tracking solutions. In addition it incorporates Wiki, repository management, forums, time tracking, and more. This book reveals the power of Redmine and manifests its exceptional flexibility and customizability.

    Mastering Redmine is a comprehensive guide which covers a wide variety of topics: from configuration to writing simple plugins, from issue reporting to managing issue lifecycles, from writing simple Wiki pages to designing rich web content using the Wiki syntax, from quick installation to deep customization, and more.

    This book resembles a learning tutorial. It imitates the self-learning process so that you first understand the basics before we dig deeper into the advanced concepts.

    You will first read about possible setups. Then, you will choose an appropriate setup to install and configure. The book runs through the main features of Redmine and shows how it can be effectively used as project management, issue and time tracking solution. Once you are familiar with all the essential features of Redmine, you will start exploring advanced concepts such as integration with other applications, customizing Redmine, and using various Redmine plugins.

    This book will help you master Redmine by unleashing it's core functionality .

    Table of Contents

    1. Mastering Redmine
      1. Table of Contents
      2. Mastering Redmine
      3. Credits
      4. About the Author
      5. About the Reviewers
      6. www.PacktPub.com
        1. Support files, eBooks, discount offers and more
        2. Why Subscribe?
        3. Free Access for Packt account holders
      7. Preface
        1. What this book covers
        2. What you need for this book
        3. Who this book is for
        4. Conventions
        5. Reader feedback
        6. Customer support
          1. Errata
          2. Piracy
          3. Questions
      8. 1. Getting Familiar with Redmine
        1. What is Redmine?
          1. Why does Redmine succeed
        2. Walk through the Redmine interface
        3. MySQL, PostgreSQL, or SQLite
        4. Textile or Markdown?
        5. Selecting a Source Control Management (SCM)
        6. Selecting a web server and an application server
        7. Redmine or ChiliProject?
        8. Recent versions of Redmine and ChiliProject
          1. Redmine versions
          2. ChiliProject versions
        9. Helping Redmine
        10. Summary
      9. 2. Installing Redmine
        1. Preface
        2. Installing Redmine from the package
          1. Installing Redmine and MySQL server
            1. Configuring MySQL server package
            2. Configuring Redmine package
          2. Installing Apache and Passenger
          3. Connecting Redmine and Apache
          4. Verifying and completing installation
          5. Conclusion
        3. Installing Redmine from sources
          1. Downloading and installing Redmine
          2. Installing RubyGems and Bundler
            1. Resolving Bundler errors
              1. Searching for a file in non-installed packages under Debian/Ubuntu
          3. Installing MySQL client and ImageMagick
          4. Installing dependencies using Bundler
          5. Installing MySQL server, Apache, and Passenger
          6. Setting up the database
          7. Finalizing Redmine installation
          8. Configuring Apache
        4. Using TurnKey Redmine appliance
        5. Using BitNami Redmine stack
        6. Maintaining Redmine
        7. Summary
      10. 3. Configuring Redmine
        1. The first thing to fix
        2. Administration settings
          1. General
            1. Cache formatted text
            2. Other tips
          2. Display
            1. Default language
            2. Using Gravatar user icons
            3. Default Gravatar image
            4. Display attachment thumbnails
          3. Authentication
            1. Allow OpenID login and registration
            2. LDAP authentication
            3. Enable REST web service
          4. E-mail integration
            1. Sending e-mails
              1. Configuring e-mail notifications using configuration.yml
              2. Configuring e-mail notifications using web interface
              3. Configuring reminding e-mails
            2. Receiving e-mails
              1. Format of incoming emails
              2. Fetching e-mails through web service
              3. Fetching e-mails using IMAP/POP3
          5. Repositories integration
            1. Configuring repositories
              1. Updating repository change sets
                1. Initiating the update from cron
              2. Initiating the update from SCM hook
              3. Automatic repositories creation
              4. Advanced repositories integration
        3. Troubleshooting
        4. Summary
      11. 4. Issue Tracking
        1. Creating an issue
          1. Issue categories
          2. Issues and project versions
        2. Issue page
          1. Subtasks
          2. Related issues
        3. Issue list
          1. Custom queries
        4. Updating issue
          1. Bulk editing
        5. Getting updates on issues
        6. Issue related settings
          1. Enabling or disabling issue tracking
          2. Configuring issue tracking globally
          3. Issues and repository integration
        7. Summary
      12. 5. Managing Projects
        1. Modules
          1. Issue tracking
            1. Roadmap
            2. Version page
          2. News
          3. Documents
          4. Files
          5. Wiki
          6. Repository
          7. Forums
          8. Calendar
          9. Gantt
        2. Global configuration
        3. Creating a project
        4. Basic project tabs
          1. Overview
          2. Activity
        5. Configuring projects
          1. Information
          2. Modules
          3. Members
          4. Versions
          5. Wiki
        6. Closing a project
        7. Project maintenance best practices
          1. Custom queries
        8. Project list
        9. Administrating projects
          1. Copying projects
          2. Archiving
        10. Summary
      13. 6. Time Tracking
        1. Using Redmine time tracking
        2. Defining activity
        3. Tracking time
          1. Tracking time using commit messages
        4. Checking spent time
          1. Time spent for issues
          2. Time spent for versions
          3. Time spent for projects
          4. Project activity
          5. Your time entries
        5. Generating reports
          1. Details tab
          2. Report tab
          3. Summary
      14. 7. Text Formatting
        1. Formatting text in Redmine
          1. Wiki toolbar
          2. Preview
          3. Placing the linked images
        2. Wiki formatting syntax
          1. Basics
          2. Quotes
          3. Lists
          4. Images
          5. Links
            1. Normal links
            2. Internal links
              1. Wiki links
              2. Project links
              3. Version links
              4. Issue links
              5. Attachment links
              6. News links
              7. Document links
              8. Forum links
              9. Links to repository
          6. Code
          7. Tables
          8. Macros
            1. Table of contents
            2. Collapsed block
            3. Thumbnail
            4. Include
            5. Child pages
            6. Hello world
            7. Macro list
          9. Advanced syntax
            1. Alignment
            2. Padding
            3. Custom style and language
            4. Textile span
            5. Disabling element
            6. Table advanced syntax
        3. Quick syntax reference
        4. Summary
      15. 8. Access Control and Workflow
        1. Roles
          1. Permissions
            1. Project block
            2. Forums block
            3. Calendar block
            4. Documents block
            5. Files block
            6. Gantt block
            7. Issue tracking block
            8. News block
            9. Repository block
            10. Time tracking block
            11. Wiki block
        2. Permissions report
        3. Trackers
        4. Issue statuses
        5. Workflow
          1. Issue status transitions
          2. Issue fields permissions
          3. Quick functions
            1. Copying configuration
            2. Summary link
        6. Modifying workflow
          1. Adding roles
          2. Adding trackers
          3. Adding issue statuses
        7. Practical example
        8. Summary
      16. 9. Personalization
        1. Automatic account creation
          1. OpenID
          2. LDAP
        2. Gravatar
        3. Personal page
          1. Issues assigned to me
          2. Watched issues
          3. Spent time
          4. Documents
          5. Reported issues
          6. Latest news
          7. Calendar
        4. Getting updates
          1. Notification settings
          2. Watching
          3. News feeds
        5. Personalizing issue lists
        6. Summary
      17. 10. Plugins and Themes
        1. Looking up plugins
          1. Official registry
          2. Github
        2. Installing a plugin
          1. Uninstalling a plugin
        3. Plugins review
          1. Meta
          2. Exception Handler
          3. Mylyn Connector
          4. Screenshot Paste
          5. Lightbox
          6. Code Review
          7. Niko Cale
          8. Stuff To Do
        4. Themes
          1. Installing themes
          2. Themes review
            1. Basecamp
            2. Modula Mojito
            3. A1
            4. Highrise
        5. Summary
      18. 11. Customizing Redmine
        1. Custom fields
          1. Custom field options
            1. Required
            2. Visible
            3. Editable
            4. For all projects
            5. Searchable
            6. Used as a filter
          2. Custom field formats
            1. Text
            2. Long text
            3. Integer
            4. Float
            5. List
            6. Date
            7. Boolean
            8. User
            9. Version
          3. Customized object types
            1. Issues
            2. Spent time
            3. Projects
            4. Versions
            5. Users
            6. Groups
            7. Activities (time tracking)
            8. Issue priorities
            9. Document categories
        2. Customizing with Textile
          1. Warnings and other boxes
          2. Icons for text
          3. Table-based layout
        3. Customizing themes
        4. Customizing with plugins
          1. Writing a simple plugin
          2. Customizing view files
          3. Using hooks
        5. Summary
      19. Index