mirror of
https://github.com/zhigang1992/macdown.git
synced 2026-01-12 22:48:37 +08:00
75 lines
4.0 KiB
Markdown
75 lines
4.0 KiB
Markdown
# MacDown
|
||
|
||
[](https://travis-ci.org/uranusjr/macdown)
|
||
|
||
MacDown is an open source Markdown editor for OS X, released under the MIT License. The author stole the idea from [Chen Luo](https://twitter.com/chenluois)’s [Mou](http://mouapp.com) so that people can [make crappy clones](https://twitter.com/remaerd/status/484914820408279040).
|
||
|
||
Visit the [project site](http://macdown.uranusjr.com/) for more information, or download [MacDown.app.zip](http://macdown.uranusjr.com/download/latest/) directly from the [latest releases](https://github.com/uranusjr/macdown/releases/latest) page.
|
||
|
||
## License
|
||
|
||
MacDown is released under the terms of MIT License. You may find the content of the license [here](http://opensource.org/licenses/MIT), or inside the `LICENSE` directory.
|
||
|
||
You may find full text of licenses about third-party components in the `LICENSE` directory, or the **About MacDown** panel in the application.
|
||
|
||
The following editor themes and CSS files are extracted from [Mou](http://mouapp.com), courtesy of Chen Luo:
|
||
|
||
* Mou Fresh Air
|
||
* Mou Fresh Air+
|
||
* Mou Night
|
||
* Mou Night+
|
||
* Mou Paper
|
||
* Mou Paper+
|
||
* Tomorrow
|
||
* Tomorrow Blue
|
||
* Tomorrow+
|
||
* Writer
|
||
* Writer+
|
||
* Clearness
|
||
* Clearness Dark
|
||
* GitHub
|
||
* GitHub2
|
||
|
||
## Development
|
||
|
||
### Requirements
|
||
|
||
If you wish to build MacDown yourself, you will need the following components/tools:
|
||
|
||
* OS X SDK (10.8 or later)
|
||
* Git
|
||
* [CocoaPods](http://cocoapods.org)
|
||
|
||
You may also need to install Xcode’s command line tools with the following command:
|
||
|
||
xcode-select --install
|
||
|
||
> Note: Due to an [upstream bug](https://github.com/CocoaPods/CocoaPods/issues/2559), Xcode will fail to build certain dependencies if you use the latest version of CocoaPods (0.35 at the time of writing). To avoid the problem and build the project correctly, you need to install an older version of CocoaPods (0.34.4 is recommended), and use that to build the dependencies instead. See [comment in issue #220](https://github.com/uranusjr/macdown/issues/220#issuecomment-65014799) for detailed instructions.
|
||
|
||
An appropriate SDK should be bundled with Xcode 5 or later versions.
|
||
|
||
### Environment Setup
|
||
|
||
After cloning the repository, run the following commands inside the repository root (directory containing this `README.md` file):
|
||
|
||
git submodule init
|
||
git submodule update
|
||
pod install
|
||
|
||
and open `MacDown.xcworkspace` in Xcode. The first command initialises the dependency submodule(s) used in MacDown; the second one installs dependencies managed by CocoaPods.
|
||
|
||
Refer to the official guides of Git and CocoaPods if you need more instructions. If you run into build issues later on, try running the following commands to update dependencies:
|
||
|
||
git submodule update
|
||
pod install
|
||
|
||
## Discussion
|
||
|
||
[](https://gitter.im/uranusjr/macdown?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
|
||
|
||
Join our [Gitter channel](https://gitter.im/uranusjr/macdown?utm_source=share-link&utm_medium=link&utm_campaign=share-link) if you have any problems with MacDown. Any suggestions are welcomed, too!
|
||
|
||
You can also [file an issue directly](https://github.com/uranusjr/macdown/issues/new) on GitHub if you prefer so. But please, **search first to make sure no-one has reported the same issue already** before opening one yourself. MacDown does not update in your computer immediately when we make changes, so something you experienced might be known, or even fixed in the development version.
|
||
|
||
MacDown depends a lot on other open source projects, such as [Hoedown](https://github.com/hoedown/hoedown) for Markdown-to-HTML rendering, [Prism](http://prismjs.com) for syntax highlighting (in code blocks), and [PEG Markdown Highlight](https://github.com/ali-rantakari/peg-markdown-highlight) for editor highlighting. If you find problems when using those particular features, you can also consider reporting them directly to upstream projects as well as to MacDown’s issue tracker. I will do what I can if you report it here, but sometimes it can be more beneficial to interact with them directly.
|