GithubHelp home page GithubHelp logo

perladvent / perldotcom Goto Github PK

View Code? Open in Web Editor NEW
77.0 12.0 78.0 237.17 MB

The source code for Perl.com website

Home Page: https://www.perl.com

Perl 46.89% HTML 49.50% JavaScript 0.54% CSS 2.03% Prolog 0.25% Shell 0.28% Raku 0.12% Makefile 0.39%
perl hugo website articles community

perldotcom's Introduction

Perl.com

Hello!

Perl.com is a website dedicated to Perl programming code, culture, and community news.

If you're interested in writing for Perl.com, check out our contributing guide. You can send us a pull request with your article. Please open a new GitHub issue if you have any questions or feedback. We're always looking for new writers and material!

perldotcom's People

Contributors

1nickt avatar andyjack avatar ash avatar autarch avatar briandfoy avatar cxw42 avatar davorg avatar dnmfarrell avatar fgasper avatar fostytou avatar frezik avatar grinnz avatar jacoby avatar jessp01 avatar jesusbagpuss avatar jrw avatar kyzn avatar lucasbuchala avatar manwar avatar matstar2 avatar mjgardner avatar oalders avatar oylenshpeegul avatar paultcochrane avatar polettix avatar rwp0 avatar schw1804 avatar sdeseille avatar thibaultduponchelle avatar yehorlevchenko avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

perldotcom's Issues

OpenGraph & Twitter Cards

Would be good to have OpenGraph and Twitter Card headers, so that Facebook and Twitter show images when the site's content is shared.

I'll have a look to see how easy it is over the next couple of days.

Fix author data

e.g. data/author/tom-christiansen-nathan-torkington.json

should be two separate files. It probably comes from when Article.pm
extracts the author names from either the RDF or vcard in the article
html.

Fix site styling:

We should have mostly a handful of colors:

  • white for background and empty space (done)
  • charcoal for text (done)
  • dark blue like perl.com for the header
  • a light blue or grey for secondary color
  • an even lighter version of secondary color

Perl.com twitter feed

Right now it's just the twitter feed for The Perl Foundation. I think we should hook up Perlybot to publish its feed to twitter.

Article URLs are different from perl.com

All of the old links should still work, but don't right now on the static site:

The path contains an extra /article component and is missing the .html ending

Support for per-article licenses?

I'd very strongly prefer to see my old stuff under a plain CC BY-SA license. I really dislike the NC clause.

That said, I don't know if I have standing to request that, since I think my stuff was written for ORA way back when. If they licensed the content to TPF only under CC BY-SA-NC 3.0 then there's not much I can do about it.

But regardless, it might be good to support per-article licenses.

Fix up categories

e.g. "development" is too broad, break articles having that category into
more specific, useful categories. Likewise "tutorials" isn't really useful
as much of the site content is teaching material. Maybe "tutorials" should
be a tag instead.

Figure out toplinks widget

For now I think it can stay on perltricks.com, assuming brwosers don't
prevent it from loading on perl.com because of cross-domain requests.

Find and patch broken links

Many of the articles must have broken links, scan for these and figure out
whether they should be updatred or removed.

"Read it" links need user input acknowledgement

Right now clicking them doesn't lead to the browser loading anything, but instead just sitting there for a few seconds until JS does the thing. Bad ux. Especially on bad networks where things might just break silently in the background.

Fix Perl.com styling

  • Use a dark blue, rename the variable from "perltricks blue"
  • Update class attributes to use the new name instead

no "archive" page?

Trying to find articles by e.g. rough timeframe is only possible in a hacky way right now. There should be some kind of archive/calendar/??? view.

Create an article linter program

This program would check an article file to ensure everything is as it should be:

  • The meta data are well-formed
  • Meta data are complete
  • The content is valid markdown
  • The author data is in the repo
  • The images are in the repo
  • Any external links are good

extract_article_links - short codes
``` " tchrist quoting
` runaway code line (tchrist article) - unclosed (maybe limit length of stuff on the inside)

Get Sawyer's author info

Get Sawyer's author info. I've already emailed him asking for a pull request.

  • Picture static/images/author/sawyerx.jpg
  • JSON data data/author/sawyerx.json

Re-org repo

This repo should be moved to the Perl organization, and the tpf.github.io
submodule removed. Additionally the perl.com directory should be deleted
as it duplicates many files, including several large media files.

Fix article generator to copy graphics

  • Create a new article specific directory under static/images
  • Copy contents of graphics folder there (if exists)
  • Copy any other locally referenced images there
  • Update all HTML src to point to the new location
  • Determine if there is an article thumbnail and set the object
    attribute if there is
  • Update the serialize code to include an article thumbnail
  • Update the hugo template to try and use the thumbnail first, then
    the article cover image, then the first author's image.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.