ruby - Difficult code packaging design -

-

this long story, let me apologize in advance....

i've built tool write college curricula using static site generator nanoc. nanoc nice ruby based package , distributed gem.

i installed gem, , used "nanoc new" command create basic directory structure. within directory structure wrote custom ruby code, large number of markdown files define first course. here's course built.

the code showed above, in git, corresponds result of work, nanoc + customizations. there's bundler file has run bring in additional gems well.

let's call individual course "cosi235a.course" , let's call tool "nanoc-course". call author of cosi235a.course "an author" , call maintainer of "nanoc-course" "me".

what seeking nice design decouple nanoc-course cosi235a.course. in other words, want separate customized nanoc based tool content of 1 course.

that way if want design curriculum second course can create , still pull in updates common code. more that, author create new course on site, , use nanoc-course themselves, , benefit updates make tool.

i've been turning design question on in mind , not finding idea like. here ideas, half baked, far:

  1. make nanoc-courss on git contain except markdown, html, , other content files. happen live in subdirectory called ./content according nanoc. directory empty on git. add rake tasks create symlinks separate directory containing cosi235a.course files. way author can work on content files , @ time git pull updates nanoc-course. clean separation clunky.

  2. make nanoc course gem used nanoc. in other words, author installs nanoc, gem install (or bundler install) of nanoc-course , add line or 2 nanoc's libs incorporate logic. separation less complete , requires author (who not ruby programmer) modify code. it's fragile respect nanoc changes.

i know it's long story. have ideas?

have same problem. option 1 seems obvious, requires author understand intricacies of git - , can see going wrong easily.

i'd tend towards modification of 2, have custom gem based on nanoc locking specific version within gemspec. "course" have contain few basic elements, e.g.

/content

/output

gemfile <== contains "nanoc-course" gem

gemfile.lock

supply template project course authors , you'd have teach authors how use bundler.


Comments

Post a Comment

Popular posts from this blog

css - Which browser returns the correct result for getBoundingClientRect of an SVG element? -

-
this svg contains rect overflows svg element: <svg id='svg' width='10' height='10'> <rect x='-10' y='-10' width='30' height='30'/> </svg> chrome 28 , opera 12 return getboundingclientrect() svg element width , height of 10. firefox 23 reports width , height of 30. correct? jsfiddle the relevant spec cssom , delegates svg spec if svg element not "have associated css layout box". haven't found definition of "having associated css layout box", correct result seem hinge on definition, getbbox returns 30x30 rect in browsers. this firefox bug fixed now, fix in firefox nightlies , should make through firefox 33 released on 14 october 2014. see bug 530985 details.
Read more

gcc - Calling fftR4() in c from assembly -

-
i trying asm fft implementation www.embeddedsignals.com work. running make gives error: undefined reference fftr4(short*, short*, int) at top of asm have .syntax unified .thumb .global fftr4 .type fftr4, %function and there #define's associate c functions arguments registers followed macros fftr4 function uses. after that, fftr4 called .thumb_func fftr4: stmfd sp!, {r4-r11, lr} mov tmp0, #0 // bit reversed counter mov tmp1, #0 .word 0xf3a2fa92 //rbit r3,r2 //rbit r,n lsl r,#3 and c code follows: void fftr4(short *y, short *x, int n); short x[512]; short y[512]; int i; void loop() { (i=0;i<512;i++) x[i]=0; (i=0;i<512;i=i+8) { x[i+0]=16384; x[i+2]=16384; x[i+4]=-16384; x[i+6]=-16384;} fftr4(y, x, 256); serialusb.println(y[128]); serialusb.println(y[129]); serialusb.println(y[384]); serialusb.println(y[385]); // expected results: //y[128]is 8191; y[129] -8190 y[
Read more

Function that returns a formatted array in VBA -

-
i have function prints excel data text file in array format following: [ ['id', 'label', 'longitude', 'latitude', 'country', 'region', 'ttl_wt_flw_thru', 'sum-of-bol-wt', 'count of wdr_ref', 'ratio'], ['aeauh', 'abu dhabi, united arab emirates', 54.3666667, 24.4666667, 'ae', 'eame', 66, 30, 8432, 281.066666666667], ['aedxb', 'dubai, united arab emirates', 55.307485, 25.271139, 'ae', 'eame', 682, 3, 8369, 2789.66666666667] ] my code writing array is: function fillsourcearray() dim long, j long, s string dim lastrow double dim s1 string 'opens file filepath = filepath & "dataarray" & ".txt" open filepath output #1 'read source data dataarray = sheets("nodes").cells(1).currentregion.value 'determine lastrow lastrow = sheets("nodes").range
Read more