https://github.com/qfish/XAlign

An amazing Xcode Source Editor extension to align regular code. It can align anything in any way you want.
https://github.com/qfish/XAlign

xalign xcode-extension xcode-plugin xcode8

Last synced: 2 months ago
JSON representation

An amazing Xcode Source Editor extension to align regular code. It can align anything in any way you want.

• Host: GitHub
• URL: https://github.com/qfish/XAlign
• Owner: qfish
• License: mit
• Created: 2013-12-01T13:19:46.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2021-12-08T13:08:39.000Z (about 3 years ago)
• Last Synced: 2024-11-05T06:10:13.655Z (3 months ago)
• Topics: xalign, xcode-extension, xcode-plugin, xcode8
• Language: Objective-C
• Homepage:
• Size: 3.93 MB
• Stars: 2,876
• Watchers: 93
• Forks: 386
• Open Issues: 57
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-ios-cn - 官网
• awesome-xcode-extensions - XAlign - An amazing Xcode Source Editor extension to align regular code. (The list / Formatters)
• awesome - XAlign - An amazing Xcode Source Editor extension to align regular code. It can align Xnything in any way you want. 【 [Priview](https://camo.githubusercontent.com/f61bfc31e144ad6a9d7ca26fa19547a3af5da8c6/687474703a2f2f7166692e73682f58416c69676e2f696d616765732f646566696e652e676966) 】 (MacOS / Projects-Demo)

README

        
XAlign (Ready for Xcode 8+ 🚀)

======

An amazing Xcode Source Editor extension to align regular code. It can align anything by using custom alignment patterns.

## What's XAlign

Here are some example alignment patterns. Of course you can make your own. The pattern file is here:  `/Source/Patterns.bundle/default.plist`, and the patterns are based on regular expression.

**Tips**: 

   * _You may not like the alignment style below, **try it yourself** or **tell me at the [Issues](https://github.com/qfish/XAlign/issues?state=open)**._ :)

   * There is no need to align all codes at a time when they are complicated, try to align by group which the codes are more similar in.

   * 对齐不需要一次全部对齐，可以分组多对几次，那些等号差的太远的就别让它参与对齐了。

   * 默认对齐的风格不是你喜欢的，可以自定义，或者提个 [Issues](https://github.com/qfish/XAlign/issues?state=open)。

### Align by equals sign

![Equal](http://qfi.sh/XAlign/images/equal.gif)

### Align by define group

![Define](http://qfi.sh/XAlign/images/define.gif)

### Align by property group

![Property](http://qfi.sh/XAlign/images/property.gif)

### Todo:

- [x] Much easier to customize alignment patterns.

## Install on Xcode 8

1. Download the [XAlign.dmg📎](https://github.com/qfish/XAlign/releases/download/v1.0/XAlign.1.0.dmg) or [XAlign.app.zip📎](https://github.com/qfish/XAlign/releases/download/v1.0/XAlign.app.zip)

2. Open and copy `XAlign.app` to `/Applications` folder

3. Run it then close it.

## Usage

### 1. Enable XAlign

Check System Preferences -> Extensions -> Xocde Source Editor -> XAlign

   ![help-1](https://cloud.githubusercontent.com/assets/679824/20145614/b86f6742-a6db-11e6-846b-771447ec0933.png)

### 2. Setting Shortcut in Xocde 

Preferences -> Key bindings -> Filter: xalign

   ![help-2](https://cloud.githubusercontent.com/assets/679824/20146079/735244ca-a6dd-11e6-83a9-069fd489b0f6.png)

## Trouble Shooting

* Please install macOS Sierra (version 10.12) if your macOS is 10.11.

* If you are looking for the version supporting Xcode 7, check this [branch](https://github.com/qfish/XAlign/tree/Xcode%3C8);

## Want to help

  

  * [Star this repository](https://github.com/qfish/XAlign/)

  * [Bug report & Advice](https://github.com/qfish/XAlign/issues)

  * [Fork & Pull Request](https://github.com/qfish/XAlign/pulls)

## Special thanks to

*   Geek Zoo Studio

  They provide awesome design and development works continues to help the open-source community even better.

* [BeeFramework](https://github.com/gavinkwoe/BeeFramework) 

  BeeFramework is a new generation of development framework which makes faster and easier app development, Build your app by geek's way.