2018年12月30日 星期日

在OpenedX自訂一個XBlock組件

前陣子介紹過 Open edX的安裝

除了利用原有的預設功能以外,

要創建一個引人入勝的線上課程,

作者必須透過各式各樣的組件來達成.


XBlock就是edX的組件架構,

除了課程可以用以外,

XBlock也能用在API上,

提供edX各式web服務,

馬上進入今天的主題:

在OpenedX自訂一個XBlock組件


為了開發方便,

先下載xblock-sdk

在安裝以前,

系統除了要安裝python2.7以外,

還需要

sudo apt-get install python-dev libxml2-dev libxslt-dev lib32z1-dev libjpeg62-dev

1. 接著下載xblock-sdk

git clone   https://github.com/edx/xblock-sdk.git


2.   建議使用virtualenv建構一個開發環境

virtualenv -p /usr/bin/python2.7 tenv

並啟用該環境

source   tenv/bin/activate


3.  進入xblock-sdk目錄,

並執行make install

安裝完畢首次要再執行

python  manage.py   migrate



 4.    到此xblock-sdk的環境就安裝完成了

打上

python   manage.py   runserver

再到瀏覽器打上localhost:8000

可將設計好的xblock組件先安裝在此xblock-sdk的環境進行測試


5.   在xblock-sdk測試完已經開發完的xblock,

確定沒有問題之後,

就可以部屬到OpenedX中

首先要先將其安裝到OpenedX

sudo -u   edxapp   /edx/bin/pip.edxapp   install   新的xblock



同時確認  cms /  lms  的 common.py   中

xblock_select_function =   prefer_xmodules   選項enable

(路徑為:
/edx/app/edxapp/edx-platform/lms/envs/common.py
/edx/app/edxapp/edx-platform/cms/envs/common.py
)


安裝完畢以後進入studio中,

找到想新增組件的課程

選擇settings / advanced settings


在advanced module list 中加入新的xblock組件



在課程組件選擇 advance,

就能看見新增的組件





如何新增一個xblock呢?


利用xblock-sdk/bin/workbench-make-xblock,

透過此命令可新增基本的xblcok組件,

以利後續開發新功能

 workbench-make-block會詢問兩個問題

1.   xblock名稱

2.   xblock   class名稱 ( 第一個字要大寫,字尾必須為XBlock )





2018年12月28日 星期五

千巧谷牛樂園牧場


位於雲林縣崙背鄉羅厝村東興182-32號,

千巧谷牛樂園牧場

是免費入園的親子牧場,

營業時間為早上九點到晚上八點,

105年正式開幕,

鼓勵大家親近大自然,

園區不收費,


顧名思義,

這裡是以牛為主題的牧場

所以擺設造景等,

都能看到牛


甚至可以實際拿牧草餵牛


也能讓小朋友餵養魚


假日可現場報名DIY手做烘培

平日須提早預約報名,

未滿十人不開課,







牧場的牆邊也掛有一些關於牛的知識,

不僅能讓小朋友與牛親近,

也讓大家對牛有更深的了解,

來到雲林

可以到此一遊






2018年12月19日 星期三

鐵定特大草莓園


每年的十一月到隔年的四月之間,

就是草莓季,

今天就來推薦

鐵定特大草莓園

位於

苗栗縣公館鄉福星村7鄰216號

除了主角草莓以外

規劃有停車場

就在自家的草莓園旁邊

下車領籃子剪刀之後,

就能馬上採草莓



不必收入園費

草莓採多少就算多少

去的時候一斤三百

僅供參考用

需要多少自己斟酌

當然各家草莓園的價格也不一

入園前可以先問問



採完以後,

有紙箱提著回家

趁新鮮吃,

沒吃完記得放冰箱



如果有帶小朋友,

記得不要甩來甩去的

否則帶回家的草莓會受傷







啟德重機械展


啟德重機械展

是由啟德機械起重工程股份有限公司

於12月份辦的展覽活動

展示了許多平常少見的重機械

有輪胎吊車,履帶吊車,以及其他各式吊車,怪手,堆高機等等



除此以外,

許多大大小小的工程車也會一一亮相,

還有胡先生收藏的名車也會擺出來讓大家欣賞,





除了各式工程車的展覽以外,

還有吊車以吊籃帶民眾前往高空體驗,

活動無需特別報名也不需費用


活動地點

308新竹縣寶山鄉大雅路二段365號


有數個展覽場地,

雖說只有展覽兩天,

但是人山人海,

拍照需要耐心排隊喔










2018年12月7日 星期五

程式開發的版本控制- Git 應用篇


之前介紹過Git的安裝,

今天就來教大家如何使用,

其實Git 的使用很簡單,

只要搞懂指令格式,

就能套用在日常的版本控制,


第一次執行的話

請執行

git config   --global   user.mail "使用者信箱"
git   config   --global   user.name   "使用者名字"


初始化使用者資料,


否則使用的時候有可能出現底下兩種錯誤訊息




可直接透過 Pycharm   內建的終端機進行設定


也能透過Git 安裝的終端機做設定,

改完可以打

git  config  --list

觀看設定是否正確



如果要新增一個Repository

來管理某個資料夾,

只需要在該資料夾中輸入

git   init

即可



Pycharm的話

可直接透過VCS  -->  Import into   Version   Control 

找到share   Project   on   GitHub

直接將專案內容上傳到GitHub


輸入此專案的基本資料


輸入GitHub的帳號密碼

 選擇要加入版本控制的檔案

按下Add



以命令列表示的話,

就是

git   add   檔名

加入要版本控制的檔案





除了將專案加入版本控制以外,

也可以複製別人的專案

命令列打

git clone   網址.git

就能夠下載別人所分享的專案來使用




以Pycharm的話,

可以直接從歡迎畫面選擇

Check out from   Version   Control   來複製專案


輸入要放置的資料夾


選擇Log in   to   GitHub

再選擇要下載的專案點選Clone即可


Pycharm會詢問是否要切換到該專案

這裡選擇Yes



如果以命令列表示的話

這裡執行了兩個步驟:


下載 demo_proj
git clone   https://github.com/guangyaw/demo_proj.git

切換到master
git  checkout   master



到這邊,

一些基本的Git功能,

都已經學會了

再列出來複習一下:

1.   git init                                                            資料夾初始化
2.   git   clone   http://project.git     複製project
3. git   checkout   master                      切換到master
4. git   add   filename                                將filename加入版本控制




如果想更新專案的程式碼可透過

git   pull



如果改完code 想將其傳回伺服器則用

git   push


上傳之前,

可用

git   commit   -m   '註解'

加上簡單的描述以備將來查詢之用,



分支的新增與合併


git   branch   分支名稱


可新增一個分支

再執行

git   checkout   分支名稱


切換到該分支進行開發

這再多人研發或者不同用途的開發中,

是一個很實用的功能,


修改完畢之後,

可以切回主線

git   checkout   master



以命令:


git   merge   分支名稱


將分支所修改的部分結合到主線中




以上這些都是Git版本控制中,

常用到的命令,

也滿足一般版本控制的需求,

其他進階應用,

下次有機會再介紹吧



















2018年12月1日 星期六

程式開發的版本控制- Git 安裝篇


程式開發過程中,

肯定製作了不少版本,

有些只用來除錯,

有些則是不同programmer修改的不同版本

甚至有些用來 release 正式版本,

至於如何對這些版本做管理與控制呢?

這就是今天的主題了:

程式開發的版本控制- Git 安裝篇


以windows 10   為範例做安裝教學,




下載完畢直接執行安裝程式 ,

第一步是一份版權宣告


 指定要安裝的位置


選擇要安裝的元件


在Windows程式集新增一個Git目錄


選擇要使用的編輯器


詢問要使用預設的命令列,

這裡使用windows預設cmd,



選擇SSL  lib for   https連線



這步驟是選擇是否自動轉換斷行符號

是由於windows與   linux在斷行符號上面的差異

Linux上面預設斷行符號通常以  \n   表示
windows上面預設為   \n\r 

當core.autocrlf為true時,

git會自動將斷行符號設為  \n

取用時,

自動轉回  \n\r
 


選擇喜好的終端機模擬器


其他選項



到此就安裝完畢




雖說安裝步驟很多,

其實最佳的設定還是以預設值為主,

程式開發的版本控制- Git 安裝篇,

其實到這裡就算是結束了,

敬請期待


程式開發的版本控制- Git 應用篇