├── README.md ├── faq.md ├── keyboard-shortcuts-mac.md ├── keyboard-shortcuts-windows.md └── LICENSE /README.md: -------------------------------------------------------------------------------- 1 |
2 | 3 | # [](https://fork.dev)
Fork Docs 4 | 5 | **User contributed documentation for Fork.dev** 6 | 7 |
8 | 9 | This is user-contributed documentation for Fork. Right now there's not much content, but we'll see how this works out in the future. 10 | 11 | ## Table of Contents 12 | 13 | 1. Keyboard Shortcuts 14 | 1. [Keyboard Shortcuts (Mac)](keyboard-shortcuts-mac.md) 15 | 2. [Keyboard Shortcuts (Windows)](keyboard-shortcuts-windows.md) 16 | 2. [Frequently Asked Questions (FAQ)](faq.md) 17 | 18 | ## Contributing 19 | Feel free to make a pull request for fixes and improvements. For questions or problems, open an issue. 20 | -------------------------------------------------------------------------------- /faq.md: -------------------------------------------------------------------------------- 1 | # Frequently Asked Questions (FAQ) 2 | 3 | #### How to compare two branches (or commits)? 4 | Just select them (hold Ctrl/Cmd for multiselection) 5 | 6 | #### I accidentally lost some commits 7 | Use reflog to see lost commits 8 | 9 | #### Do you plan to support Linux 10 | No, we don’t plan to support Linux until a decent UI library (comparable to WPF or Cocoa) appears on this platform. 11 | 12 | #### How can I commit and push? 13 | Hold Ctrl/Alt when commit 14 | 15 | #### Git doesn’t recognize my file as a text and Fork doesn’t show the diff 16 | This may happen when a file is relatively small or in UTF-16 LE encoding. You can fix this by creating a rule (e.g. `*.sql text`) in `.gitattributes` file. (https://www.git-scm.com/docs/gitattributes) 17 | 18 | #### How can I push multiple branches at once 19 | Select them on the sidebar and call 'Push' from the context menu 20 | 21 | #### Permission denied when accessing repos in my organization on GitHub 22 | Ensure that Fork has access to your organization: https://github.com/settings/connections/applications/debde513eaa447b74d51 23 | 24 | #### Receiving a "request requires higher privileges" error when trying to connect to GitLab with personal access token 25 | Ensure the token provides access to the following scopes: `read_api`, and `user_api` 26 | 27 | #### The main window is blank (Windows) 28 | Most likely you are using VMWare which has a problem with hardware acceleration. You can disable it in Fork config: https://github.com/ForkIssues/TrackerWin/issues/491#issuecomment-546605221 29 | 30 | #### I can't initialize Git-Flow (Mac) 31 | Probably you removed SourceTree recently and it broke your environment. https://github.com/fork-dev/Tracker/issues/418#issuecomment-425818588 32 | 33 | #### I have a large repo and Fork shows only 50000 commits 34 | You can configure the limit. 35 | On Mac run `$ defaults write com.danpristupov.fork maxCommitCount 150000` in Terminal. 36 | On Windows edit the `MaxCommitCount` field in the `%localappdata%\fork\settings.json` file. 37 | -------------------------------------------------------------------------------- /keyboard-shortcuts-mac.md: -------------------------------------------------------------------------------- 1 | # Keyboard Shortcuts (Mac) 2 | 3 | ##### General Navigation 4 | 5 | * ⌘1 - Show Changes view (second press will focus commit field) 6 | * ⌘2 - Show All Commits view (second press will jump to HEAD) 7 | * ⌘0 - Reveal HEAD 8 | * ⌘P - Show Quick Launch window 9 | * ⌃Tab - Select next tab 10 | * ⌃⇧Tab - Select previous tab 11 | * ⌘T - Open new tab 12 | * ⌘W - Close current tab 13 | * ⌘, - Open Fork preferences 14 | 15 | ##### All Commits View 16 | * ⌘0 - Jump to HEAD 17 | * ⌘F - Commit search 18 | * * Return - Jump to next search result 19 | * * ⇧Return - Jump to previous search result 20 | * ⌘C - Copy commit info 21 | * ⌫ - Remove branch/stash 22 | * ⌘⇧A - Filter by active branch 23 | 24 | ##### Changes View 25 | 26 | * ⌘Return - Commit 27 | * ⌘⇧Return - Commit and push 28 | * ⌘1 - Focus commit message field 29 | * Return, ⌘S - Stage/unstage selected file (or lines) 30 | * ⌘⌥⇧S - Stage/unstage all files 31 | * ⌫, ⌘⇧D - Discard selected file (or lines) 32 | * ⌘⌥⇧O - Open selected file 33 | * ⌘D - Open selected file in external diff tool 34 | * ⌘C - Copy selected file full path 35 | 36 | ##### Repository 37 | * ⌘R - Refresh 38 | * CtrlShiftN - Init new repository 39 | * ⌘⇧N - Clone new repository 40 | * ⌘O - Open repository 41 | * ⌘B - Checkout Branch 42 | * ⌘⇧F - Fetch 43 | * ⌘⌥⇧F (⌥ + click on button) - Quick Fetch 44 | * ⌘⇧L - Pull 45 | * ⌘⌥⇧L (⌥ + click on button) - Quick Pull 46 | * ⌘⇧P - Push 47 | * ⌘⌥⇧P (⌥ + click on button) - Quick Push 48 | * ⌘⇧B - New branch 49 | * ⌘⇧T - New tag 50 | * ⌘⇧H - Create stash 51 | * ⌘⌥⇧H - Quick Stash 52 | * ⌘⌃O - Open in File Explorer 53 | * ⌘⌃T - Open in Terminal -------------------------------------------------------------------------------- /keyboard-shortcuts-windows.md: -------------------------------------------------------------------------------- 1 | # Keyboard Shortcuts (Windows) 2 | 3 | ##### General Navigation 4 | 5 | * Ctrl1 - Show Changes view (second press will focus commit field) 6 | * Ctrl2 - Show All Commits view (second press will jump to HEAD) 7 | * Ctrl0 - Reveal HEAD 8 | * CtrlP - Show Quick Launch window 9 | * CtrlTab - Select next tab 10 | * CtrlShiftTab - Select previous tab 11 | * CtrlT - Open new tab 12 | * CtrlW - Close current tab 13 | * Ctrl=/Ctrl- Zoom in/ Zoom out 14 | * Ctrl, - Open Fork preferences 15 | 16 | ##### All Commits View 17 | * Ctrl0 - Jump to HEAD 18 | * CtrlF - Commit search 19 | * * Enter, F3 - Jump to next search result 20 | * * ShiftEnter, ShiftF3 - Jump to previous search result 21 | * CtrlC - Copy commit info 22 | * Delete - Remove branch/stash 23 | * CtrlShiftA - Filter by active branch 24 | 25 | ##### Changes View 26 | 27 | * CtrlEnter - Commit 28 | * CtrlShiftEnter - Commit and push 29 | * Ctrl1 - Focus commit message field 30 | * CtrlF - Filter 31 | * Enter, CtrlShiftS - Stage/unstage selected file (or lines) 32 | * CtrlAltShiftS - Stage/unstage all files 33 | * Backspace, CtrlShiftD - Discard selected file (or lines) 34 | * CtrlO - Open selected file 35 | * CtrlD - Open selected file in external diff tool 36 | * CtrlC - Copy selected file full path 37 | 38 | ##### Repository 39 | * F5 - Refresh 40 | * CtrlShiftN - Init new repository 41 | * CtrlN - Clone new repository 42 | * CtrlO - Open repository 43 | * CtrlShiftF - Fetch 44 | * CtrlAltShiftF (Ctrl + click on button) - Quick Fetch 45 | * CtrlShiftL - Pull 46 | * CtrlAltShiftL (Ctrl + click on button) - Quick Pull 47 | * CtrlShiftP - Push 48 | * CtrlAltShiftP (Ctrl + click on button) - Quick Push 49 | * CtrlShiftB - New branch 50 | * CtrlShiftT - New tag 51 | * CtrlShiftH - Create stash 52 | * CtrlAltO - Open in File Explorer 53 | * CtrlAltT - Open in Terminal 54 | 55 | ##### Repository Manager 56 | * F2 - Rename Repository 57 | * Delete - Remove Repository 58 | * Enter - Open Repository -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Creative Commons Legal Code 2 | 3 | CC0 1.0 Universal 4 | 5 | CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE 6 | LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN 7 | ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS 8 | INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES 9 | REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS 10 | PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM 11 | THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED 12 | HEREUNDER. 13 | 14 | Statement of Purpose 15 | 16 | The laws of most jurisdictions throughout the world automatically confer 17 | exclusive Copyright and Related Rights (defined below) upon the creator 18 | and subsequent owner(s) (each and all, an "owner") of an original work of 19 | authorship and/or a database (each, a "Work"). 20 | 21 | Certain owners wish to permanently relinquish those rights to a Work for 22 | the purpose of contributing to a commons of creative, cultural and 23 | scientific works ("Commons") that the public can reliably and without fear 24 | of later claims of infringement build upon, modify, incorporate in other 25 | works, reuse and redistribute as freely as possible in any form whatsoever 26 | and for any purposes, including without limitation commercial purposes. 27 | These owners may contribute to the Commons to promote the ideal of a free 28 | culture and the further production of creative, cultural and scientific 29 | works, or to gain reputation or greater distribution for their Work in 30 | part through the use and efforts of others. 31 | 32 | For these and/or other purposes and motivations, and without any 33 | expectation of additional consideration or compensation, the person 34 | associating CC0 with a Work (the "Affirmer"), to the extent that he or she 35 | is an owner of Copyright and Related Rights in the Work, voluntarily 36 | elects to apply CC0 to the Work and publicly distribute the Work under its 37 | terms, with knowledge of his or her Copyright and Related Rights in the 38 | Work and the meaning and intended legal effect of CC0 on those rights. 39 | 40 | 1. Copyright and Related Rights. A Work made available under CC0 may be 41 | protected by copyright and related or neighboring rights ("Copyright and 42 | Related Rights"). Copyright and Related Rights include, but are not 43 | limited to, the following: 44 | 45 | i. the right to reproduce, adapt, distribute, perform, display, 46 | communicate, and translate a Work; 47 | ii. moral rights retained by the original author(s) and/or performer(s); 48 | iii. publicity and privacy rights pertaining to a person's image or 49 | likeness depicted in a Work; 50 | iv. rights protecting against unfair competition in regards to a Work, 51 | subject to the limitations in paragraph 4(a), below; 52 | v. rights protecting the extraction, dissemination, use and reuse of data 53 | in a Work; 54 | vi. database rights (such as those arising under Directive 96/9/EC of the 55 | European Parliament and of the Council of 11 March 1996 on the legal 56 | protection of databases, and under any national implementation 57 | thereof, including any amended or successor version of such 58 | directive); and 59 | vii. other similar, equivalent or corresponding rights throughout the 60 | world based on applicable law or treaty, and any national 61 | implementations thereof. 62 | 63 | 2. Waiver. To the greatest extent permitted by, but not in contravention 64 | of, applicable law, Affirmer hereby overtly, fully, permanently, 65 | irrevocably and unconditionally waives, abandons, and surrenders all of 66 | Affirmer's Copyright and Related Rights and associated claims and causes 67 | of action, whether now known or unknown (including existing as well as 68 | future claims and causes of action), in the Work (i) in all territories 69 | worldwide, (ii) for the maximum duration provided by applicable law or 70 | treaty (including future time extensions), (iii) in any current or future 71 | medium and for any number of copies, and (iv) for any purpose whatsoever, 72 | including without limitation commercial, advertising or promotional 73 | purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each 74 | member of the public at large and to the detriment of Affirmer's heirs and 75 | successors, fully intending that such Waiver shall not be subject to 76 | revocation, rescission, cancellation, termination, or any other legal or 77 | equitable action to disrupt the quiet enjoyment of the Work by the public 78 | as contemplated by Affirmer's express Statement of Purpose. 79 | 80 | 3. Public License Fallback. Should any part of the Waiver for any reason 81 | be judged legally invalid or ineffective under applicable law, then the 82 | Waiver shall be preserved to the maximum extent permitted taking into 83 | account Affirmer's express Statement of Purpose. In addition, to the 84 | extent the Waiver is so judged Affirmer hereby grants to each affected 85 | person a royalty-free, non transferable, non sublicensable, non exclusive, 86 | irrevocable and unconditional license to exercise Affirmer's Copyright and 87 | Related Rights in the Work (i) in all territories worldwide, (ii) for the 88 | maximum duration provided by applicable law or treaty (including future 89 | time extensions), (iii) in any current or future medium and for any number 90 | of copies, and (iv) for any purpose whatsoever, including without 91 | limitation commercial, advertising or promotional purposes (the 92 | "License"). The License shall be deemed effective as of the date CC0 was 93 | applied by Affirmer to the Work. Should any part of the License for any 94 | reason be judged legally invalid or ineffective under applicable law, such 95 | partial invalidity or ineffectiveness shall not invalidate the remainder 96 | of the License, and in such case Affirmer hereby affirms that he or she 97 | will not (i) exercise any of his or her remaining Copyright and Related 98 | Rights in the Work or (ii) assert any associated claims and causes of 99 | action with respect to the Work, in either case contrary to Affirmer's 100 | express Statement of Purpose. 101 | 102 | 4. Limitations and Disclaimers. 103 | 104 | a. No trademark or patent rights held by Affirmer are waived, abandoned, 105 | surrendered, licensed or otherwise affected by this document. 106 | b. Affirmer offers the Work as-is and makes no representations or 107 | warranties of any kind concerning the Work, express, implied, 108 | statutory or otherwise, including without limitation warranties of 109 | title, merchantability, fitness for a particular purpose, non 110 | infringement, or the absence of latent or other defects, accuracy, or 111 | the present or absence of errors, whether or not discoverable, all to 112 | the greatest extent permissible under applicable law. 113 | c. Affirmer disclaims responsibility for clearing rights of other persons 114 | that may apply to the Work or any use thereof, including without 115 | limitation any person's Copyright and Related Rights in the Work. 116 | Further, Affirmer disclaims responsibility for obtaining any necessary 117 | consents, permissions or other rights required for any use of the 118 | Work. 119 | d. Affirmer understands and acknowledges that Creative Commons is not a 120 | party to this document and has no duty or obligation with respect to 121 | this CC0 or use of the Work. 122 | --------------------------------------------------------------------------------