Bauke/tildes-issue-log
Bauke
/
tildes-issue-log
Archived
1
Fork 0
Code Releases Activity
Archive of the Tildes Issue Log.
This repository has been archived on 2022-10-04. You can view files and clone it, but cannot push or open issues or pull requests.
104 Commits 1 Branch 0 Tags 7.8 MiB
TypeScript 49.9%
SCSS 29.8%
HTML 18.5%
JavaScript 1.8%
Go to file
Bauke f911b37afe
feat: add gitlab issue template for monthly task list 		2019-11-07 21:12:33 +01:00
.gitlab/issue_template feat: add gitlab issue template for monthly task list 2019-11-07 21:12:33 +01:00
graphs chore: update total graphs 2019-04-07 12:55:06 +02:00
images chore: readme reformat 2019-09-22 01:32:04 +02:00
src fix: correct the official topic links 2019-11-01 12:39:31 +01:00
.gitignore Massive change from Markdown to custom website with Pug & Sass 2018-07-16 03:29:01 +02:00
.gitlab-ci.yml refactor: remove master branch from running 2019-10-31 23:45:56 +01:00
LICENSE Add LICENSE (AGPL-3.0-or-later) 2018-11-01 12:31:52 +01:00
README.md feat: add october 2019 post 2019-10-31 22:56:33 +01:00
gulpfile.js fix: make feeds contain the 5 most recent posts 2019-07-07 13:51:40 +02:00
package.json fix: fix all linting errors 2019-07-05 23:51:11 +02:00
sample-config.json Change template around and remove url from sample-config 2018-06-24 20:16:30 +02:00
statistics.js fix: fix all linting errors 2019-07-05 23:51:11 +02:00
yarn.lock chore: switch to xo and stylelint-xo 2019-07-05 23:43:30 +02:00

README.md

Tildes Issue Log

Monthly blog highlighting Tildes.net development

2019

2018

Contributing

If you'd like to write a highlight section about a feature, please do! I'm not a writer by any means and would love to have other people write these instead. If you're not familiar with the Git workflow you can always private message me with what you've written and I'll add your section for you, crediting your Tildes profile. If you'd like to learn Git, you can find tons of guides online. Here's an excellent one.

Building

If you'd like to build the issue table, statistics and/or website yourself you can follow these steps.

You'll need Node JS and Yarn. You can use NPM however I don't. You probably know what you're doing though at that point.

  • Clone the repository
    • SSH: git clone git@gitlab.com:Bauke/tildes-issue-log.git
    • HTTPS: git clone https://gitlab.com/Bauke/tildes-issue-log.git
  • Change into the directory: cd tildes-issue-log
  • Install the dependencies: yarn
  • Create a config.json file from the sample config, including a personal access token from GitLab. config.json is gitignored however make sure you don't publish your token somewhere on accident.
  • Run yarn dl to download the issues from the current month we're in and build the statistics and issue table, if you already have the issue files you can run yarn nodl to skip the downloading
  • To easily develop the website itself you can run yarn watch to watch the src/ folder for changes and automatically lint the sass and build the files. Running yarn watch will open your default browser at localhost:3000.
  • To build the site only once you can do yarn build, the files will be built under public/, a requirement for GitLab Pages.

A new gitignored directory will be created called data/ including all the files to generate the Statistics and the Issue Table files, which will appear in the "out" folder labelled as MonthYear_table/statistics.html. To generate them for a specific year and/or month you'll have to go into the Gulp file and change the wantedYear and/or the wantedMonth.

If you're working on the generation process you can run yarn nodl to skip the downloading phase, this will only generate table.html and statistics.html. This way you don't have to wait several seconds for the GitLab API to respond.

If you want to lint your sass (using Stylelint) manually you can run yarn lint, in the future when we have JavaScript (if ever) this will also include JS linting however as there's 0 JS ending up on the site at the moment there's no need for it.