forked from nus-cs2103-AY2324S2/ip
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
7c26060
commit fd0d828
Showing
1 changed file
with
121 additions
and
24 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,24 +1,121 @@ | ||
# Duke project template | ||
|
||
This is a project template for a greenfield Java project. It's named after the Java mascot _Duke_. Given below are instructions on how to use it. | ||
|
||
## Setting up in Intellij | ||
|
||
Prerequisites: JDK 11, update Intellij to the most recent version. | ||
|
||
1. Open Intellij (if you are not in the welcome screen, click `File` > `Close Project` to close the existing project first) | ||
1. Open the project into Intellij as follows: | ||
1. Click `Open`. | ||
1. Select the project directory, and click `OK`. | ||
1. If there are any further prompts, accept the defaults. | ||
1. Configure the project to use **JDK 11** (not other versions) as explained in [here](https://www.jetbrains.com/help/idea/sdk.html#set-up-jdk).<br> | ||
In the same dialog, set the **Project language level** field to the `SDK default` option. | ||
3. After that, locate the `src/main/java/Duke.java` file, right-click it, and choose `Run Duke.main()` (if the code editor is showing compile errors, try restarting the IDE). If the setup is correct, you should see something like the below as the output: | ||
``` | ||
Hello from | ||
____ _ | ||
| _ \ _ _| | _____ | ||
| | | | | | | |/ / _ \ | ||
| |_| | |_| | < __/ | ||
|____/ \__,_|_|\_\___| | ||
``` | ||
# Tsundere User Guide | ||
|
||
<img src="docs/Ui.png" width="400" alt="Ui"> | ||
|
||
Watched too much anime but still can't get enough of your favourite tsundere waifu?<br> | ||
Look no further! Your friendly ~~(or not)~~ Tsundere chatbot assistant is here as your personal task manager! | ||
|
||
## Setting Up π οΈ | ||
All you need to do is, | ||
1. Ensure you have Java `11` installed in your computer. [How to check](https://www.baeldung.com/java-check-is-installed) | ||
- If you do not have Java `11`, download it from [here](https://www.oracle.com/java/technologies/javase/jdk11-archive-downloads.html) | ||
- Help with configuring correct Java version: [Windows](https://www.happycoders.eu/java/how-to-switch-multiple-java-versions-windows/) | [MacOS](https://stackoverflow.com/questions/21964709/how-to-set-or-change-the-default-java-jdk-version-on-macos) | [Linux](https://www.baeldung.com/linux/java-choose-default-version) | ||
1. Download the latest ``tsundere.jar`` release file from [here](https://github.com/macareonie/ip/releases/). | ||
1. Copy the downloaded file to the folder you want to use as the _home folder_ for your Tsundere Task Assistant. | ||
1. Double click the `tsundere.jar` file. Alternatively, for users with command line experience, open up your favourite terminal and navigate to the directory using `cd` and type the command `java -jar tsundere.jar`. | ||
|
||
Now the GUI would have popped up and you can start managing your tasks! | ||
|
||
## Adding Tasks β | ||
|
||
There are three types of tasks which can you add: ToDos, Events and Deadlines. | ||
|
||
__Format:__ | ||
- `todo [task]` | ||
- `event [task], from [ ], to [ ]` | ||
- `deadline [task], by [YYYY-MM-DD]` | ||
|
||
π‘ __Things to note:__ | ||
- Omit the square brackets `[]` when entering the commands | ||
- Adding events currently supports any input for the `from` and `to` fields | ||
- Adding deadlines currently supports only the data format `YYYY-MM-DD` | ||
|
||
<br> | ||
|
||
![img.png](docs/add.png) | ||
|
||
A confirmation response will be seen once a task has been successfully added with the notation `T`, `E` and `D` denoting _ToDos_, _Events_ and _Deadlines_ respectively. | ||
|
||
## Listing Tasks π | ||
|
||
You can list all recorded tasks. | ||
|
||
__Format:__ | ||
- `list` | ||
|
||
<br> | ||
|
||
![img.png](docs/list.png) | ||
|
||
## Deleting Tasks β | ||
|
||
You can delete tasks based on their index or task number. | ||
|
||
__Format:__ | ||
- `delete [task number]` | ||
|
||
|
||
π‘ __Things to note:__ | ||
- Omit the square brackets `[]` when entering the commands | ||
- Inputting invalid task numbers will prompt you with the proper command format | ||
|
||
<br> | ||
|
||
![img.png](docs/del.png) | ||
|
||
A confirmation response will be seen once a task has been successfully deleted. | ||
|
||
## Additional Features β π·οΈπ | ||
|
||
1. Marking and Unmarking tasks | ||
2. Tagging and Untagging tasks | ||
3. Finding tasks by keyword | ||
|
||
__Format:__ | ||
- `mark [task number]` | ||
- `unmark [task number]` | ||
- `tag [task number] [tag name]` | ||
- `untag [task number] [tag name]` | ||
- `find [keyword]` | ||
|
||
π‘ __Things to note:__ | ||
- Omit the square brackets `[]` when entering the commands | ||
- Inputting invalid task numbers will prompt you with the proper command format | ||
- You can tag each task with a maximum of 3 unique tags | ||
- The find command is currently case-sensitive | ||
- Tasks are unmarked by default denoted with `[ ]` while marked tasks are denoted with `[X]` | ||
- Tagged tasks have their tags appended after their description. Eg. `...borrow book #fun...` | ||
|
||
<br> | ||
<img src="docs/tag.png" width="400" alt="mark/tag"> | ||
|
||
<img src="docs/find.png" width="400" alt="find"> | ||
|
||
## Getting help π | ||
|
||
If you can't be bothered to read the rest of the User Guide or if you need help while using the program. `help` displays all the available commands. | ||
|
||
__Format:__ | ||
- `help` | ||
|
||
<br> | ||
<img src="docs/help.png" width="400" alt="mark/tag"> | ||
|
||
## Exiting program and Saving data πΎ | ||
|
||
__Format:__ | ||
- `bye` | ||
|
||
Typing `bye` exits the program and automatically saves the current session data into a `data.txt` file. A new `data.txt` will be created if one doesn't exist already. | ||
|
||
## FAQ βπββοΈ | ||
|
||
__Q:__ Can I edit the data file directly or transfer it to another device? <br> | ||
__A:__ Data storage is done by converting each task and their details to strings and parsing them when loading it for a new session. As such, invalid changes to the `data.txt` file could cause problems and it is not recommended to directly edit the file. | ||
To transfer data to another device, just copy the `data.txt` file to the `data` directory of the `tsundere.jar` file. | ||
|
||
## Acknowledgements for images | ||
|
||
- [Image 1](src/main/resources/images/chitoge.png): [Source url](https://iconsanimes.tumblr.com/post/121779963864/chitoge-kirisaki-icons-like-if-you-save) | ||
- [Image 2](src/main/resources/images/chitoge2.png): [Source url](https://www.pngegg.com/en/png-xgngy) | ||
- [Image 3](src/main/resources/images/ok.png): LaVanessaL, [Source url](https://7tv.app/emotes/6268904f4f54759b7184fa72) |