Permalink
Browse files

init

  • Loading branch information...
0 parents commit ea004e6128a4dacbe8df796b515147c86418df6f @orta orta committed Nov 1, 2013
@@ -0,0 +1,72 @@
+##How to use this repository
+
+This repository is for user guides on how to use CocoaPods. It replaces the multiple Wikis, guides section of the old docs.cocoapods.org site, and some of the more verbose documentation sections of the API docs.
+
+###Where is the content?
+
+You can find all of the guides source in `/source`. Each section is then broken down into its own content folder. So the guides for using CocoaPods can be found in `/source/using`. Also, if you view a page on guides, there is a link at the bottom of the footer to the source page in this repo.
+
+###How do I make a change?
+
+Just like any other repository, you should create a fork, make a change, commit, and then submit a pull request to `master`.
+
+###How do I add a new guide?
+
+All the guides content is written in [Markdown](http://daringfireball.net/projects/markdown/). Each page has some special information at the top, defined by `---`. This is used to generate the index pages, as well as the sitemap in the footer. Each page must include this information at the very top of this page.
+
+Here is a sample file:
+
+```
+---
+title: Getting Started
+description: This is a guide that describes setting up CocoaPods and integrating with your first project.
+---
+
+## What are CocoaPods
+
+CocoaPods manages library dependencies for your Xcode projects.
+```
+
+##Overall Guidelines
+
+- **This repo is for content for guides.cocoapods.org only.** If you are having an issue with CocoaPods, please ask on [StackOverflow](http://stackoverflow.com/search?q=CocoaPods) or our [mailing-list](http://groups.google.com/group/cocoapods).
+- **This is high-level content only.** If you have an issue with the API documentation for one of the gems that make up CocoaPods, please file that issue in its own repo; API documentation is generated from source files.
+- **This is not the repository for per-Pod documentation.** See [CocoaDocs](http://cocoadocs.org) for documentation on individual Pods.
+- **Please do not add images hosted on 3rd party sites.** Image explanations are great, but we would like to keep this a self-contained site.
+- **Take out any personally identifiable information.** This applies to images, code snippets, or any other content. Please keep all information anonymous.
+- **Do not add promotional material.** This applies to both Guides content and linked resources.
+
+##Style Guidelines
+
+While we aren't terribly picky about writing style, there are a few things we'd like to make sure are standard across the content of the Guides site.
+
+- All content must be in well written English. Use proper spelling and punctuation.
+- All guides content is separated into 3 sections: Using, Making, and Contributing. For any new guides, please choose the appropriate section.
+- All content is written in [Markdown](http://daringfireball.net/projects/markdown/).
+- These are not tutorials, but rather explanations of the inner workings of CocoaPods.
+- If you would like to see these in another language, please [open an issue](https://github.com/CocoaPods/guides.cocoapods.org/issues), or simply start translating. We'd love to see this content accessible to more users.
+- Our code blocks are parsed by [Pygments](https://github.com/tmm1/pygments.rb), so please make sure your code additions are highlighted correctly. The best way to check this is to run your changes locally. Instructions can be found in the [README](README.md).
+- We also enjoy the Oxford comma.
+
+##Issue Submissions
+
+We are always looking for the best way to present information about CocoaPods. If you would like to see something specific, or start a discussion, please follow these guidelines.
+
+- Double check there is no open issue for a potential topic. If it is related, but not quite the same, make sure to mention the issue in your post.
+- When opening a new issue, please reference the specific guide you would like to talk about. If it does not exist, make sure to say so.
+- While discussing issues, links to external sites are welcome, but this site is for original content. If you'd like to add a link to a blog post or article, see the External Resource Submission guidelines below.
+- There are some topics, e.g. whether or not to check in the Pods folder, that will be heavily debated. In these situations, we would like to present both sides and give the user the best information to make an informed decision. Please be courteous and resepectful to your fellow developers.
+- UX suggestions are not only welcome, but encouraged. We want to make sure this content is easy to browse and easy to read.
+
+##External Resource Submissions
+
+We love including content from the greater community. When adding a new resource, please follow the following guidelines.
+
+- External resources are to be placed at the bottom of the guide for reference.
+- These should serve to enhance the content available on the Guides site, not duplicate it.
+- Make sure to add a resource on the correct page. E.g. a blog post on creating a private cocoapod should not be on the Specs and Spec Repo guide.
+- Links should lead to articles or blog posts. Please do not add links to StackOverflow, GitHub Issues, Gists, or our mailing list.
+- Links should be active at the time of submission. Please do not link to a mirror site.
+- Any external resource links should lead directly to the resource. Links with paywalls, adwalls, etc will not be accepted.
+- External resources should not be promotions or trying to sell something. We are happy to link to technical posts on your company's blog, but posts solely for advertising purposes will not be accepted.
+- All external resources should be submitted via pull request.
29 Gemfile
@@ -0,0 +1,29 @@
+# If you have OpenSSL installed, we recommend updating
+# the following line to use "https"
+source 'https://rubygems.org'
+
+gem "middleman", "~>3.0.13"
+
+gem 'middleman-rouge'
+gem "middleman-sprockets"
+gem 'middleman-gh-pages'
+gem "middleman-livereload", "~> 3.1.0"
+
+gem 'redcarpet', github: 'vmg/redcarpet'
+gem 'rake'
+gem 'sass'
+
+gem 'slim', '< 2.0'
+gem 'yard', "~> 0.8.6.2"
+
+gem 'activesupport'
+gem 'pygments.rb'
+gem 'github-markup'
+
+gem 'claide'
+gem 'rake'
+
+gem 'xcodeproj'
+gem 'cocoapods'
+gem 'cocoapods-core'
+
@@ -0,0 +1,181 @@
+GIT
+ remote: git://github.com/vmg/redcarpet.git
+ revision: 233e466bb2d93a91f4a4494a14679efbdf05a433
+ specs:
+ redcarpet (3.0.0)
+
+GEM
+ remote: https://rubygems.org/
+ specs:
+ activesupport (3.2.13)
+ i18n (= 0.6.1)
+ multi_json (~> 1.0)
+ chunky_png (1.2.8)
+ claide (0.3.2)
+ cocoapods (0.26.2)
+ activesupport (~> 3.2)
+ claide (~> 0.3.2)
+ cocoapods-core (= 0.26.2)
+ cocoapods-downloader (~> 0.2.0)
+ colored (~> 1.2)
+ escape (~> 0.0.4)
+ json (~> 1.8)
+ open4 (~> 1.3)
+ xcodeproj (~> 0.13.0)
+ cocoapods-core (0.26.2)
+ activesupport (~> 3.0)
+ json (~> 1.8)
+ nap (~> 0.5)
+ cocoapods-downloader (0.2.0)
+ coffee-script (2.2.0)
+ coffee-script-source
+ execjs
+ coffee-script-source (1.3.3)
+ colored (1.2)
+ compass (0.12.2)
+ chunky_png (~> 1.2)
+ fssm (>= 0.2.7)
+ sass (~> 3.1)
+ em-websocket (0.5.0)
+ eventmachine (>= 0.12.9)
+ http_parser.rb (~> 0.5.3)
+ escape (0.0.4)
+ eventmachine (1.0.3)
+ execjs (1.4.0)
+ multi_json (~> 1.0)
+ fssm (0.2.10)
+ github-markup (0.7.5)
+ haml (4.0.3)
+ tilt
+ hike (1.2.3)
+ http_parser.rb (0.5.3)
+ http_router (0.10.2)
+ rack (>= 1.0.0)
+ url_mount (~> 0.2.1)
+ i18n (0.6.1)
+ json (1.8.0)
+ listen (0.7.3)
+ maruku (0.6.1)
+ syntax (>= 1.0.0)
+ middleman (3.0.14)
+ middleman-core (= 3.0.14)
+ middleman-more (= 3.0.14)
+ middleman-sprockets (~> 3.1.0)
+ middleman-core (3.0.14)
+ activesupport (~> 3.2.6)
+ bundler (~> 1.1)
+ listen (~> 0.7.3)
+ rack (~> 1.4.1)
+ rack-test (~> 0.6.1)
+ rb-fsevent (~> 0.9.3)
+ thor (~> 0.15.4)
+ tilt (~> 1.3.6)
+ middleman-gh-pages (0.0.2)
+ rake (> 0.9.3)
+ middleman-livereload (3.1.0)
+ em-websocket (>= 0.2.0)
+ middleman-core (>= 3.0.2)
+ multi_json (~> 1.0)
+ rack-livereload
+ middleman-more (3.0.14)
+ coffee-script (~> 2.2.0)
+ coffee-script-source (~> 1.3.3)
+ compass (>= 0.12.2)
+ execjs (~> 1.4.0)
+ haml (>= 3.1.6)
+ i18n (~> 0.6.0, < 0.6.2)
+ maruku (~> 0.6.0)
+ middleman-core (= 3.0.14)
+ padrino-helpers (= 0.10.7)
+ sass (>= 3.1.20)
+ uglifier (~> 1.2.6)
+ middleman-rouge (0.0.1)
+ middleman-core (>= 3.0.0)
+ redcarpet (>= 2.2.0)
+ rouge (>= 0.3.0)
+ middleman-sprockets (3.1.4)
+ middleman-core (>= 3.0.14)
+ middleman-more (>= 3.0.14)
+ sprockets (~> 2.1)
+ sprockets-helpers (~> 1.0.0)
+ sprockets-sass (~> 1.0.0)
+ multi_json (1.8.1)
+ nap (0.5.1)
+ open4 (1.3.0)
+ padrino-core (0.10.7)
+ activesupport (~> 3.2.0)
+ http_router (~> 0.10.2)
+ sinatra (~> 1.3.1)
+ thor (~> 0.15.2)
+ tilt (~> 1.3.0)
+ padrino-helpers (0.10.7)
+ i18n (~> 0.6)
+ padrino-core (= 0.10.7)
+ posix-spawn (0.3.6)
+ pygments.rb (0.5.2)
+ posix-spawn (~> 0.3.6)
+ yajl-ruby (~> 1.1.0)
+ rack (1.4.5)
+ rack-livereload (0.3.15)
+ rack
+ rack-protection (1.5.0)
+ rack
+ rack-test (0.6.2)
+ rack (>= 1.0)
+ rake (10.1.0)
+ rb-fsevent (0.9.3)
+ rouge (1.0.0)
+ sass (3.2.12)
+ sinatra (1.3.6)
+ rack (~> 1.4)
+ rack-protection (~> 1.3)
+ tilt (~> 1.3, >= 1.3.3)
+ slim (1.3.6)
+ temple (~> 0.5.5)
+ tilt (~> 1.3.3)
+ sprockets (2.10.0)
+ hike (~> 1.2)
+ multi_json (~> 1.0)
+ rack (~> 1.0)
+ tilt (~> 1.1, != 1.3.0)
+ sprockets-helpers (1.0.1)
+ sprockets (~> 2.0)
+ sprockets-sass (1.0.2)
+ sprockets (~> 2.0)
+ tilt (~> 1.1)
+ syntax (1.0.0)
+ temple (0.5.5)
+ thor (0.15.4)
+ tilt (1.3.7)
+ uglifier (1.2.7)
+ execjs (>= 0.3.0)
+ multi_json (~> 1.3)
+ url_mount (0.2.1)
+ rack
+ xcodeproj (0.13.1)
+ activesupport (~> 3.0)
+ colored (~> 1.2)
+ yajl-ruby (1.1.0)
+ yard (0.8.6.2)
+
+PLATFORMS
+ ruby
+
+DEPENDENCIES
+ activesupport
+ claide
+ cocoapods
+ cocoapods-core
+ github-markup
+ middleman (~> 3.0.13)
+ middleman-gh-pages
+ middleman-livereload (~> 3.1.0)
+ middleman-rouge
+ middleman-sprockets
+ pygments.rb
+ rake
+ redcarpet!
+ sass
+ slim (< 2.0)
+ xcodeproj
+ yard (~> 0.8.6.2)
@@ -0,0 +1,23 @@
+CocoaPods Beta Site
+==========
+
+This is the repo for the new CocoaPods Guide site.
+
+
+###I'd like to make a suggestion
+Fantastic! Take a look at our [open issues](https://github.com/CocoaPods/beta.cocoapods.org/issues), and comment on one that seems relevant or open an issue. See our [CONTRIBUTING](CONTRIBUTING.md) guidelines for opening issues.
+
+###I'd like to add my blog post or tutorial.
+Delightful! Double check your link follows our [External Resource Guidelines](CONTRIBUTING.md), then make a pull request.
+
+###I'd like to run guides.cocoapods.org locally
+The guides site is built on [Middleman](http://middlemanapp.com), and runs on Ruby 1.9.3 or newer.
+
+Steps to setup:
+
+1. `$ git clone https://github.com/CocoaPods/guides.cocoapods.org.git`
+2. `$ cd guides.cocoapods.org`
+3. `$ git submodule update --init --recursive`
+4. `$ bundle install`
+5. `$ middleman server`
+6. Open [localhost:4567](http://localhost:4567) in your browser. Changes will be processed automatically
@@ -0,0 +1,5 @@
+require 'middleman-gh-pages'
+
+task :deploy do
+ Rake::Task["publish"].invoke
+end
@@ -0,0 +1,48 @@
+# Layouts
+require "lib/breaking_source.rb"
+require "lib/breaking_image.rb"
+require "lib/shared_layouts.rb"
+
+# Tools for generating data
+require "lib/navigation_helpers.rb"
+require "lib/html_helpers.rb"
+require 'lib/doc/code_objects'
+
+set :encoding, 'utf-8'
+set :relative_links, true
+
+# Support for browsing from the build folder.
+set :strip_index_file, false
+
+configure :build do
+ activate :sprockets
+ activate :minify_javascript
+ activate :minify_css
+ activate :relative_assets
+end
+
+set :markdown, :tables => true, :autolink => true, :gh_blockcode => true, :fenced_code_blocks => true, :with_toc_data => true
+set :markdown_engine, :redcarpet
+
+activate :automatic_image_sizes
+activate :rouge_syntax
+
+activate :breaking_image
+activate :breaking_source
+activate :shared_layouts
+
+helpers NavigationHelpers
+helpers HTMLHelpers
+
+configure :development do
+ activate :livereload
+end
+
+# Allow shared assets folder to not be in source, thereby not dragging in every asset
+after_configuration do
+ sprockets.append_path "../shared/img"
+ sprockets.append_path "../shared/js"
+ sprockets.append_path "../shared/fonts"
+ sprockets.append_path "../shared/includes"
+ sprockets.append_path "../shared/sass"
+end
No changes.
Oops, something went wrong.

0 comments on commit ea004e6

Please sign in to comment.