diff --git a/README.md b/README.md index dbee614e..e95133f0 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -#Anonymouth +# Anonymouth ![](src/edu/drexel/psal/resources/graphics/readme_Logo.png) @@ -9,7 +9,7 @@ Drexel University, Philadelphia PA
-#Index +# Index 1. Set Up - [Introduction](#introduction) - [Dependencies](#dependencies) @@ -24,9 +24,9 @@ Drexel University, Philadelphia PA
- [Developers](#developers) - [License](#license) -#Set Up +# Set Up -###Introduction +### Introduction Anonymouth is a Java-based application that aims to give users to tools and knowledge needed to begin anonymizing documents they have written. @@ -36,7 +36,7 @@ Though Anonymouth and it's team works hard to provide you with tools to help rem [Back to top](#top) -###Dependencies +### Dependencies Java 7 is required to run Anonymouth. If you don't yet have it, get it at Oracle's website here and follow the installation instructions provided there. @@ -106,7 +106,7 @@ Anonymouth also needs the following jars in the lib directory (everything should [Back to top](#top) -###Installation +### Installation There quickest and easiest way to install Anonymouth is to clone or download the zip of the Anonymouth github project here @@ -116,7 +116,7 @@ This is currently the only ready way to compile and run Anonymouth. We will be i [Back to top](#top) -###How to Build and Run +### How to Build and Run Once Anonymouth is all set up in Eclipse, you need only run `ThePresident` from the package `edu.drexel.psal.anonymouth.gooie` to begin using it. @@ -124,11 +124,11 @@ Please note that there are two main package categories, JStylo and Anonymouth. T [Back to top](#top) -#Development +# Development -###Basic Logic Flow +### Basic Logic Flow -#####↓ ---LAUNCH--- +##### ↓ ---LAUNCH--- Setup and start up: `anonymouth.gooie.ThePresident` @@ -140,19 +140,19 @@ Should never be accessed in any other class (or at least limit it). It's only pu - Initializes the `GUIMain` instance (and with it all Anonymouth class instances) - Displays the start window, which from there it takes over -#####↓ ---AUTOMATICALLY DISPLAYS--- +##### ↓ ---AUTOMATICALLY DISPLAYS--- Start up window: `anonymouth.gooie.StartWindow` The first window that shows up (not counting the splash screen) when Anonymouth loads up. Allows the user to change advanced processing settings, access the pre process set up wizard, or start Anonymouth -#####↓ ---USER CLICKED START BUTTON--- +##### ↓ ---USER CLICKED START BUTTON--- Initial document processing begins immediately with: `anonymouth.engine.DocumentProcessor` Inititalized within GUIMain as should nearly all Anonymouth class instances, this holds the main method and thread that handles processing and reprocessing documents. All processing events can be traced back to this class. -#####↓ ---PROCESSING COMPLETE--- +##### ↓ ---PROCESSING COMPLETE--- Main GUI Code: `anonymouth.gooie.GUIMain` @@ -171,9 +171,9 @@ The main gui window is displayed. This is also the central "hub" for Anonymouth. [Back to top](#top) -###Basic Class Structure +### Basic Class Structure -#####---Naming Convention--- +##### ---Naming Convention--- For the most part, Anonymouth splits UI objects into two classes: [Class name]Panel/Window and [Class name]Driver. By convention and a general guideline, the Panel/Window class: @@ -189,7 +189,7 @@ While the cooresponding Driver class: Again, these are just general guidelines. Sometimes it makes more sense to just have one class handle everything if it's a small object, or sometimes it doesn't make sense to have a seperate Panel/Window class but it does to have a Driver class, etc. You just need to use your best judgement on what will make things more organized and easier to understand. -#####---Package / Organizing Convention--- +##### ---Package / Organizing Convention--- Anonymouth loosly follows these guidelines for class organization in packages: @@ -202,7 +202,7 @@ There are still quite a few classes that are clearly where they don't belong, so [Back to top](#top) -###To Do List +### To Do List Add features as they are conceived and ~~strikethrough~~ as they are completed ([1] means most important and [5] means relatively small and not particularly a priority at the moment) - [1] AUTOMATE AS MUCH OF THE ANONYMIZATION PROCESS AS POSSIBLE. This should be the top priority as of now, see Andrew for the plan and details. @@ -212,7 +212,7 @@ Add features as they are conceived and ~~strikethrough~~ as they are completed ( [Back to top](#top) -###Known Bugs +### Known Bugs Add bugs as they are discovered and ~~strikethrough~~ as they are completed ([1] means fatal or breaks usability and [5] means relatively small and does not have much of an impact on usability) - [1] During processing on OS X (though the problem may extend to other operating systems as well) the Stanford POS tagger is extremely prone to breaking due to a fatal threading issue which results in heap space or out of memory exceptions. This absolutely MUST be fixed. @@ -223,9 +223,9 @@ Add bugs as they are discovered and ~~strikethrough~~ as they are completed ([1] [Back to top](#top) -#Credits +# Credits -###Developers +### Developers P.I. Dr. Rachel Greenstadt: @@ -242,7 +242,7 @@ Developed by: [Back to top](#top) -###License +### License Anonymouth was released by the Privacy, Security and Automation lab at Drexel University in 2011 under the AGPLv3 license. A copy of this license is included with the repository/program. If for some reason it is absent, it can be viewed here.