GithubHelp home page GithubHelp logo

githubiny / octotree Goto Github PK

View Code? Open in Web Editor NEW

This project forked from ovity/octotree

0.0 1.0 0.0 47.41 MB

Browser extension to display GitHub code in tree format

License: MIT License

JavaScript 75.29% CSS 23.93% HTML 0.78%

octotree's Introduction

Octotree

Browser extensions (Chrome, Firefox, Safari and Opera) to display GitHub code in tree format. Useful for developers who frequently read source in GitHub and do not want to download or checkout too many repositories. Features:

  • Easy-to-navigate code tree like IDEs
  • Fast browsing with pjax
  • Customizable hotkey
  • Support private repositories (see instructions)
  • Support GitHub Enterprise (Chrome and Opera only, see instructions)

Install on Chrome and Firefox

  • Download and install Octotree from Chrome Web Store or Mozilla Add-ons Store
  • Navigate to any GitHub repository (or just refresh this page as an example)
  • The code tree should show on the left-hand side of the screen

Install on Safari and Opera

You can install the prebuilt extensions located in the dist folder. For security reason, only download Octotree from this location.

  • Safari: drag safari.safariextz to the browser and follow the instructions
  • Opera: drag opera.nex to the browser and follow the instructions

GitHub access token

Octotree uses GitHub API to retrieve repository metadata. By default, it makes unauthenticated requests to the GitHub API. However, there are two situations when requests must be authenticated:

When that happens, Octotree will ask for your GitHub personal access token. If you don't already have one, create one, then copy and paste it into the textbox. Note that the minimal scopes that should be granted are public_repo and repo (if you need access to private repositories).

Alternatively, you can manually enter or update the token by following these steps:

  • Navigate to any GitHub repository
  • Open the Chrome (or Safari, Firefox) developer console
  • Execute the following line:
localStorage.setItem('octotree.github_access_token', 'REPLACE WITH TOKEN')

Note: if you use GitHub Enterprise, each site will need its own access token. Therefore, Octotree stores access token on a per-site basis.

GitHub Enterprise

By default, Octotree only works on github.com. To support GitHub Enterprise on Chrome or Opera, you must grant Octotoree sufficient permissions. Follow these steps to do so:

  • Navigate to any GitHub repository on github.com
  • Open Octotree's setting panel
  • Fill in the GitHub Enterprise URLs textbox, one site URL per line
  • Click Save and accept any permission prompt
  • Navigate to your GitHub Enterprise site (or refresh if you're already in one)
  • You might be asked to create an access token

Changelog

v1.6.3

  • Fix bug when switching to branches with slashes in their names

v1.6.2

  • Fix branch selection no longer works due to GitHub change

v1.6.1

  • Update buttons' style to match GitHub new button style
  • Update all dependencies to latest version
  • Allow navigating to commit trees ovity#157
  • Support keyboard navigation ovity#158
  • Fix bug handling back tick in paths ovity#160
  • Option to show in non-code pages
  • Option to load tree only when sidebar is visible
  • Option to configure tab size
  • Bug fixes
  • New header to match new GitHub design
  • Bug fixes
  • Support GitHub enterprise
  • Change default hotkey (cmd+b for Safari and cmd+shift+s for all other browsers)
  • Some other minor changes
  • Setting panel allowing:
  • Changing access token
  • Changing hotkeys
  • Changing sidebar default visibility
  • Changing folder collapsing option
  • Sidebar appears better in large monitors
  • More responsive in big repositories
  • And bug fixes
  • Hide sidebar by default (upon many user requests)
  • Hotkey (cmd+b, ctrl+b) to toggle sidebar
  • Sidebar is now resizable
  • Support rendering submodules
  • Reflect GitHub selection to Octotree
  • New sidebar header and progress indicator
  • And bug fixes
  • New UI that blends better with GitHub!
  • Hide Octotree on non-code pages
  • When asking for token, show more detailed message and not fly out automatically
  • Extend pjax timeout to work better with big files
  • Sanitize file and folder names before displaying
  • Fix error when a branch name contains slashes
  • Gulp script to build for Chrome, Firefox and Safari
  • And some other minor changes

Credit

  • Many thanks to all contributors who submit pull requests, report bugs and suggest ideas
  • Extension icon by pstadler

octotree's People

Contributors

buunguyen avatar ephemera avatar letunglam avatar bayandin avatar jerizm avatar spittie avatar k2nr avatar athaeryn avatar mijoharas avatar eush77 avatar alexbeletsky avatar voithos avatar tatsuya avatar sidke avatar norio-nomura avatar mottie avatar monwf avatar enyo avatar luegg avatar leereilly avatar jsutlovic avatar vakata avatar isbadawi avatar behnam avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.