Hey Joe Thanks for making the additions to the Apache CMS to meet our use case. I'm not seeing any blockers at the moment, lets cut over and we can fix any edge cases if needed
-Jake On Mon, Mar 24, 2014 at 1:39 PM, Joseph Schaefer <joe_schae...@yahoo.com>wrote: > Done. Anything else we need to look at before going live? > > Sent from my iPhone > > > On Mar 23, 2014, at 3:53 PM, Roger Meier <ro...@bufferoverflow.ch> > wrote: > > > > any idea how to fix this URL: > > http://thrift.staging.apache.org/test/ThriftTest.thrift > > we need to keep the filename for working links within the > > test/README.md file. > > > > What about a footer for docs genertated from source tree? > > [snippet:path=test/README.md, footer=1] > > > > I added the following snippet to content/test/index.md: > > ---SNIP--- > > This page was generated from Apache Thrift's **source tree docs**: > > [test/README.md]( > https://git-wip-us.apache.org/repos/asf/thrift/repo?p=thrift.git;a=blob;f=test/ThriftTest.thrift;hb=HEAD > ) > > ---SNIP--- > > > > would be great to get this generated into the page via snippet. > > > > -roger > > > > > >> On 23.03.2014 19:04, Joe Schaefer wrote: > >> The CMS codebase as well as the thrift build system > >> already supports it Roger, someone just needs to create > >> the files in the content tree that point at the source > >> files in the git repo. If you want to script this process > >> in scripting language du jour, go for it, but I cannot > >> justify spending contractor time doing this work for the > >> community's behalf as it is unlikely to be needed elsewhere. > >> I would think you only need the script to run when some > >> path to a README.md file changes in the thrift.git tree, > >> so it doesn't need to be incorporated into each site build. > >> > >> > >> > >>>> On Sunday, March 23, 2014 9:15 AM, Roger Meier < > ro...@bufferoverflow.ch> wrote: > >>>> Hi > >>> > >>>> On 23.03.2014 03:19, Jake Farrell wrote: > >>>> Hey Joe > >>>> Reviewing the staging site it looks like its almost 99% there other > than > >>>> some styling within the code snippets. I'm good if we want to cut > over > >>> to > >>>> using this and then work on the additional features that had been > mentioned > >>>> afterwords. Any objections to cutting over? > >>> I would really like to see this automatic README.md includes from > source > >>> tree, to have a real additional feature beside of what we already have > >>> today. > >>> > >>> I'm absolutely with you. > >>> Apache projects shall use other Apache projects whenever possible. > >>> > >>>> On Sat, Mar 22, 2014 at 4:36 PM, Joe Schaefer > >>> <joe_schae...@yahoo.com>wrote: > >>>> > >>>>> May I suggest a script that creates files in content/ > >>>>> containing a single line > >>>>> > >>>>> [snippet:path=...] > >>> this sounds like a plan > >>> > >>>>> > >>>>> (with no 'lang' argument) that lets the CMS pull raw content > >>> from > >>>>> thrift.git > >>>>> and add it directly to the built pages. That way you only need to > run > >>> the > >>>>> script that generates these files when a path changes in your > >>> thrift.git > >>>>> repo. > >>> What I had in mind is a automatic search of README.md files across the > >>> source tree and generate the site with these automatically. > >>> Kind of a central controller that maps all the URL's. > >>> no additional work when a new README.md file is added. > >>> however, a script can do this as interim soultion. > >>>>> > >>>>> You can commit directly to the cms svn tree or via the webgui which > >>> does > >>>>> the same thing. > >>> Great! > >>> > >>> What about local preview when doing perl modifications? > >>> > >>> -roger > >>> > >>> > >>>>> > >>>>> > >>>>>> On Saturday, March 22, 2014 4:20 PM, Roger Meier < > >>>>> ro...@bufferoverflow.ch> wrote: > >>>>>>> I still see some issues and still miss to feature mentioned. > >>>>>> Now we have nonoc.ws and I'm able to hack this a bit. > >>>>>> > >>>>>> We had no real big issue, the thing I missed was the code snippet > >>> thing > >>>>>> and this is in on nanoc.ws and now also on Apache CMS. > >>>>>> > >>>>>> The thing we really need is the documentation located within source > >>> code > >>>>>> integrated on the web site. > >>>>>> > >>>>>> most hosting platforms do render README.md and that's why lot > >>> of doc > >>>>>> will stay within the code and we should benefit as well by > >>> rendering > >>>>>> that to the web site and enhance the documentation very easily. > >>>>>> > >>>>>> I would like to render the 41 README.md files to with the following > >>>>>> pattern, that's a must have before switching to another CMS. > >>>>>> > >>>>>> test/README.md => thrift.apache.org/test > >>>>>> test/STATUS.md => thrift.apache.org/test/status > >>>>>> test/keys/README.md => thrift.apache.org/test/keys > >>>>>> lib/<lang>/README.md => thrift.apache.org/lib/<lang> > >>>>>> lib/<lang>/test/README.md => > >>> thrift.apache.org/lib/<lang>/test > >>>>>> lib/<lang>/examples/README.md => > >>>>>> thrift.apache.org/lib/<lang>/examples > >>>>>> compiler/cpp/README.md => thrift.apache.org/compiler > >>>>>> debian/README.md => thrift.apache.org/debian > >>>>>> contrib/<topic>/README.md => > >>> thrift.apache.org/<topic> > >>>>>> > >>>>>> CPP tutorial seems to be broken on staging. > >>>>>> > >>>>>> Do you commit to > >>> https://svn.apache.org/repos/asf/thrift/cms-site/trunk > >>>>>> or is it web gui only? > >>>>>> > >>>>>> How do you generate the site on your local machine? > >>>>>> > >>>>>> > >>>>>> Should I reactivate my perl or do we stay with ruby? > >>>>>> Committers and contributors, what do you think? > >>>>>> > >>>>>> > >>>>>> all the best > >>>>>> -roger > >>>>>> > >>>>>> > >>>>>>> On 22.03.2014 18:07, Joe Schaefer wrote: > >>>>>>> > >>>>>>> > >>>>>>> Ok I've now done the basic necessities involved in > >>> porting > >>>>>>> the site over. Links have been adjusted, templates ported, > >>> files > >>>>> created, > >>>>>>> snippet feature activated. At this point I'm happy to > >>> declare > >>>>>>> victory and migrate the thrift live site over, as anything > >>> broken that > >>>>>>> still remains can be dealt with on a per-page basis with the > >>>>> bookmarklet. > >>>>>>> > >>>>>>> > >>>>>>> > >>>>>>>> On Thursday, March 20, 2014 11:19 AM, Joe Schaefer > >>>>>> <joe_schae...@yahoo.com> wrote: > >>>>>>>>> Modulo some bizarre content truncation out of > >>> git-wip-us.apache.org > >>>>>>>> the snippet support is now active. At this point I think > >>> all the build > >>>>>>>> support you need in this project to support every type of > >>>>> brainstorming > >>>>>>>> activity we've discussed is now there, so it's > >>> just up to you > >>>>>> guys to > >>>>>>>> now familiarize yourselves with the build technology and > >>> how to apply > >>>>>>>> it to your needs. The site builds with snippet support > >>> are running > >>>>>> around > >>>>>>>> 10 seconds, which is to be expected with the network > >>> interactions > >>>>>> involved. > >>>>>>>> > >>>>>>>> I'm always willing to answer any questions that come > >>> up in the > >>>>>> interim, > >>>>>>>> but I wish you guys the best of luck in the remaining > >>> porting work to > >>>>>> be done. > >>>>>>>> All I see really are some links that need to have the > >>> trailing slashes > >>>>>> removed > >>>>>>>> and whatever <%= %> template constructs that remain > >>> need to be > >>>>>> ported to > >>>>>>>> django. So it should be smooth sailing, but as I said if > >>> you hit any > >>>>>> snags > >>>>>>>> holler. I'd really like to see the live site tech > >>> switched over to > >>>>>> the cms > >>>>>>>> stuff before Apachecon ends in early April, hint hint. > >>>>>>>> > >>>>>>>> > >>>>>>>> > >>>>>>>> > >>>>>>>> > >>>>>>>>>> On Wednesday, March 19, 2014 10:41 PM, Joe Schaefer > >>>>>>>>> <joe_schae...@yahoo.com> wrote: > >>>>>>>>> > While I don't yet know the url magic to > >>> support branches > >>>>>> and tags > >>>>>>>> in git, > >>>>>>>>> I can say that the snippet support is ready to play > >>> with. I > >>>>>> suggest just > >>>>>>>>> focusing on the /index.md page first to see how it > >>> works in > >>>>>> practice > >>>>>>>> because > >>>>>>>>> once it's fully enabled the build will break > >>> until all the > >>>>>> snippet > >>>>>>>> sources > >>>>>>>>> have been altered to conform with the new style. > >>>>>>>>> > >>>>>>>>> To turn it on for index.md testing, there are a > >>> couple of things > >>>>>> that need > >>>>>>>> to > >>>>>>>>> happen. First the [snippet:...] marker should be > >>> edited to be > >>>>>>>> [XXXsnippet:...] > >>>>>>>>> to enable testing without breaking the build. > >>> Second each marker > >>>>>> contains > >>>>>>>> a > >>>>>>>>> "token" argument instead of line numbers > >>> for more > >>>>>> stability under > >>>>>>>> > >>>>>>>>> edits to the source code. The token argument is an > >>> arbitrary > >>>>>> string that > >>>>>>>> is > >>>>>>>>> used to denote the boundaries of the snippet within > >>> the source > >>>>>> code. > >>>>>>>>> ASF::Value::Snippet will pull out the lines from > >>> the source file > >>>>>> between > >>>>>>>> the > >>>>>>>>> lines that contain the token argument and format > >>> them as a code > >>>>>> snippet > >>>>>>>> embedded > >>>>>>>>> into markdown. To get started I'll copy over > >>> the code > >>>>>> highlighting css > >>>>>>>> from > >>>>>>>>> www.apache.org but note that this is all based on > >>> python pygments > >>>>>> and there > >>>>>>>> are > >>>>>>>>> a variety of online css files to choose from if > >>> this one is not > >>>>>> to the > >>>>>>>>> group's liking. > >>>>>>>>> > >>>>>>>>> > >>>>>>>>> > >>>>>>>>>> On Wednesday, March 19, 2014 4:16 PM, Joe > >>> Schaefer > >>>>>>>>> <joe_schae...@yahoo.com> wrote: > >>>>>>>>>> > Sorry I need to clarify with an example: > >>> look at > >>>>>>>>>> http://thrift.staging.apache.org/tutorial/ > >>> versus > >>> http://thrift.staging.apache.org/tutorial.html. The > >>>>>>>>>> former is generated from > >>> content/tutorial/index.html > >>>>>>>>>> and the latter from content/tutorial.md. The > >>> latter file > >>>>>>>>>> needs to be removed from the tree now that > >>> it's content > >>>>>>>>>> has been ported to > >>> content/tutorial/index.html. This > >>>>>>>>>> uses django template inheritance to maintain > >>> simplicity. > >>>>>>>>>> > >>>>>>>>>> Other directories that follow a similar > >>> pattern should > >>>>>>>>>> also be ported in the same fashion. > >>>>>>>>>> > >>>>>>>>>> > >>>>>>>>>> > >>>>>>>>>>> On Wednesday, March 19, 2014 9:46 AM, Joe > >>> Schaefer > >>>>>>>>>> <joe_schae...@yahoo.com> wrote: > >>>>>>>>>>> > If someone's looking for a way > >>> to help with > >>>>>> the porting > >>>>>>>>>>> effort, consider tackling the creation of > >>> an index.html > >>>>>>>>>>> page in each subdir of the content/ tree > >>> (other than > >>>>>> the > >>>>>>>>>>> base which has an /index.md). The > >>> contents of the file > >>>>>>>>>>> should be just > >>>>>>>>>>> > >>>>>>>>>>> {% include 'default' %} > >>>>>>>>>>> > >>>>>>>>>>> (see the docs dir for an example page > >>> that can be > >>>>>> copied) > >>>>>>>>>>> and the build system will take care of > >>> generating the > >>>>>> page > >>>>>>>>>>> in a consistent fashion with the rest of > >>> the site. > >>>>>> Once > >>>>>>>>>>> that is done there are a lot of pages > >>> that function > >>>>>> like > >>>>>>>>>>> index pages but are written in markdown > >>> that can be > >>>>>> deleted, > >>>>>>>>>>> like docs.md and its ilk. Nanoc > >>> transforms that file > >>>>>> into > >>>>>>>>>>> /docs/index.html but that's kinda > >>> crufty and not > >>>>>> supported > >>>>>>>>>>> by the CMS, which only lets you alter > >>> file extensions > >>>>>> not paths. > >>>>>>>>>>> > >>>>>>>>>>> > >>>>>>>>>>> > >>>>>>>>>>> > >>>>>>>>>>>> On Wednesday, March 19, 2014 8:54 > >>> AM, Joe Schaefer > >>>>>>>>>>> <joe_schae...@yahoo.com> wrote: > >>>>>>>>>>>> > I just pencilled in snippet > >>> preprocessing > >>>>>> support into > >>>>>>>>>>>> the thrift builds. Once Jake and I > >>> have settled > >>>>>> on the > >>>>>>>>>>>> feature set of ASF::Value::Snippet, > >>> and we have > >>>>>> ported > >>>>>>>>>>>> the snippet calling text within the > >>> markdown pages > >>>>>>>>>>>> to the new format, things will just > >>> work (knock on > >>>>>> wood). > >>>>>>>>>>>> > >>>>>>>>>>>> > >>>>>>>>>>>> > >>>>>>>>>>>> > >>>>>>>>>>>>> On Wednesday, March 19, 2014 > >>> 6:48 AM, Joseph > >>>>>> Schaefer > >>>>>>>>>>>> <joe_schae...@yahoo.com> > >>> wrote: > >>>>>>>>>>>>> > Sure I understand that > >>> need. If > >>>>>> there's a way > >>>>>>>> of > >>>>>>>>>> pulling the > >>>>>>>>>>> > >>>>>>>>>>>> document > >>>>>>>>>>>>> sources directly from the web I > >>> can parse the > >>>>>> content > >>>>>>>> to > >>>>>>>>> look for > >>>>>>>>>> > >>>>>>>>>>> snippet > >>>>>>>>>>>>> markers and make those > >>> available to the > >>>>>> template > >>>>>>>> system. > >>>>>>>>>> That's > >>>>>>>>>>> pretty > >>>>>>>>>>>> much > >>>>>>>>>>>>> how www.apache.org is > >>> generated. > >>>>>>>>>>>>> > >>>>>>>>>>>>> Sent from my iPhone > >>>>>>>>>>>>> > >>>>>>>>>>>>> > >>>>>>>>>>>>>> On Mar 19, 2014, at 5:28 > >>> AM, Henrique > >>>>>> Mendonça > >>>>>>>>>>>> <henri...@apache.org> > >>>>>>>>>>>>> wrote: > >>>>>>>>>>>>>> > >>>>>>>>>>>>>> Hi Joe, > >>>>>>>>>>>>>> > >>>>>>>>>>>>>> Thanks for your effort. I > >>> just wanted to > >>>>>> add that > >>>>>>>> the > >>>>>>>>> code > >>>>>>>>>>> snippets > >>>>>>>>>>>> are a > >>>>>>>>>>>>>> crucial feature for this > >>> project, which > >>>>>> has way > >>>>>>>> more > >>>>>>>>> target > >>>>>>>>>>> languages > >>>>>>>>>>>> than > >>>>>>>>>>>>>> active contributors. In > >>> our case, > >>>>>> reducing manual > >>>>>>>>>> maintenance > >>>>>>>>>>> costs is > >>>>>>>>>>>> much > >>>>>>>>>>>>>> more important than the > >>> total site build > >>>>>> time. > >>>>>>>> Perhaps > >>>>>>>>> we > >>>>>>>>>> can > >>>>>>>>>>> also > >>>>>>>>>>>> solve > >>>>>>>>>>>>>> this in the CMS, though. > >>>>>>>>>>>>>> > >>>>>>>>>>>>>> - Henrique > >>>>>>>>>>>>>> > >>>>>>>>>>>>>> > >>>>>>>>>>>>>>> On 19 March 2014 > >>> 03:17, Joe Schaefer > >>>>>>>>>>>> <joe_schae...@yahoo.com> > >>>>>>>>>>>>> wrote: > >>>>>>>>>>>>>>> > >>>>>>>>>>>>>>> A couple more thoughts > >>> regarding the > >>>>>>>> background on > >>>>>>>>> the > >>>>>>>>>> CMS... > >>>>>>>>>>>>>>> the bulk of the focus > >>> of the CMS up > >>>>>> until now > >>>>>>>> has > >>>>>>>>> been > >>>>>>>>>> to > >>>>>>>>>>>>>>> support really big > >>> sites like maven > >>>>>> and > >>>>>>>> openoffice, > >>>>>>>>> both > >>>>>>>>>> of > >>>>>>>>>>>>>>> which have websites > >>> well over 5GB > >>>>>> worth of > >>>>>>>> text > >>>>>>>>> files. > >>>>>>>>>> The > >>>>>>>>>>>>>>> build system was > >>> hollowed out and > >>>>>> revamped to > >>>>>>>>> support > >>>>>>>>>>> external > >>>>>>>>>>>>>>> builds in other > >>> programming > >>>>>> languages, as well > >>>>>>>> as > >>>>>>>>>> scaling up > >>>>>>>>>>>>>>> the perl builds to > >>> provide about 8 > >>>>>> child > >>>>>>>> processes > >>>>>>>>> that > >>>>>>>>>> build > >>>>>>>>>>>>>>> the site in parallel > >>> by default. > >>>>>> Full site > >>>>>>>> build > >>>>>>>>> times > >>>>>>>>>> for > >>>>>>>>>>>>>>> openoffice went from > >>> over 30 minutes > >>>>>> to > >>>>>>>> between 5 > >>>>>>>>> to 10 > >>>>>>>>>>> minutes > >>>>>>>>>>>>>>> depending on disk > >>> activity, which > >>>>>> made > >>>>>>>>> experimentation > >>>>>>>>>> with > >>>>>>>>>>>> site-wide > >>>>>>>>>>>>>>> changes feasible on a > >>> reasonable > >>>>>> timeframe. > >>>>>>>> At > >>>>>>>>> first > >>>>>>>>>> the > >>>>>>>>>>> project > >>>>>>>>>>>> was > >>>>>>>>>>>>> in > >>>>>>>>>>>>>>> the habit of running > >>> the builds > >>>>>> locally before > >>>>>>>> > >>>>>>>>> checking > >>>>>>>>>> in > >>>>>>>>>>> their > >>>>>>>>>>>>> changes > >>>>>>>>>>>>>>> because the delay in > >>> feedback > >>>>>> post-commit was > >>>>>>>>>> unreasonable, > >>>>>>>>>>> but > >>>>>>>>>>>> with > >>>>>>>>>>>>> smart > >>>>>>>>>>>>>>> use of SSI the were > >>> able to cut down > >>>>>> on the > >>>>>>>> number > >>>>>>>>> of > >>>>>>>>>> changes > >>>>>>>>>>> that > >>>>>>>>>>>> > >>>>>>>>>>>>> required > >>>>>>>>>>>>>>> full site builds and > >>> hence no longer > >>>>>> bother > >>>>>>>> with > >>>>>>>>> the > >>>>>>>>>> whole > >>>>>>>>>>>> pre-build > >>>>>>>>>>>>> mumbo > >>>>>>>>>>>>>>> jumbo before checking > >>> in changes. > >>>>>> The CMS is > >>>>>>>>> designed > >>>>>>>>>> to > >>>>>>>>>>> only > >>>>>>>>>>>> build > >>>>>>>>>>>>> pages > >>>>>>>>>>>>>>> that were altered, and > >>> if you just > >>>>>> edit a page > >>>>>>>> or > >>>>>>>>> two > >>>>>>>>>> only > >>>>>>>>>>> those > >>>>>>>>>>>> pages > >>>>>>>>>>>>> and > >>>>>>>>>>>>>>> the pages that depend > >>> on them will > >>>>>> be built. > >>>>>>>>>>>>>>> > >>>>>>>>>>>>>>> Now that I've > >>> turned my > >>>>>> attention to > >>>>>>>> thrift, > >>>>>>>>> there > >>>>>>>>>> are > >>>>>>>>>>> several > >>>>>>>>>>>> > >>>>>>>>>>>>> aspects > >>>>>>>>>>>>>>> that are better off > >>> being retuned > >>>>>> based on the > >>>>>>>> > >>>>>>>>> modest > >>>>>>>>>> size of > >>>>>>>>>>> the > >>>>>>>>>>>> site. > >>>>>>>>>>>>>>> First of all you have > >>> a sitemap url > >>>>>> that lists > >>>>>>>> all > >>>>>>>>> of > >>>>>>>>>> your > >>>>>>>>>>>>> markdown-based > >>>>>>>>>>>>>>> pages, which would be > >>> a nonstarter > >>>>>> for a site > >>>>>>>> like > >>>>>>>>>>> openoffice. > >>>>>>>>>>>> The > >>>>>>>>>>>>>>> implications of the > >>> sitemap url are > >>>>>> that every > >>>>>>>> page > >>>>>>>>> > >>>>>>>>>> needs to > >>>>>>>>>>> be > >>>>>>>>>>>> built > >>>>>>>>>>>>> in > >>>>>>>>>>>>>>> memory just to > >>> generate that page, > >>>>>> which leads > >>>>>>>> to a > >>>>>>>>> lot > >>>>>>>>>> of > >>>>>>>>>>>> redundancy > >>>>>>>>>>>>> in a > >>>>>>>>>>>>>>> build system designed > >>> to run as > >>>>>> forked child > >>>>>>>>> processes. > >>>>>>>>>> We > >>>>>>>>>>> can do > >>>>>>>>>>>> > >>>>>>>>>>>>> better... > >>>>>>>>>>>>>>> > >>>>>>>>>>>>>>> I've done two > >>> things to make > >>>>>> this work > >>>>>>>> well- > >>>>>>>>> first I > >>>>>>>>>> made > >>>>>>>>>>> the > >>>>>>>>>>>>> number of > >>>>>>>>>>>>>>> child processes > >>> "aka > >>>>>> runners" > >>>>>>>> tunable on > >>>>>>>>> a > >>>>>>>>>>> per-project > >>>>>>>>>>>> basis, > >>>>>>>>>>>>> and since the > >>>>>>>>>>>>>>> sitemap is going to > >>> build every page > >>>>>> anyway as > >>>>>>>> the > >>>>>>>>>> slowest > >>>>>>>>>>> page to > >>>>>>>>>>>> > >>>>>>>>>>>>> build, I > >>>>>>>>>>>>>>> memoized the main view > >>> that builds > >>>>>> the > >>>>>>>> markdown > >>>>>>>>> pages > >>>>>>>>>> for > >>>>>>>>>>> thrift. > >>>>>>>>>>>> The > >>>>>>>>>>>>> best > >>>>>>>>>>>>>>> results are when > >>> there's only > >>>>>> one runner > >>>>>>>> so we > >>>>>>>>> get > >>>>>>>>>> the > >>>>>>>>>>> full > >>>>>>>>>>>> benefit > >>>>>>>>>>>>> of > >>>>>>>>>>>>>>> memoization: typical > >>> site build > >>>>>> times are > >>>>>>>>> consistently > >>>>>>>>>> under > >>>>>>>>>>> 2 > >>>>>>>>>>>> seconds > >>>>>>>>>>>>> now. > >>>>>>>>>>>>>>> > >>>>>>>>>>>>>>> You'll appreciate > >>> why I am such > >>>>>> a > >>>>>>>> performance > >>>>>>>>>> stickler > >>>>>>>>>>> for the > >>>>>>>>>>>> CMS > >>>>>>>>>>>>> when > >>>>>>>>>>>>>>> you start using the > >>> bookmarklet, > >>>>>> since builds > >>>>>>>> are > >>>>>>>>> the > >>>>>>>>>> only > >>>>>>>>>>>> asynchronous > >>>>>>>>>>>>>>> part of the process > >>> from making a > >>>>>> change to a > >>>>>>>> page > >>>>>>>>> and > >>>>>>>>>>> publishing > >>>>>>>>>>>> the > >>>>>>>>>>>>>>> results. Ideally when > >>> the system is > >>>>>> working > >>>>>>>> well > >>>>>>>>> the > >>>>>>>>>> builds > >>>>>>>>>>>> happen > >>>>>>>>>>>>> before > >>>>>>>>>>>>>>> you have time to go > >>> looking for > >>>>>> them, but you > >>>>>>>> do > >>>>>>>>> need to > >>>>>>>>>> be > >>>>>>>>>>>> mindful of > >>>>>>>>>>>>> not > >>>>>>>>>>>>>>> publishing before the > >>> built pages > >>>>>> have been > >>>>>>>>> committed > >>>>>>>>>> back to > >>>>>>>>>>> svn > >>>>>>>>>>>> by > >>>>>>>>>>>>>>> buildbot. > >>>>>>>>>>>>>>> > >>>>>>>>>>>>>>> > >>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>> On Monday, March > >>> 17, 2014 11:59 > >>>>>> PM, Joe > >>>>>>>>> Schaefer > >>>>>>>>>>>>> <joe_schae...@yahoo.com> > >>>>>>>>>>>>>>> wrote: > >>>>>>>>>>>>>>>>> Ok there's > >>> enough of an > >>>>>> idea about > >>>>>>>> how > >>>>>>>>> to > >>>>>>>>>> port > >>>>>>>>>>> the > >>>>>>>>>>>> rest of > >>>>>>>>>>>>> the site's > >>>>>>>>>>>>>>>> pages over based > >>> on the porting > >>>>>> work > >>>>>>>> I've > >>>>>>>>>> already > >>>>>>>>>>> done > >>>>>>>>>>>> that > >>>>>>>>>>>>> it's time > >>>>>>>>>>>>>>>> for me to step > >>> back and let you > >>>>>> guys catch > >>>>>>>> up. > >>>>>>>>> > >>>>>>>>>> Basically > >>>>>>>>>>> the > >>>>>>>>>>>> idea > >>>>>>>>>>>>> is > >>>>>>>>>>>>>>> that while > >>>>>>>>>>>>>>>> there is > >>> templating support in > >>>>>> the > >>>>>>>> markdown > >>>>>>>>> sources, > >>>>>>>>>> > >>>>>>>>>>> it's > >>>>>>>>>>>>> fairly limited > >>>>>>>>>>>>>>>> compared to what > >>> nanoc offers, > >>>>>> but instead > >>>>>>>> of > >>>>>>>>>> writing a > >>>>>>>>>>> lot of > >>>>>>>>>>>> > >>>>>>>>>>>>> complex > >>>>>>>>>>>>>>> template > >>>>>>>>>>>>>>>> code into your > >>> sources, with the > >>>>>> cms you > >>>>>>>> just > >>>>>>>>> add > >>>>>>>>>> code to > >>>>>>>>>>> > >>>>>>>>>>>>> lib/view.pmand/or > >>>>>>>>>>>>>>>> lib/path.pm to > >>> keep the document > >>>>>> sources > >>>>>>>> simple > >>>>>>>>> and > >>>>>>>>>> just > >>>>>>>>>>> add > >>>>>>>>>>>> more > >>>>>>>>>>>>>>> template > >>>>>>>>>>>>>>>> variables. What I > >>> just finished > >>>>>> in > >>>>>>>> lib/view.pm > >>>>>>>>> and > >>>>>>>>>>>> lib/path.pm is > >>>>>>>>>>>>>>> directory > >>>>>>>>>>>>>>>> listing support > >>> for /docs.html > >>>>>> but it can > >>>>>>>> be > >>>>>>>>> carried > >>>>>>>>>> over > >>>>>>>>>>> to > >>>>>>>>>>>>> similar > >>>>>>>>>>>>>>> pages. > >>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>> On Monday, > >>> March 17, 2014 > >>>>>> 9:16 PM, Joe > >>>>>>>> > >>>>>>>>> Schaefer > >>> <joe_schae...@yahoo.com> > >>>>>> wrote: > >>> Interesting ideas, > >>>>>> thanks. FWIW I > >>>>>>>> > >>>>>>>>> think > >>>>>>>>>> that > >>>>>>>>>>> sort > >>>>>>>>>>>>>>>>> of thing might > >>> be best > >>>>>> supported as a > >>>>>>>>> periodic > >>>>>>>>>> cron > >>>>>>>>>>>>>>>>> if we can > >>> write something > >>>>>> stable > >>>>>>>> enough, > >>>>>>>>> because > >>>>>>>>>> > >>>>>>>>>>> pulling > >>>>>>>>>>>>>>>>> stuff out of > >>> the git repo is > >>>>>> something > >>>>>>>> the > >>>>>>>>> CMS > >>>>>>>>>>> isn't > >>>>>>>>>>>> going > >>>>>>>>>>>>>>>>> to do all that > >>> well being an > >>>>>> svn > >>>>>>>>> application. > >>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>> The CMS build > >>> results are > >>>>>> available at > >>> http://thrift.staging.apache.org/ > >>>>>>>>>>>>>>>>> feel free to > >>> play with the > >>>>>> sources in > >>> repos/asf/thrift/cms-site/trunk. > >>>>>>>>>>>>>>>>> It's very > >>> fast, probably > >>>>>> an order > >>>>>>>> of > >>>>>>>>>> magnitude > >>>>>>>>>>> faster > >>>>>>>>>>>> than > >>>>>>>>>>>>> your current > >>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>> tech. > >>>>>>>>>>>>>>>>> Whole site > >>> builds in two > >>>>>> seconds; > >>>>>>>> fractions > >>>>>>>>> of a > >>>>>>>>>> > >>>>>>>>>>> second > >>>>>>>>>>>> for > >>>>>>>>>>>>> typical > >>>>>>>>>>>>>>> mods to > >>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>> content/ > >>> markdown pages. > >>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>> The CMS > >>> bookmarklet is > >>>>>> compatible with > >>>>>>>> the > >>>>>>>>>> staging > >>>>>>>>>>> site > >>>>>>>>>>>> FWIW. > >>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>> On > >>> Monday, March 17, > >>>>>> 2014 7:40 > >>>>>>>> PM, > >>>>>>>>> Roger > >>>>>>>>>> Meier > >>>>>> <ro...@bufferoverflow.ch> wrote: > >>>>>>>>>>>>>>>>>>> Hi Joe > >>> & Co > >>>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>> thanks > >>> for this test > >>>>>> run with > >>>>>>>> Apache > >>>>>>>>> CMS! > >>>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>> What I > >>> would love to > >>>>>> see is this: > >>>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>> Source > >>> file: => Web > >>>>>> Site URL: > >>> test/README.md => > >>>>>>>>> thrift.apache.org/test > >>> test/STATUS.md => > >>>>>>>>>>> thrift.apache.org/test/status > >>> test/keys/README.md > >>>>>> => > >>>>>>>>>>> thrift.apache.org/test/keys > >>>>>> lib/<lang>/README.md => > >>> thrift.apache.org/lib/<lang> > >>>>>> lib/<lang>/test/README.md > >>>>>>>> => > >>>>>>>> thrift.apache.org/lib/<lang>/test > >>>>>>>> lib/<lang>/examples/README.md > >>>>>>>>> => > >>>>>>>>> thrift.apache.org/lib/<lang>/examples > >>> compiler/cpp/README.md > >>>>>> => > >>>>>>>>>>>> thrift.apache.org/compiler > >>> debian/README.md => > >>>>>>>>>> thrift.apache.org/debian > >>>>>> contrib/<topic>/README.md > >>>>>>>> => > >>>>>>>>>>>>> thrift.apache.org/<topic> > >>>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>> just made > >>> the following > >>>>>> patch to > >>>>>>>>> rename all > >>>>>>>>>> file > >>>>>>>>>>> to > >>>>>>>>>>>> .md > >>>>>>>>>>>>> within our > >>>>>>>>>>>>>>>> source > >>>>>>>>>>>>>>>>>> tree: > >>> https://issues.apache.org/jira/browse/THRIFT-2407 > >>>>>>>>>>>>>>>>>> ... we > >>> have *41* > >>>>>> md's within > >>>>>>>> the > >>>>>>>>> source > >>>>>>>>>> tree > >>>>>>>>>>> and > >>>>>>>>>>>>> that's the > >>>>>>>>>>>>>>>> place > >>>>>>>>>>>>>>>>> where > >>>>>>>>>>>>>>>>>> people > >>> look for > >>>>>> documentation > >>>>>>>> first. > >>>>>>>>> => > >>>>>>>>>>> simple to > >>>>>>>>>>>>> manage > >>>>>>>>>>>>>>>>>> Would be > >>> user friendly > >>>>>> to have > >>>>>>>> all of > >>>>>>>>> this > >>>>>>>>>>> online > >>>>>>>>>>>> with > >>>>>>>>>>>>> each release > >>>>>>>>>>>>>>>>>> with the > >>> URL layout > >>>>>> mentioned > >>>>>>>> above. > >>>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>> just > >>> received the > >>>>>> buildboot... > >>>>>>>>>>>>>>>>>> Do you > >>> have kind of a > >>>>>> preview of > >>>>>>>> your > >>>>>>>>>> prototype? > >>>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>> all the > >>> best! > >>>>>>>>>>>>>>>>>> -roger > >>>>>>>>>>>>>>>>>> ;-r > >>>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>> Quoting > >>> Jake Farrell > >>>>>>>>>>> <jfarr...@apache.org>: > >>>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>>> No > >>> objections from > >>>>>> me > >>> -Jake > >>>>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>>> On > >>> Mon, Mar 17, > >>>>>> 2014 at > >>>>>>>> 12:04 PM, > >>>>>>>>> Joe > >>>>>>>>>>> Schaefer > >>>>>>>> <joe_schae...@yahoo.com>wrote: > >>>>>>>>>>>>>>>>>>> > >>> Any objections > >>>>>> to me > >>>>>>>> making a > >>>>>>>>> copy > >>>>>>>>>> of > >>>>>>>>>>> the > >>>>>>>>>>>> site > >>> tree alongside > >>>>>> it called > >>>>>>>> > >>>>>>>>>> cms-site? > >>>>>>>>>>> I'd > >>>>>>>>>>>> like > >>>>>>>>>>>>> to > >>> get cracking > >>>>>> on knocking > >>>>>>>> up > >>>>>>>>> the > >>>>>>>>>>> supporting > >>>>>>>>>>>> perl > >>> for this so we > >>>>>> can > >>>>>>>> continue > >>>>>>>>> to > >>>>>>>>>>> brainstorm... > >>>>>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>>>> > >>> On Sunday, > >>>>>> March 16, > >>>>>>>> 2014 > >>>>>>>>> 1:53 > >>>>>>>>>> PM, > >>>>>>>>>>> Joe > >>>>>>>>>>>> Schaefer > >>>>>> <joe_schae...@yahoo.com> > >>> wrote: > >>> On > >>>>>> Sunday, March > >>>>>>>> 16, > >>>>>>>>> 2014 > >>>>>>>>>> 1:40 > >>>>>>>>>>> PM, > >>>>>>>>>>>> Jake > >>>>>>>>>>>>> Farrell > >>>>>> <jfarr...@apache.org> > >>> wrote: > >>> Hey Joe > >>> Thanks > >>>>>> for > >>>>>>>> reaching > >>>>>>>>> out, we > >>>>>>>>>> chose > >>>>>>>>>>> to > >>>>>>>>>>>> go > >>>>>>>>>>>>> with a site > >>>>>>>>>>>>>>>>> generator > >>>>>>>>>>>>>>>>>> over the > >>> Apache > >>>>>> CMS due to > >>>>>>>> it > >>>>>>>>>> initially > >>>>>>>>>>> not > >>>>>>>>>>>> meeting > >>>>>>>>>>>>> all of > >>>>>>>>>>>>>>>> our > >>>>>>>>>>>>>>>>> needs. > >>>>>>>>>>>>>>>>>> Our > >>> current > >>> needs > >>>>>> for the site > >>>>>>>> are > >>> - > >>>>>> Markdown to html > >>>>>>>> > >>>>>>>>>> conversion > >>> That > >>>>>> one's easy- > >>>>>>>> its > >>>>>>>>> the > >>>>>>>>>> default > >>>>>>>>>>> for > >>>>>>>>>>>> the > >>>>>>>>>>>>> cms. > >>>>>>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>>>>> > >>> - Global > >>>>>>>>> variables/config > >>>>>>>>>> usable > >>>>>>>>>>>> throughout > >>>>>>>>>>>>> in a > >>>>>>>>>>>>>>>> template > >>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>> based > >>> layout > >>> Easy too- > >>>>>> just create > >>>>>>>> a > >>>>>>>>> perl > >>>>>>>>>> hash > >>>>>>>>>>>> somewhere and > >>>>>>>>>>>>> make it > >>>>>>>>>>>>>>>>> available > >>>>>>>>>>>>>>>>>> to > >>> your views. > >>> Code your > >>>>>> views to > >>>>>>>> pass > >>>>>>>>> that > >>>>>>>>>> hash > >>>>>>>>>>> along to > >>>>>>>>>>>> your > >>>>>>>>>>>>>>>> templates > >>>>>>>>>>>>>>>>> and you > >>>>>>>>>>>>>>>>>> are > >>> all set. > >>> Note if your > >>>>>> hash > >>>>>>>> contains > >>>>>>>>>> objects > >>>>>>>>>>> you can > >>>>>>>>>>>> make > >>>>>>>>>>>>> method > >>>>>>>>>>>>>>>> calls > >>>>>>>>>>>>>>>>> on > >>>>>>>>>>>>>>>>>> them in > >>> your > >>> templates. > >>>>>> Note: > >>>>>>>> while I > >>>>>>>>>>> wouldn't > >>>>>>>>>>>>> recommend this in > >>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>> general, > >>>>>>>>>>>>>>>>>> for > >>> smaller > >>> projects > >>>>>> like thrift > >>>>>>>> that > >>>>>>>>> prefer > >>>>>>>>>> > >>>>>>>>>>>> convenience > >>>>>>>>>>>>> over > >>>>>>>>>>>>>>>> separation > >>>>>>>>>>>>>>>>> of > >>>>>>>>>>>>>>>>>> concerns > >>> you can > >>> have the > >>>>>> django > >>>>>>>> template > >>>>>>>>> engine > >>>>>>>>>> do a > >>>>>>>>>>> pass > >>>>>>>>>>>> over > >>>>>>>>>>>>> your > >>>>>>>>>>>>>>>> markdown > >>>>>>>>>>>>>>>>>> before > >>> passing it > >>> along to > >>>>>> your actual > >>>>>>>>> template > >>>>>>>>>> page, > >>>>>>>>>>> just > >>>>>>>>>>>> as is > >>>>>>>>>>>>> seemingly > >>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>> common to > >>>>>>>>>>>>>>>>>> other > >>> popular > >>> site > >>>>>> generation > >>>>>>>> software. > >>>>>>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>>>>> > >>> - Syntax > >>>>>>>> highlighting > >>> Comes with > >>>>>>>> python's > >>>>>>>>> markdown > >>>>>>>>>> > >>>>>>>>>>> support, > >>>>>>>>>>>> but > >>>>>>>>>>>>> some > >>>>>>>>>>>>>>>> people > >>>>>>>>>>>>>>>>> prefer > >>>>>>>>>>>>>>>>>> the look > >>> of > >>> javascript > >>>>>>>> highlighters. > >>>>>>>>>>>>>>>>>>>>> > >>> - Easily > >>>>>> include > >>>>>>>> code > >>>>>>>>>> snippets > >>>>>>>>>>> from > >>>>>>>>>>>> our > >>>>>>>>>>>>> source code > >>>>>>>>>>>>>>>> base > >>> Statically I > >>>>>> hope. No > >>>>>>>> idea > >>>>>>>>> how > >>>>>>>>>> to > >>>>>>>>>>> pull > >>>>>>>>>>>>> snippets out of > >>>>>>>>>>>>>>>> your > >>>>>>>>>>>>>>>>> git > >>>>>>>>>>>>>>>>>> repo > >>> via the > >>> cms. > >>>>>>>>>>>>>>>>>>>>> > >>> - > >>>>>> Ability to > >>>>>>>> locally > >>>>>>>>> test > >>>>>>>>>> before > >>>>>>>>>>>> committing > >>> Belt and > >>>>>> suspenders > >>>>>>>> with > >>>>>>>>> the > >>>>>>>>>> cms- you > >>>>>>>>>>> can > >>>>>>>>>>>> build > >>>>>>>>>>>>> your > >>>>>>>>>>>>>>>> changes > >>>>>>>>>>>>>>>>>> before > >>> committing > >>> with the > >>>>>> build > >>>>>>>> scripts, > >>>>>>>>> browse > >>>>>>>>>> your > >>>>>>>>>>>> changes > >>>>>>>>>>>>> before > >>>>>>>>>>>>>>>> committing > >>>>>>>>>>>>>>>>> via > >>>>>>>>>>>>>>>>>> the cms > >>> webgui, or > >>>>>> simply > >>>>>>>> commit > >>>>>>>>> your > >>>>>>>>>> changes > >>>>>>>>>>> and > >>>>>>>>>>>> view > >>>>>>>>>>>>> the > >>>>>>>>>>>>>>>> staging > >>>>>>>>>>>>>>>>> site > >>>>>>>>>>>>>>>>>> prior to > >>> live > >>> publication > >>>>>> (which is > >>>>>>>> a > >>>>>>>>> separate > >>>>>>>>>> > >>>>>>>>>>> step). > >>>>>>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>>>>> > >>>>>>>>>>>>>>>>>>>>> > >>> -Jake > >>> On Sun, > >>>>>> Mar 16, > >>>>>>>> 2014 at > >>>>>>>>> > >>>>>>>>>> 12:44 PM, > >>>>>>>>>>> Joe > >>>>>>>>>>>>> Schaefer > >>>>>>>>>> <joe_schae...@yahoo.com>wrote: > >>>>>>>>>>>>>>>>>>>>>> > >>> As > >>>>>> it so > >>>>>>>> happens I > >>>>>>>>> am > >>>>>>>>>>> interested > >>>>>>>>>>>> in > >>>>>>>>>>>>> working on > >>>>>>>>>>>>>>>>> supporting > >>>>>> thrift's > >>>>>>>> use > >>>>>>>>> case as > >>>>>>>>>> a > >>>>>>>>>>>> potential > >>>>>>>>>>>>> user of > >>>>>>>>>>>>>>>> the > >>>>>>>>>>>>>>>>> Apache > >>>>>>>>>>>>>>>>>> CMS. > >>>>>> While the CMS > >>>>>>>> works > >>>>>>>>> well > >>>>>>>>>> for > >>>>>>>>>>>> massive > >>>>>>>>>>>>> projects > >>>>>>>>>>>>>>>> there > >>>>>>>>>>>>>>>>> are > >>>>>> things it > >>>>>>>> could do > >>>>>>>>>> better at > >>>>>>>>>>>> supporting > >>>>>>>>>>>>> for > >>>>>>>>>>>>>>>> more > >>>>>>>>>>>>>>>>> moderate > >>>>>> sized sites > >>>>>>>> like > >>>>>>>>>>> thrift's. > >>>>>> I'd > >>>>>>>> therefore > >>>>>>>>> like > >>>>>>>>>> to > >>>>>>>>>>> engage > >>>>>>>>>>>> you > >>>>>>>>>>>>> folks in a > >>>>>>>>>>>>>>>> > >>> brainstorming session > >>>>>> about what > >>>>>>>> sorts of > >>>>>>>>> > >>>>>>>>>> features > >>>>>>>>>>> you > >>>>>>>>>>>> want > >>>>>>>>>>>>> for your > >>>>>>>>>>>>>>>> site > >>>>>>>>>>>>>>>>> and > >>>>>>>>>>>>>>>>>> to find > >>>>>> simple ways of > >>>>>>>> > >>>>>>>>>> supporting > >>>>>>>>>>> those > >>>>>>>>>>>>> features for > >>>>>>>>>>>>>>>> you. > >>>>>> Thanks. > > >
