From 62d9d29e91e0d40281466fcc21efdae9842b0aa4 Mon Sep 17 00:00:00 2001 From: CM <33868517+MacroController@users.noreply.github.com> Date: Sun, 9 Feb 2025 04:48:23 +0100 Subject: [PATCH] [Fix] Markdown linter problems (#2084) * MD024 * MD033 * MD034 * MD036 * MD040 * MD045 * MD046 --------- Co-authored-by: MacroController --- NOTICE.md | 24 ++++++++++++------------ README.md | 35 +++++++++++++---------------------- docs/BUILD.md | 24 +++++++++++------------- 3 files changed, 36 insertions(+), 47 deletions(-) diff --git a/NOTICE.md b/NOTICE.md index d28f35a31..e4c1ba3b0 100644 --- a/NOTICE.md +++ b/NOTICE.md @@ -1,6 +1,6 @@ # Copyright Notices -### ActiveAndroid +## ActiveAndroid @@ -18,7 +18,7 @@ See the License for the specific language governing permissions and limitations under the License. -### Android Open Source Project +## Android Open Source Project @@ -36,7 +36,7 @@ See the License for the specific language governing permissions and limitations under the License. -### FontAwesome +## FontAwesome @@ -59,7 +59,7 @@ under the SIL OFL 1.1. requirement for fonts to remain under this license does not apply to any document created using the fonts or their derivatives. -### Material Design Icons +## Material Design Icons @@ -67,7 +67,7 @@ Material design icons are the official icon set from Google that are designed under the material design guidelines. Available under the Creative Common Attribution 4.0 International License (CC-BY 4.0). -### Android Flow Layout +## Android Flow Layout @@ -87,7 +87,7 @@ Extended linear layout that wrap its content when there is no place in the curre License for the specific language governing permissions and limitations under the License. -### Dagger 2 +## Dagger 2 @@ -108,7 +108,7 @@ A fast dependency injector for Android and Java. See the License for the specific language governing permissions and limitations under the License. -### AutoFactory +## AutoFactory @@ -128,7 +128,7 @@ A source code generator for JSR-330-compatible factories. See the License for the specific language governing permissions and limitations under the License. -### Retrolambda +## Retrolambda @@ -138,7 +138,7 @@ Backport of Java 8's lambda expressions to Java 7, 6 and 5 This software is released under the Apache License 2.0. The license text is at http://www.apache.org/licenses/LICENSE-2.0 -### PebbleKit SDK +## PebbleKit SDK @@ -147,7 +147,7 @@ Android PebbleKit SDK to talk to the Pebble via Bluetooth The MIT License (MIT) Copyright (c) 2014 - 2015 Pebble Technology -### AppIntro +## AppIntro @@ -168,7 +168,7 @@ Make a cool intro for your Android app. See the License for the specific language governing permissions and limitations under the License. -### ButterKnife +## ButterKnife @@ -188,7 +188,7 @@ Bind Android views and callbacks to fields and methods See the License for the specific language governing permissions and limitations under the License. -### opencsv +## opencsv diff --git a/README.md b/README.md index 9ebbb7380..01e57c5f6 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,13 @@

Loop Habit Tracker

- + Build & Test - + release - + GitHub

@@ -32,32 +32,23 @@ source. ## Features -* Beautiful, minimalistic and lightweight interface. -Loop has an elegant and minimalistic interface that is very easy to use, even for first-time users. Highly optimized for speed, the app works well even on older phones. +* **Beautiful, minimalistic and lightweight interface.** Loop has an elegant and minimalistic interface that is very easy to use, even for first-time users. Highly optimized for speed, the app works well even on older phones. -* Habit score. -Loop has an advanced formula for calculating the strength of your habits. Every repetition makes your habit stronger and every missed day makes it weaker. A few missed days after a long streak, however, will not completely destroy your progress, unlike many other don't-break-the-chain apps. +* **Habit score.** Loop has an advanced formula for calculating the strength of your habits. Every repetition makes your habit stronger and every missed day makes it weaker. A few missed days after a long streak, however, will not completely destroy your progress, unlike many other don't-break-the-chain apps. -* Flexible schedules. -In addition to daily habits, Loop supports habits with more complex schedules, such as 3 times per week or every other day. +* **Flexible schedules.** In addition to daily habits, Loop supports habits with more complex schedules, such as 3 times per week or every other day. -* Reminders. -Schedule notifications to remind you of your habits. Each habit can have its own reminder, at a chosen time of the day. Easily check or dismiss your habit directly from the notification. +* **Reminders.** Schedule notifications to remind you of your habits. Each habit can have its own reminder, at a chosen time of the day. Easily check or dismiss your habit directly from the notification. -* Widgets. -Be reminded of your habits whenever you unlock your phone. Colorful widgets allow you to track your habits directly from your home screen, without even opening the app. +* **Widgets.** Be reminded of your habits whenever you unlock your phone. Colorful widgets allow you to track your habits directly from your home screen, without even opening the app. -* Take control of your data. -If you want to further analyze your data, or move it to another service, Loop allows you to export it to spreadsheets (CSV) or to a database file (SQLite). For power users, checkmarks can be added through other apps, such as Tasker. +* **Take control of your data.** If you want to further analyze your data, or move it to another service, Loop allows you to export it to spreadsheets (CSV) or to a database file (SQLite). For power users, checkmarks can be added through other apps, such as Tasker. -* No limitations. -Track as many habits as you wish. Loop imposes no artificial limits on how many habits you can have. All features are available to all users. There are no in-app purchases. +* **No limitations.** Track as many habits as you wish. Loop imposes no artificial limits on how many habits you can have. All features are available to all users. There are no in-app purchases. -* Completely ad-free and open source. -There are no advertisements, annoying notifications or intrusive permissions in this app, and there will never be. The app is completely open-source (GPLv3). +* **Completely ad-free and open source.** There are no advertisements, annoying notifications or intrusive permissions in this app, and there will never be. The app is completely open-source (GPLv3). -* Works offline and respects your privacy. -Loop doesn't require an Internet connection or online account registration. Your confidential data is never sent to anyone. Neither the developers nor any third-parties have access to it. +* **Works offline and respects your privacy.** Loop doesn't require an Internet connection or online account registration. Your confidential data is never sent to anyone. Neither the developers nor any third-parties have access to it. ## Installing @@ -94,7 +85,7 @@ contribute, even if you are not a software developer. ## License - +GPL v3 Copyright (C) 2016-2021 Álinson Santos Xavier diff --git a/docs/BUILD.md b/docs/BUILD.md index ad0d93d1c..df1a682d4 100644 --- a/docs/BUILD.md +++ b/docs/BUILD.md @@ -9,17 +9,17 @@ This pages describes how to download and build the app from the source code. If ## Build using Android Studio -**Step 1: Install git** +### Step 1: Install git The package `git` is required for downloading the source code of the app and submitting changes GitHub. Please see [the git book](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) for further instructions. If you are planning to submit pull requests in the future, it is recommended to [generate and configure your SSH keys](https://help.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). -**Step 2: Download and install Android Studio** +### Step 2: Download and install Android Studio Although Android Studio can be downloaded [from their official website](https://developer.android.com/studio/), a much better option is to install it through [JetBrains Toolbox](https://www.jetbrains.com/toolbox-app/). This tool, developed by the same developers of Android Studio, allows you to easily upgrade and downgrade the IDE, or switch between stable, beta and canary versions. After downloading and installing JetBrains Toolbox, simply click the install button near Android Studio to install the newest stable version of IDE. Beta and canary versions have not been tested and may not work correctly. After installation, launch Android Studio. If this is the first time you launch it, you will need to go through a wizard to setup the IDE. The default options should work fine. The wizard will download all additional components necessary for development, including the emulator, so it may take a while. -**Step 3: Download the source code** +### Step 3: Download the source code To create a complete copy of the source code repository, open the terminal (Linux/macOS) or Git Bash (Windows), navigate to the desired folder, then run: ```bash @@ -27,7 +27,7 @@ git clone https://github.com/iSoron/uhabits.git ``` The repository will be downloaded to the directory `uhabits`. -**Step 4: Open and run the project on Android Studio** +### Step 4: Open and run the project on Android Studio 1. Launch Android Studio and select "Open an existing Android Studio project". 2. When the IDE asks you for the project location, select `uhabits` and click "Ok". @@ -41,7 +41,7 @@ The repository will be downloaded to the directory `uhabits`. The following instructions were tested on **Ubuntu Linux 18.04 LTS** and may need to be modified for other operating systems. -**Step 1: Install basic packages** +### Step 1: Install basic packages To build the application, some basic packages are required. The package `git` is required to download the source code, while `openjdk-8-jdk-headless` is required for compiling Java and Kotlin files. @@ -53,14 +53,14 @@ sudo apt-get install -y git openjdk-8-jdk-headless **IMPORTANT:** Newer JDK versions have not been tested and may not work correctly. -**Step 2: Install Android SDK tools** +### Step 2: Install Android SDK tools The Android SDK tools contains many necessary tools for developing and debugging Android applications. It can be obtained as part of Android Studio, but, for simple command line usage, it can also be downloaded individually. -1. Download the file `sdk-tools-linux-4333796.zip` (or a newer version) from https://developer.android.com/studio/#downloads, and extract it somewhere. In this guide, we assume that it was extracted to `/opt/android-sdk/tools`; that is, the script `/opt/android-sdk/tools/bin/sdkmanager` should exist. +1. Download the file `sdk-tools-linux-4333796.zip` (or a newer version) from , and extract it somewhere. In this guide, we assume that it was extracted to `/opt/android-sdk/tools`; that is, the script `/opt/android-sdk/tools/bin/sdkmanager` should exist. 2. Append the following lines to `~/.profile`, so that other tools can locate your Android SDK installation. It is necessary to restart your terminal for these changes to take effect. -``` +```bash export PATH="$PATH:/opt/android-sdk/tools/bin" export PATH="$PATH:/opt/android-sdk/platform-tools" export ANDROID_HOME="/opt/android-sdk" @@ -71,7 +71,7 @@ export ANDROID_HOME="/opt/android-sdk" yes | sdkmanager --licenses ``` -**Step 3: Download the source code** +### Step 3: Download the source code To create a complete copy of the source code repository, navigate to your home directory and run: ```bash @@ -79,13 +79,11 @@ git clone https://github.com/iSoron/uhabits.git ``` The repository will be downloaded to the directory `uhabits`. -**Step 4: Compile the source code** +### Step 4: Compile the source code 1. Navigate to the directory `uhabits` 2. Run `./gradlew assembleDebug --stacktrace` -If the compilation is successful, a debug APK will be generated somewhere inside the folder `uhabits-android/build/`. Currently, the full path is the following, but it may change in the future: +If the compilation is successful, a debug APK will be generated somewhere inside the folder `uhabits-android/build/`. Currently, the full path is `./uhabits-android/build/outputs/apk/debug/uhabits-android-debug.apk`, but it may change in the future. - ./uhabits-android/build/outputs/apk/debug/uhabits-android-debug.apk - The APK can be installed using the tool `adb`, which should have been automatically installed at `/opt/android-sdk/platform-tools/adb` during compilation of the project.