Kurogo Tutorial 02

Version History

Kurogo는 꾸준히 개선되고 있습니다. 아래 내용은 각 버전별 개선된 사항들 입니다. release notes에 대해 좀 더 자세히 알고 싶으시면 CHANGELOG file을 보세요.

Version 1.4 (March 5, 2012)

• NEW Module: Athletics
• NEW Module: Photos
• Updated Map module
• SOAP과 Database retrieval 메소드, 복잡한 데이터 모델을 좀 더 지원하기 위해 Data Retrieval classe 들 개선
  
• 클라이언트 사이드 caching headers 개선
  
• Added support for in-memory caching of Kurogo data structures using Memcache or APC.
  
• Added developer support for encrypting data on disk (requires mcrypt)
• Added option to locally save user credentials so they can be passed on to external services
• Added support for Google Analytics domain names
• Added support to show emergency notifications on the home screen
• Federated search queries will now happen asynchronously on compliant devices.
• Added support to create copied modules from the admin console.
• Added support to remove modules from the admin console

Version 1.3 (October 13, 2011)

• Support for localization
• MultiSite
• New logging facility
• Updated Statistics module
• Updated Map module
• Improved support for recurring events in the calendar module
• Added support for grouping content pages
• If your news feed does not have full content, you can add a “read more” link
• Improved method of creating copied modules
• Support for YouTube playlists in the video module
• Support for Percent Mobile Analytics

Version 1.2 (July 19, 2011)

• Added support for grouping contacts and links
• Added support for IIS
• Streamlined theme development
• Created protocol for data sharing between modules
• Support for alternate methods and custom request headers in DataController
• Admin console can be used on tablets

Version 1.1 (June 1, 2011)

• Added reordering of feeds in the admin console
• Added support for Vimeo in the Video Module
• Added bookmarks to the people module
• Added HTTP proxy support to DataController

Version 1.0 (April 8, 2011)

Initial Release

============ o ============= o ================ o ==============

Getting Support

Kurogo 는 오픈소스 프로젝트이기 때문에 특별히 공식적인 지원은 없습니다. 단지 여러 비공식적으로 질문을 받고 지원을 하는 통로들이 있을 뿐입니다. 개별적인 지원을 받으시려면 유료 지원 서비스를 이용하실 수 있습니다.

Kurogo Google Group

사용자들에 대한 지원을 위해 Kurogo-dev라는 구글 그룹을 만들었습니다. 이 그룹에는 사용자들이 질문과 답변을 공유할 수 있는 메일링 리스트가 포함되 있습니다. 이 리스트는 Modo Labs의 구성원들 (Kurogo code 유지 보수 인력)에 의해 모니터 되고 있습니다. 답변은 공식적인 것이 아니고 구성원들간 자유롭게 주고 받는 메세지 입니다.

•http://groups.google.com/group/kurogo-dev
•kurogo-dev@googlegroups.com

Github Issues

버그를 발견하시면 아래 github 페이지에 그 내용을 올려 주세요.

https://github.com/modolabs/Kurogo-Mobile-Web/issues

Training and Support Through Modo Labs

좀 더 공식적인 지원을 원하시는 사용자는 sales@modolabs.com 로 연락 주시기 바랍니다. 공식적인 지원 내용은 아래와 같습니다.

•Initial Developer Training. Learning the framework, module development, theme design.
•Ramp up/implementation support
•Production / incident support

Professional Services

Modo Labs는 새로운 모듈이나 integration , user experiencce 그리고 인터페이스 디자인 등 좀 더  기술적인 요구가 있는 분들을 도와드리기 위해 professional development와 design service를 제공해 드릴 수 있습니다. 좀 더 자세한 정보는 sales@modolabs.com 로 연락 주세요.

============ o ============= o ================ o ==============


GitHub Repository

Kurogo 는 오픈 소스 프로젝트 입니다. 공짜로 다운로드 받을 수 있고 마음대로 소스를 수정해서 사용하실 수도 있ㅅ브니다. 이 프로젝트는 Git distributed version control system을 사용하고 있습니다. Git repository는 GitHub에서 운영하는 겁니다. 아래 웹사이트에서 만나실 수 있습니다.
https://github.com/modolabs/Kurogo-Mobile-Web

Git이나 GitHub가 생소하신 분은 GitHub Help Site를 먼저 보시기 바랍니다.

Forking and Managing your repository

간단하게 코드만 다운로드 받고 싶으신 분은 git clone git://github.com/modolabs/Kurogo-Mobile-Web.git 을 사용한 repository를 clone 하시면 됩니다.

만약 당신의 프로젝트를 maintaining 하시는데 관심이 있으시다면 그 프로젝트를 fork 하셔야 합지다.

1. GitHub 에 로그인 하기
2. https://github.com/modolabs/Kurogo-Mobile-Web 로 가기
3. 우상단에 있는 fork icon을 클릭하기
4. (Optional) 여러분 프로젝트 이름을 바꿀 수도 있습니다.
5. 여러분 로컬 컴퓨터에 프로젝트 clone 하기
6. Set up an upstream remote:
   ◦ git remote add upstream git://github.com/modolabs/Kurogo-Mobile-Web.git
   ◦ git fetch upstream
7. 변경할 내용이 있으면 아래와 같이 하면 됩니다.
   ◦ git fetch upstream Get updates to the upstream remote
   ◦ git merge upstream/master Merge changes into your master branch

다른 방법으로 여러분의 repository를 관리하는 방법이 있을겁니다. 하지만 이 방법으로 하면 좀 더 유연성있게 운영할 수 있습니다.

Creating your site

여러분의 프로젝트에는 master project에 있지 않은 elements (i.e. 이미지들이나 CSS assets 같은 것들)이 포함되어 있기 때문에 별도의 upstream branch를 유지할 것을 권장합니다. 이 branch는 clean 하게 남아 있을것이고 여러분의 master branch에 merge 될수도 있을겁니다. upstream branch를 생성함으로서 변경 이전 버전으로 돌아가는 기능도 아주 깨끗하게 처리할 수 있게 됩니다.

여러분의 master branch로부터 site/universitas 폴더들의 copy를 만드세요. 이것은 teplate site입니다. 여러분 site에 걸맞는 이름으로 바꿔주세요. 대부분 이 폴더에서 여러분의 코딩이 이루어질 겁니다. 새로운 모듈을 생성한다던가 기존의 모듈을 extend 하고 여러분의 site를 theming 하는것에 대해 좀 더 알아 보시면 많은 도움이 될 겁니다. 여러분만의 특별한 필요가 있지 않는 한 여러분 site의 디렉토리 밖에 있는 file을 수정해야 될 필요는 없을 겁니다.

Submitting your changes

만약에 여러분이 프로젝트 내의 버그를 수정했거나 새로운 기능을 추가해서 공유하고 싶으시면 여러분은 pull request 를 submit 할 수 있습니다. 그러면 Kurogo의 project 유지보수 인력에게 그 사실이 통보 될 것이고 여러분은 이 Kurogo 프로젝트의 주요한 일 부분이 되시는 겁니다.

pull request를 initiate 할 때 아래 매너들을 따라 주실것을 간곡히 부탁드립니다.

1. 여러분의 upstream branch 가 최신버전이어야 합니다.
2. fixes/features 를 implements 해서 새로운 branchm를 만들어 주세요.
3. 여러분의 웹 브라우저로 여러분의 GitHub project를 browse 해 주세요.
4. 여러븐의 fix/feature가 있는 branch로 switch 해 주세요.
5. pull request icon을 클릭해 주세요.
6. 작업에 대한 description을 넣어 주세요. 자세한 사항이 기재돼 있지 않으면 여러분의 request 가 accept 되지 않을 수도 있습니다.
7. 만약 별도의 branch에서 pull request를 initiate 하지 않았다면 여러분은 change commits 버튼을 클릭하시고 여러분의 fix가 포함돼 있는 commit들을 선택하셔야 합니다.
8.변경이 다 완료 됐으면 send pull request 를 click 해 주세요.

request 할 때 꼭 프로젝트에서 변경된 부분과 관련된 사항만 request에 포함시켜 주세요. main branch 쪽 부분도 되도록 포함시키지 말아주시구요. 너무 광범위한 자료를 포함시키면 가끔 의도치 않게 코딩 스타일이나 여러분의 patch 등에 대한 부분만 논의 되다 끝날 수 있습니다.