Skip to content

Commit

Permalink
update readme.md
Browse files Browse the repository at this point in the history
  • Loading branch information
aircjm committed Sep 12, 2024
1 parent 9f6f848 commit 53a5939
Show file tree
Hide file tree
Showing 2 changed files with 141 additions and 17 deletions.
100 changes: 83 additions & 17 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,35 +1,101 @@
# limon
# Limon - Personal Note Management Service

## Documentation
Limon is an easy-to-setup personal note management service designed for simplicity, stability, and scalability.

## Project Vision

## Community
The Limon project aims to create a simple, stable, and scalable personal note management service with the easiest setup possible. Future plans include expanding into a comprehensive GTD (Getting Things Done) and Zettelkasten note-taking service, integrating personal time management and note management into a unified information management service.

## Features
Since Limon uses Markdown, it requires specific templates for Markdown formatting.

this is a monorepo fullstack project about a card mgt project in different language.
- **Intuitive Data Management**: Display data in a card format to allow users to manage and operate data intuitively.
- **Flexible Function Expansion**: Support merging cards, countdown functions, and other features to meet different scenarios.
- **Front-end and Back-end Separation**: Use Java for the back-end and Vue 3 for the front-end to achieve a separated architecture, improving development efficiency and maintainability.
- **Easy Deployment**: Use Docker for back-end deployment to simplify the deployment process and reduce operational costs.

### backend
## Key Features

Please see [limon-server](./java/README.md).
- **Import Trello Notes**: Easily import notes from Trello.
- **Convert to Anki Notes**: Automatically convert note content into Anki-compatible Markdown notes for review and retention.
- **Card Display**: Display data in a card format with support for multiple card layouts.
- **Card Management**: Support creating, editing, deleting, and searching cards.
- **Card Merging**: Support merging multiple cards into one card for easy data integration.
- **Countdown Function**: Add countdown functions to cards, suitable for scenarios requiring timed reminders.
- **Responsive Design**: Support responsive layouts for different devices to ensure good display on various devices.

### frontend
## Important Notes

Please see [vite-naiveui](./vue/vite-naiveui/README.md).
- **Database Configuration**: Ensure you specify the correct database for your setup.

### Fast
### Initializing the Database

I try to make it not rather slow. At least select, tree, transfer, table and cascader work with virtual list.
```shell
docker run -it --name limon-mysql -p 3306:3306 -v /d/dockerDrive/mysql:/app -e MYSQL_DATABASE=limon -e MYSQL_USER=db_test -e MYSQL_PASSWORD=123456 -e MYSQL_ROOT_PASSWORD=123456 mysql:8.0
```

What's more, ..., no more. Just enjoy it.

## Installation
## Deployment Details

## Contributing
### Front-end Deployment

Please see [CONTRIBUTING.md](./CONTRIBUTING.md).
1. **Build for Production**:
```bash
cd vue/vite-naiveui
npm run build
```

2. **Deploy to Server**:
Deploy the files in the `dist` directory to your web server (such as Nginx, Apache) or static file hosting service (such as GitHub Pages, Netlify).

### Back-end Deployment

1. **Deploy Using Docker**:
```bash
docker run -d -p 8080:8080 --name limon-backend-container limon-backend
```

2. **Configure Database**:
Ensure the database service is running and configure the database connection information correctly in the backend configuration file.

## Contributing Guidelines

We welcome contributions from the community! If you are interested in contributing to the Limon project, please follow these steps:

1. **Fork the Project**: Click the "Fork" button on the GitHub page to fork the project to your GitHub account.

2. **Create a Branch**: Create a new branch in your forked project for developing your feature or fixing a bug.

3. **Submit a Pull Request**: After completing the development, submit a Pull Request describing your changes and purpose.

4. **Code Review**: The project maintainers will review your Pull Request and provide feedback.

5. **Merge Code**: Once the Pull Request is accepted, your code will be merged into the main branch.

## License

Naive UI is licensed under the [MIT license](https://opensource.org/licenses/MIT).
## Backup and Restore

### Backup

```shell
docker exec limon-mysql /usr/bin/mysqldump -u root --password=root limon > backup.sql
```

### Restore

```shell
docker exec -i limon-mysql mysql -u root --password=root limon < backup.sql
```



## Special Thanks

- **Anki Markdown Integration**: Thanks to [Using Markdown in Anki](https://zhuanlan.zhihu.com/p/137570649) for guidance on displaying Markdown in Anki.
- **RuoYi Scaffold**: Thanks to [RuoYi](https://gitee.com/y_project/RuoYi-Vue) for the project scaffold design.
- **JetBrains Support**: Special thanks to JetBrains for their open-source license support.

[![jetbrains.svg](jetbrains.svg)](https://www.jetbrains.com/?from=limon)

## License

This project is licensed under the MIT License. Full license details can be found in the [LICENSE](https://github.com/aircjm/limon/blob/master/LICENSE) file.
58 changes: 58 additions & 0 deletions java/README_EN.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
# Limon - Personal Note Management Service

Limon is an easy-to-setup personal note management service designed for simplicity, stability, and scalability.

## Project Vision

The Limon project aims to create a simple, stable, and scalable personal note management service with the easiest setup possible. Future plans include expanding into a comprehensive GTD (Getting Things Done) and Zettelkasten note-taking service, integrating personal time management and note management into a unified information management service.

Since Limon uses Markdown, it requires specific templates for Markdown formatting.

## Key Features

- **Import Trello Notes**: Easily import notes from Trello.
- **Convert to Anki Notes**: Automatically convert note content into Anki-compatible Markdown notes for review and retention.

## Important Notes

- **Database Configuration**: Ensure you specify the correct database for your setup.

### Initializing the Database

```shell
docker run -it --name limon-mysql -p 3306:3306 -v /d/dockerDrive/mysql:/app -e MYSQL_DATABASE=limon -e MYSQL_USER=db_test -e MYSQL_PASSWORD=123456 -e MYSQL_ROOT_PASSWORD=123456 mysql:8.0
```

## Backup and Restore

### Backup

```shell
docker exec limon-mysql /usr/bin/mysqldump -u root --password=root limon > backup.sql
```

### Restore

```shell
docker exec -i limon-mysql mysql -u root --password=root limon < backup.sql
```

## Special Thanks

- **Anki Markdown Integration**: Thanks to [Using Markdown in Anki](https://zhuanlan.zhihu.com/p/137570649) for guidance on displaying Markdown in Anki.
- **RuoYi Scaffold**: Thanks to [RuoYi](https://gitee.com/y_project/RuoYi-Vue) for the project scaffold design.
- **JetBrains Support**: Special thanks to JetBrains for their open-source license support.

[![jetbrains.svg](jetbrains.svg)](https://www.jetbrains.com/?from=limon)

## License

This project is licensed under the MIT License. Full license details can be found in the [LICENSE](https://github.com/aircjm/limon/blob/master/LICENSE) file.

## References

For additional backup and restore commands, refer to:

```shell
docker exec mysql_container_name /usr/bin/mysqldump -u user_name --password=user_password db_name > backup.sql
```

0 comments on commit 53a5939

Please sign in to comment.