Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
macareonie authored Aug 29, 2024
1 parent 7c26060 commit fd0d828
Showing 1 changed file with 121 additions and 24 deletions.
145 changes: 121 additions & 24 deletions README.md
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)

0 comments on commit fd0d828

Please sign in to comment.