Skip to content

Prerequisite

Jump to bottom
Charles Chiu edited this page Jan 8, 2023 · 5 revisions
  1. GitHub account.
  2. Git, for computer users.
  3. Working Copy, for iOS/iPadOS users, partpartially free.
  4. a-Shell, for iOS/iPadOS users, free.
    • ⚠️ Disclaimer: You need to work in terminal, you might broke your device if you don't know what's your doing, take your own risk.
  5. Termux, for Android users.
    • ⚠️ Disclaimer: You need to work in terminal, you might broke your device if you don't know what's your doing, take your own risk.
What is Git? Git is a free and open source distributed version control system created by Linus Torvalds in 2005.
What is GitHub? GitHub is a for-profit company that offers a cloud-based Git repository hosting service. Essentially, it makes it a lot easier for individuals and teams to use Git for version control and collaboration.
How does Git works?

⚠️ Limitations of GitHub

  1. Recommend repositories remain small, ideally less than 1 GB, and less than 5 GB is strongly recommended.
  2. GitHub blocks pushes that exceed 100 MB, and you will receive a warning form Git when you attempt to add or update a file larger than 50 MB.
  3. Use Git Large File Storage (Git LFS), if you really need to track those big files with Git.

⚠️ Things you should avoid

  1. Open multiple instances of Logseq at a time, e.g. open Logseq on your computer and on your phone at the same time. This will cause conflict in your repo.
  2. Put large files in assets folder, like images, videos, etc.

Common terminal command you should know

  • cd: stands for change directories, ie, cd downloads/ to go into your downloads folder in terminal.
  • ls -a: stands for list all. This command will show everything in your current directory.
  • rm -r: stands for remove recursively. This command will remove folders and files, ie, rm -r downloads.
  • pwd: stands for print working directory, ie, pwd -> /home/USER/downloads.
  • mv: stands for move, ie, mv test1.md downloads/ will move test1.md to downloads folder.
  • cat: stand for concatenate. This command will print the content of a file in terminal, ie, cat test1.md.
Clone this wiki locally