中文说明
这啥玩意
基于octoree二次开发的浏览器插件，在git@osc的项目页面提供一个树形目录结构，方便用户浏览。
如何安装
例如安装到谷歌浏览器，直接在浏览器的扩展，开启开发者模式，然后将 tmp/chrome 目录导入即可。
如何二次开发
安装nodejs，安装gulp，然后在项目目录执行 gulp 这个命令（会有各种库要安装），然后就进入了开发模式。修改的代码，实时在浏览器中生效（当然，你还是要刷新浏览器的），非常方便。
预览
Эффект图
Octotree
Browser extensions (Chrome, Firefox, Opera and Safari) 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, Firefox and Opera
- Install Octotree from Chrome Web Store, Mozilla Add-ons Store or Opera 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
The prebuilt packages for all extensions are located in the dist folder. For security reason, only download Octotree from this location.
- Safari: drag safari.safariextz to the browser and follow on-screen 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:
- You access a private repository;
- You exceed the rate limit of unauthenticated requests.
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 developer console of your browser.
- 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 and Opera, you must grant Octotree sufficient permissions. Follow these steps to do so:
- Navigate to any GitHub repository on github.com.
- Open Octotree's settings panel.
- Fill in the GitHub Enterprise URLs textbox, one URL per line.
- Click Save and accept any permission prompt.
- Navigate to your GitHub Enterprise site.
- You might be asked to create an access token.
Changelog
v1.7.1
- Fix space between tree and GitHub contents due to GitHub DOM change.
v1.7.0
- Support direct downloading when hovering a file.
v1.6.4
- Fix bug detecting branch/tag due to GitHub DOM change.
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.
v1.6
Версия 1.5.2
Версия 1.5
- Опция отображения на страницах без кода.
- Опция загрузки дерева только при видимой боковой панели.
- Возможность настройки размера вкладки.
- Исправление ошибок.
Версия 1.4.1
- Новый заголовок в соответствии с новым дизайном GitHub.
- Исправление ошибок.
Версия 1.4
- Поддержка GitHub enterprise.
- Изменение стандартной горячей клавиши (cmd+b для Safari и cmd+shift+s для всех других браузеров).
- Некоторые другие незначительные изменения.
Версия 1.3
- Панель настроек, позволяющая:
- Изменить токен доступа.
- Изменить горячие клавиши.
- Изменить видимость боковой панели по умолчанию.
- Изменить опцию сворачивания папок.
- Боковая панель лучше отображается на больших мониторах.
- Более быстрая реакция в больших репозиториях.
- И исправление ошибок.
Версия 1.2
- По умолчанию боковая панель скрыта (по многочисленным просьбам пользователей).
- Горячая клавиша (cmd+b, ctrl+b) для переключения боковой панели.
- Теперь боковую панель можно изменять.
- Поддержка рендеринга подмодулей.
- Отражение выбора GitHub в Octotree.
- Новый заголовок боковой панели и индикатор выполнения.
- И исправление ошибок.
Версия 1.1
- Новый пользовательский интерфейс, который лучше сочетается с GitHub!
- Скрыть Octotree на страницах без кода.
- При запросе токена показывать более подробное сообщение и не вылетать автоматически.
- Увеличить время ожидания pjax для лучшей работы с большими файлами.
- Очистить имена файлов и папок перед отображением.
- Устранить ошибку, когда имя ветки содержит косые черты.
- Скрипт Gulp для сборки для Chrome, Firefox и Safari.
- И некоторые другие незначительные изменения.
Комментарии ( 0 )