Sync-wiki: Đồng bộ dữ liệu giữa DNH Github Wiki và DNH Discourse

thangngoc89 · April 1, 2015, 1:39pm

daynhauhoc/sync-wiki

App Laravel nhỏ dùng để đồng bộ https://github.com/daynhauhoc/phpdocs và Dạy Nhau Học Forum (Discourse)

Roadmap

[x] Prototype : Quy trình pull từ Github và up lên Forum
[x] Build Discourse API : Đã xong với các endpoint cơ bản
[ ] Thảo luận về quy trình tạo wiki, font-matter, có thể là các nguyên tắc để giúp app chạy mà không cần setting (chỉ cần parse các file là ok)

Mockup

Contribute guidelines

Fork project về
$ git clone [link tới con fork]
$ cd sync-wiki
$ git remote add upstream https://github.com/daynhauhoc/sync-wiki
$ git checkout -b my-feature
code quằn t&agrave; l&agrave; vằn ở đ&acirc;y
$ git add [c&aacute;i list cần add]
$ git commit -m &quot;nội dung commit v&ocirc;.&quot;
$ git pull origin upstream
$ git merge master my-feature
$ git push origin my-feature
L&ecirc;n github, tương c&aacute;i PR (Pull Request)

Nếu rắc rối và không thích dùng command, hãy dùng https://windows.github.com/

Đây là nội dung được tạo tự động. Vui lòng không chỉnh sửa ở đây.
Để đóng góp cho nội dung wiki tốt hơn, hãy gửi pull request tại https://github.com/daynhauhoc/sync-wiki/blob/master/README.md

ltd · March 16, 2015, 2:15pm

Còn đây là topic đang thảo luận cách hoạt động của project này

thangngoc89 · March 16, 2015, 2:16pm

Cho hẳn 1 like nhưng rất tiếc đã đến daily limit

ltd · April 1, 2015, 1:39pm

Đã tăng giới hạn lên gấp 10 lần cho ngày hôm nay

@kayz hình kia là hình local hả?

dqh · March 16, 2015, 2:19pm

local đấy anh đó là cái cốt cơ bản thôi

thangngoc89 · March 16, 2015, 2:20pm

Push lên thử đi @kayz

dqh · March 16, 2015, 2:24pm

done https://github.com/daynhauhoc/sync-wiki/tree/master/public

thangngoc89 · March 16, 2015, 2:54pm

Greate jobs @kayz . Is this enough 20 chars?

dqh · March 16, 2015, 2:57pm

em đang download laravel về ko biết sao mà nó lâu dữ thần vậy

laptrinhio · March 16, 2015, 2:58pm

Không git rebase nhé. Source public rebase ngang tự sát.

Thay vì thế làm thế này.

Fork project về
$ git clone [link tới con fork]
$ cd sync-wiki
$ git remote add upstream https://github.com/daynhauhoc/sync-wiki
$ git checkout -b my-feature
code quằn tà là vằn ở đây
$ git add [cái list cần add]
$ git commit -m "nội dung commit vô."
$ git pull origin upstream
$ git merge master my-feature
$ git push origin my-feature
Lên github, tương cái PR (Pull Request)

thangngoc89 · March 16, 2015, 2:59pm

Tại sao không rebase vậy anh? Vì em thấy nhiều code nó rebase trước khi làm.

thangngoc89 · March 16, 2015, 3:00pm

download lần đầu? Nếu vậy thì nó khó lâu (dù tổng dung lượng nó chưa đến 30MB)

laptrinhio · March 16, 2015, 3:04pm

làm một mình rebase ko sao, nhưng làm nhiều thằng, đứa nào cũng rebase, lúc coi lại history thì commit tại một điểm base của mainstream (master) sẽ bị mất -> rụng code.
Rebase chỉ an toàn, khi phát triển một mình, hoặc theo team nhưng có chia sẻ quyền write cho các member. Còn fork thì ko biết là các thánh đang nằm ở đâu, nên ko được rebase.

thangngoc89 · March 16, 2015, 3:06pm

À. Okie anh. Hiếm khi làm 1 cái repo public nên không biết.
Thấy bên này nó public cũng rebase nên copy https://github.com/flarum/core

laptrinhio · March 16, 2015, 3:06pm

Dùng Windows thì chắc chắn chậm rồi.

thangngoc89 · March 16, 2015, 3:09pm

Và bây giờ là màn copy - paste. Nói là tạo 1 cái boiler-plate của riêng mình hoài mà chưa làm được.
@laptrinhio đặt tên App là gì anh nhỉ ?

Chắc là Sync

laptrinhio · March 16, 2015, 3:08pm

Nó là rebase -i khác nhé. Phải ngồi pick lựa commit để kéo vào base, tương tự một kiểu cherry-pick nhưng chỉ dùng với đồng hộ code base. Câu lệnh này ko dành cho newbie.

laptrinhio · March 16, 2015, 3:09pm

$ php artisan app:name DNHWiki

thangngoc89 · March 16, 2015, 3:10pm

No no, cái namespace file nào cũng gõ mà thế này chắc chệt
Thôi thì Wiki thôi

thangngoc89 · March 17, 2015, 1:50pm

@ltd @laptrinhio @kayz

Đã xong logic cơ bản. Cho vào 2 cái link : Github Link và DNH topic link nó sẽ tự động đồng bộ (asynchronous)

https://github.com/daynhauhoc/sync-wiki/blob/master/app/Http/Controllers/HomeController.php#L10-L15

Bây giờ qua phần tạo giao diện cơ bản

P/s: bây giờ bài viết đầu tiên sẽ được đồng bộ với Github readme.md của repo này luôn