Version: 1.3.0
Volistic is a simple open-source launcher program made in Java for the programs made by PD`06 in IB Computer Science class.
Any student can create their own Java CLI program and include it on Volistic.java
(The program launcher).
The steps and procedures to do so are articulated on the 'CONTRIBUTING.md' file.
- Have 'Git' installed (Click on the link to go to Git download page)
- Click here to download JDK! (For MacOs:
ARM64 DMG Installer
) - Once done, open (run/execute) the JDK installer! (It's probably on your user's
Downloads
folder) - Follow through the installation process!
- Open up your desired terminal application! Default are: - 'Terminal' for MacOs & Linux! - 'Command Prompt' for Windows!
- Type
java --version
to verify it! - If it's installed, it should be like this:
- On your machine, clone this repository into your preferred folder!
- Navigate to the cloned repository, and open a terminal at the folder
Volistic
! - Type
pwd
to your terminal and pressreturn↵
! If it show.../Volistic
then your current working directory is correct! - Copy paste this command:
javac CLI/*.java; java CLI.Volistic
to your terminal and pressreturn↵
! - 🎉・It should now run the Volistic Program, have fun!・🎊
You're highly suggested to use Pull Request to get your changes to the repository instead of direct edit. Please refer to CODE_OF_CONDUCT.md
for follow-up on this guide here. If you need any help regarding this matter, kindly consult to: deffreus (Discord)
Refer to this documentation here.
- Donwload & Install VSCode! See the guide here!
- Open VSCode, then click the 'Extension' icon on the side bar!
- Download the following extensions:
-
GitHub Actions by GitHub
-
GitHub Pull Requests and Issues by GitHub
-
GitLens — Git supercharged (Optional; Highly recommended) by GitHub
-
Markdown Preview Github Styling by Matt Bierner (Optional)
-
Code Runner by Jun Han
-
Code Time by Software (Optional)
-
Java Language Support by George Fraser
-
Java Run by caolin
-
Debugger for Java by Microsoft
-
Extension Pack for Java by Microsoft
-
Language Support for Java(TM) by Red Hat
- On the side bar, press the 'Accounts' icon, then press the sign in button!
- You'll then be redirected to GitHub. Login to your account or create an account if you don't have one!
- Follow through the instructions given!
To work and make changes to the source code, it's recommended to edit in your own local repository than directly on the remote repository through GitHub website. Thus, you need to clone the remote repository, making a copy of it locally on your machine.
- Press
Cmd⌘ + Shift⇧ + P
and type 'Git: Clone'! - Choose 'Clone from GitHub'!
- Type 'PD-06/Volistic' and press
return↵
! - Select your preferred folder for the repository! (It's not recommended to put it on the 'Downloads' folder)
- Open the cloned repository! You can now make changes to the code!
- VSCode will ask if you trust the authors of the files. Check the 'Trust the authors of all files in the parent folder...' and click the 'Yes, I trust the authors' button!
- Done! You can now edit the files on your local repository!
Tips: if the Java Language Support server crashed, press Cmd⌘ + Shift⇧ + P
and type 'Java: Restart Java Language Server'!
For pushing commits, git needs your GitHub account's username and email.
- Open VSCode Terminal --> On the menu bar (top-most bar): Terminal > New Terminal
- On the terminal, type
git config --global user.name "USERNAME"
, replacing USERNAME with your GitHub username! - Type
git config --global user.email "EMAIL"
, replacing EMAIL with your email, e.gexample@gmail.com
!
Whenever there's a change in the remote repository, you need to 'pull' that change to your local repository in order to stay up-to-date with remote changes. The 'Source Control' panel wil tell you if there's a change in the remote repository that you need to pull to your local repository.
- Press
Cmd⌘ + Shift⇧ + P
and type 'Git: Pull', then pressreturn↵
!
When you're making code changes in VSCode, you're editing your local repository. To get your changes to the remote repository, you must 'commit' your changes and 'push' the commit. Ideally, each commit is small and only discuss one topic of change; don't bundle multiple changes of different topics into one commit!
- Go to the 'Source Control' panel from the sidebar!
- After you saved all your changes, under the 'Changes' dropdown, press
+
beside the Modified file that you want to commit! - After your changes are staged, under the 'SOURCE CONTROL' dropdown, enter a commit message describing what changes you made!
- Press
Cmd⌘ + return↵
to send the commit! - Finally, 'push' your commit(s) by pressing
Cmd⌘ + Shift⇧ + P
and typing 'Git: Push'
We mainly use Discord for this project. Go to the '#support-and-help' under the '🎁・Volistic' category. You can join our server here.