Polymer Docs - How much do you need to know?

I’ve been reading the docs over here:


There is a huge amount of information here, including a lot of stuff I’ve had to recall from my university days. (See https://en.wikipedia.org/wiki/Design_Patterns)

However, if all we need to know is what tags to use, that’s a different matter.

Your thoughts?

It’s actually not that difficult once you start experimenting with it. The polymer team also have a series of YouTube videos that explain different aspects.

The good news is, we’re all learning as we go. We should share our knowledge and insights here, and focus on the bits that make us happy. I like making words look pretty!

As I understand it, the core philosophy is to “use the platform”, and to stay as close as possible to what is provided by the browser. So for the things that I do, anyway, it’s more a matter of supplementing what’s possible with vanilla HTML/CSS. But I don’t do the complicated stuff.

1 Like

Starting here - https://www.webcomponents.org/

This is a repository for custom elements - with lovely MD names like paper-toast. Using these elements seems pretty straightforward, just link in the script and use the tags. The more involved side of things is creating our own custom elements, such as a <suttaplex>. Am I within a yojana?

Also, I’ve found this a good place to start - https://www.polymer-project.org/2.0/start/quick-tour

1 Like

Yep, that’s pretty much it. Have you grabbed Ayya’s mockup of the new site?

git clone https://github.com/SamaneriVimala/polymer-mockup-sc.git

The general idea is that we try to use the stock Polymer elements as much as possible, as we can rely on them being well made and fitting our overall MD theme. So far we haven’t made a list of modified or custom elements. It would be good to do so at some point, although I’m not sure if we’re there yet: it’s all still early days and everything might change. (In fact it will, as we will upgrade to Polymer 2.0 when that is released: the production site will be Polymer 2.0 from the get-go.)

I have done so, yes.

OK then, so the main thrust is to replace the existing html + jinja templates with static HTML, using existing polymer components, and letting the page request the content it needs from our REST API.

Got it!

Yes, and check out the new next-sc repo. This will be the core repo going forward, as Blake will integrate the live data into Vimala’s front-end template.

Have you had any further thoughts as to what you’d like to do? We had a chat yesterday, and one suggestion was for you to do the templates for the search results pages. No-one’s got that on their immediate to-do list, and it’d be a fairly straightforward project for getting familiar with the process.

OK, I’m happy to start there.

As for my availability, I generally have a few hours available each week. This should extend up to the rains retreat, early July. I’ll then disappear for 3 months.

Beyond that, I’ll be here at Bodhinyana and will hopefully be available long term.

Cool. Well, see what you can do. Even a little is appreciated, not to speak of a lot!

Are you still working over the satellite at JG?

Yep, on the “Sky Muster” satellite service now:


pi@dhammapi:~/next-sc $ ping suttacentral.net
PING suttacentral.net ( 56(84) bytes of data.
64 bytes from icmp_seq=1 ttl=57 time=645 ms

So about .65 second delay each way.

Advertised speeds: 25mbit/s download, 5mbit/s upload - about 4 times the speed of my dad’s ADSL connection.

Quota: 60GB on-peak, 85GB off-peak - shared among the community using “FirstSpot”.

Shall we create an issue over at github for the search result pages?

No, we keep that for issues as such. Use this channel here on Discourse for general discussion, it’s a much nicer conversation platform.

I have created a dedicated page for the MD page search results:

This is currently pretty basic, and does not cover everything. Let’s make it better!

I’d recommend reading the MD specs for search:

However, most of this is not relevant, as it deals with the search box, instant results, etc.

Well, not exactly. The new website will be complete new with different format and layout so everything needs to be changed completely and not merely replace parts.

For the search-pages, it would be great if you could create an independent Polymer element that I can integrate with the rest later. Because those pages use paper-card, you can see at the code I used on the division-page.html to get you started.

Thanks so much for your help!

1 Like

No worries, I’m looking forward to working with the three of you. Just be patient as I get my old coding synapses to fire.