Compare commits
3 commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 3a7a4f6498 | |||
| c342596868 | |||
| a0b598d38e |
3175 changed files with 0 additions and 1069765 deletions
1
.envrc
1
.envrc
|
|
@ -1 +0,0 @@
|
||||||
use flake
|
|
||||||
|
|
@ -1,2 +0,0 @@
|
||||||
# Move source files into an `src` directory.
|
|
||||||
51c5f5759d667821fc94b9ed170de9a43dfbc848
|
|
||||||
8
.gitignore
vendored
8
.gitignore
vendored
|
|
@ -1,8 +0,0 @@
|
||||||
# Nix.
|
|
||||||
/.direnv/
|
|
||||||
/result
|
|
||||||
|
|
||||||
# pdfpc.
|
|
||||||
/**/*.pdfpc
|
|
||||||
|
|
||||||
/**/*.pdf
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
vim.keymap.set("n", "<leader>ta", '_iTextAnnotation "<Esc>A"<Esc>j')
|
|
||||||
vim.keymap.set("v", "<leader>ta", ':norm ITextAnnotation "<Esc>gv:norm A"<Esc>')
|
|
||||||
|
|
||||||
vim.keymap.set("n", "<Left>", "gT")
|
|
||||||
vim.keymap.set("n", "<Right>", "gt")
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
Talks and Presentations by Oliver Davies
|
|
||||||
########################################
|
|
||||||
|
|
||||||
The source files for `my presentation slides <https://www.oliverdavies.uk/presentations>`_, written in reStructuredText and compiled using `rst2pdf <https://rst2pdf.org>`_.
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 20 KiB |
Binary file not shown.
|
|
@ -1,27 +0,0 @@
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
PageBreak standardPage
|
|
||||||
|
|
||||||
Result
|
|
||||||
======
|
|
||||||
|
|
||||||
- Easier and faster to create and onboard projects.
|
|
||||||
- One canonical source of truth.
|
|
||||||
- Easy to add new features and fixes for all projects.
|
|
||||||
- Automation is easier due to consistency (e.g. Docker Compose service names).
|
|
||||||
|
|
||||||
Thanks!
|
|
||||||
=======
|
|
||||||
|
|
||||||
References:
|
|
||||||
|
|
||||||
- https://opdavi.es/build-configs
|
|
||||||
- https://github.com/opdavies/docker-example-drupal
|
|
||||||
- https://github.com/opdavies/docker-example-drupal-commerce-kickstart
|
|
||||||
- https://github.com/opdavies/docker-example-drupal-localgov
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
||||||
Me:
|
|
||||||
|
|
||||||
- https://www.oliverdavies.uk
|
|
||||||
|
|
@ -1,52 +0,0 @@
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
PageBreak standardPage
|
|
||||||
|
|
||||||
Overriding Values
|
|
||||||
=================
|
|
||||||
|
|
||||||
.. code-block:: yaml
|
|
||||||
|
|
||||||
php:
|
|
||||||
version: 8.1-fpm-bullseye
|
|
||||||
# Disable PHPCS, PHPStan and PHPUnit.
|
|
||||||
phpcs: false
|
|
||||||
phpstan: false
|
|
||||||
phpunit: false
|
|
||||||
|
|
||||||
# Ignore more directories from Git.
|
|
||||||
git:
|
|
||||||
ignore:
|
|
||||||
- /bin/
|
|
||||||
- /libraries/
|
|
||||||
- /web/profiles/contrib/
|
|
||||||
|
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
TextAnnotation "Drupal Commerce Kickstart demo. No custom modules to test, and additional paths to ignore from Git."
|
|
||||||
|
|
||||||
PageBreak
|
|
||||||
|
|
||||||
.. code-block:: yaml
|
|
||||||
|
|
||||||
dockerfile:
|
|
||||||
stages:
|
|
||||||
build:
|
|
||||||
# What additional directories do we need?
|
|
||||||
extra_directories:
|
|
||||||
- config
|
|
||||||
- patches
|
|
||||||
- scripts
|
|
||||||
|
|
||||||
commands:
|
|
||||||
- composer validate --strict
|
|
||||||
- composer install
|
|
||||||
|
|
||||||
# What additional PHP extensions do we need?
|
|
||||||
extensions:
|
|
||||||
install: [bcmath]
|
|
||||||
|
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
TextAnnotation "Extra directories and PHP extensions that need to be added".
|
|
||||||
|
|
||||||
|
|
@ -1,92 +0,0 @@
|
||||||
Example
|
|
||||||
=======
|
|
||||||
|
|
||||||
build.yaml:
|
|
||||||
|
|
||||||
.. code-block:: yaml
|
|
||||||
|
|
||||||
name: my-example-project
|
|
||||||
type: drupal
|
|
||||||
language: php
|
|
||||||
|
|
||||||
php:
|
|
||||||
version: 8.1-fpm-bullseye
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
||||||
Dockerfile:
|
|
||||||
|
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
TextAnnotation "Abstract the project-specific values and configuration into this file."
|
|
||||||
|
|
||||||
.. code-block:: yaml
|
|
||||||
|
|
||||||
FROM php:8.1-fpm-bullseye AS base
|
|
||||||
|
|
||||||
Configuring a Project
|
|
||||||
=====================
|
|
||||||
|
|
||||||
.. code-block:: yaml
|
|
||||||
|
|
||||||
php:
|
|
||||||
version: 8.1-fpm-bullseye
|
|
||||||
|
|
||||||
# Which PHPCS standards should be used and on which paths?
|
|
||||||
phpcs:
|
|
||||||
paths: [web/modules/custom]
|
|
||||||
standards: [Drupal, DrupalPractice]
|
|
||||||
|
|
||||||
# What level should PHPStan run and on what paths?
|
|
||||||
phpstan:
|
|
||||||
level: max
|
|
||||||
paths: [web/modules/custom]
|
|
||||||
|
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
PageBreak
|
|
||||||
|
|
||||||
.. code-block:: yaml
|
|
||||||
|
|
||||||
docker-compose:
|
|
||||||
# Which Docker Compose services do we need?
|
|
||||||
services:
|
|
||||||
- database
|
|
||||||
- php
|
|
||||||
- web
|
|
||||||
|
|
||||||
dockerfile:
|
|
||||||
stages:
|
|
||||||
build:
|
|
||||||
# What commands do we need to run?
|
|
||||||
commands:
|
|
||||||
- composer validate --strict
|
|
||||||
- composer install
|
|
||||||
|
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
PageBreak
|
|
||||||
|
|
||||||
.. code-block:: yaml
|
|
||||||
|
|
||||||
web:
|
|
||||||
type: nginx # nginx, apache, caddy
|
|
||||||
|
|
||||||
database:
|
|
||||||
type: mariadb # mariadb, mysql
|
|
||||||
version: 10
|
|
||||||
|
|
||||||
# Where is Drupal located?
|
|
||||||
drupal:
|
|
||||||
docroot: web # web, docroot, null
|
|
||||||
|
|
||||||
experimental:
|
|
||||||
createGitHubActionsConfiguration: true
|
|
||||||
runGitHooksBeforePush: true
|
|
||||||
useNewDatabaseCredentials: true
|
|
||||||
|
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
TextAnnotation "Experimental opt-in features that I want to trial on certain projects or to disable non-applicable features - e.g. GitHub Actions on Bitbucket."
|
|
||||||
|
|
||||||
PageBreak
|
|
||||||
|
|
@ -1,300 +0,0 @@
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
PageBreak titlePage
|
|
||||||
|
|
||||||
.. class:: centredtitle
|
|
||||||
|
|
||||||
Build Configs internals
|
|
||||||
|
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
PageBreak standardPage
|
|
||||||
|
|
||||||
.. code-block::
|
|
||||||
|
|
||||||
src/
|
|
||||||
Action/
|
|
||||||
CreateFinalConfigurationData.php
|
|
||||||
CreateListOfFilesToGenerate.php
|
|
||||||
GenerateConfigurationFiles.php
|
|
||||||
ValidateConfigurationData.php
|
|
||||||
Command/
|
|
||||||
GenerateCommand.php
|
|
||||||
InitCommand.php
|
|
||||||
DataTransferObject/
|
|
||||||
ConfigDto.php
|
|
||||||
TemplateFile.php
|
|
||||||
Enum/
|
|
||||||
Language.php
|
|
||||||
ProjectType.php
|
|
||||||
WebServer.php
|
|
||||||
|
|
||||||
.. code-block:: php
|
|
||||||
:linenos:
|
|
||||||
:startinline: true
|
|
||||||
|
|
||||||
protected function configure(): void
|
|
||||||
$this
|
|
||||||
->addOption(
|
|
||||||
name: 'config-file',
|
|
||||||
shortcut: ['c'],
|
|
||||||
mode: InputOption::VALUE_REQUIRED,
|
|
||||||
description: 'The path to the project\'s build.yaml file',
|
|
||||||
default: 'build.yaml',
|
|
||||||
)
|
|
||||||
->addOption(
|
|
||||||
name: 'output-dir',
|
|
||||||
shortcut: ['o'],
|
|
||||||
mode: InputOption::VALUE_REQUIRED,
|
|
||||||
description: 'The directory to create files in',
|
|
||||||
default: '.',
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
.. code-block:: php
|
|
||||||
:linenos:
|
|
||||||
:startinline: true
|
|
||||||
|
|
||||||
protected function execute(InputInterface $input, OutputInterface $output): int
|
|
||||||
{
|
|
||||||
$io = new SymfonyStyle($input, $output);
|
|
||||||
|
|
||||||
$configFile = $input->getOption(name: 'config-file');
|
|
||||||
$outputDir = $input->getOption(name: 'output-dir');
|
|
||||||
}
|
|
||||||
|
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
PageBreak
|
|
||||||
|
|
||||||
.. code-block:: php
|
|
||||||
:linenos:
|
|
||||||
:startinline: true
|
|
||||||
|
|
||||||
protected function execute(InputInterface $input, OutputInterface $output): int
|
|
||||||
{
|
|
||||||
// ...
|
|
||||||
|
|
||||||
$pipelines = [
|
|
||||||
new CreateFinalConfigurationData(),
|
|
||||||
|
|
||||||
new ValidateConfigurationData(),
|
|
||||||
|
|
||||||
new CreateListOfFilesToGenerate(),
|
|
||||||
|
|
||||||
new GenerateConfigurationFiles(
|
|
||||||
$this->filesystem,
|
|
||||||
$this->twig,
|
|
||||||
$outputDir,
|
|
||||||
),
|
|
||||||
];
|
|
||||||
}
|
|
||||||
|
|
||||||
.. code-block:: php
|
|
||||||
:linenos:
|
|
||||||
:startinline: true
|
|
||||||
|
|
||||||
protected function execute(InputInterface $input, OutputInterface $output): int
|
|
||||||
{
|
|
||||||
// ...
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @var Collection<int,TemplateFile> $generatedFiles
|
|
||||||
* @var ConfigDto $configurationData
|
|
||||||
*/
|
|
||||||
[$configurationData, $generatedFiles] = (new Pipeline())
|
|
||||||
->send($configFile)
|
|
||||||
->through($pipelines)
|
|
||||||
->thenReturn();
|
|
||||||
|
|
||||||
$io->info("Building configuration for {$configurationData->name}.");
|
|
||||||
|
|
||||||
$io->write('Generated files:');
|
|
||||||
$io->listing(static::getListOfFiles(filesToGenerate: $generatedFiles)->toArray());
|
|
||||||
|
|
||||||
return Command::SUCCESS;
|
|
||||||
}
|
|
||||||
|
|
||||||
.. code-block:: php
|
|
||||||
:linenos:
|
|
||||||
:startinline: true
|
|
||||||
|
|
||||||
// CreateFinalConfigurationData.php
|
|
||||||
|
|
||||||
public function handle(string $configFile, \Closure $next) {
|
|
||||||
{
|
|
||||||
$configurationData = Yaml::parseFile(filename: $configFile);
|
|
||||||
|
|
||||||
$configurationData = array_replace_recursive(
|
|
||||||
Yaml::parseFile(filename: __DIR__ . '/../../resources/build.defaults.yaml'),
|
|
||||||
$configurationData,
|
|
||||||
);
|
|
||||||
|
|
||||||
// ...
|
|
||||||
|
|
||||||
return $next($configurationData);
|
|
||||||
}
|
|
||||||
|
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
PageBreak
|
|
||||||
|
|
||||||
.. code-block:: php
|
|
||||||
:linenos:
|
|
||||||
:startinline: true
|
|
||||||
|
|
||||||
// ValidateConfigurationData.php
|
|
||||||
|
|
||||||
public function handle(array $configurationData, \Closure $next)
|
|
||||||
{
|
|
||||||
// Convert the input to a configuration data object.
|
|
||||||
$normalizer = new ObjectNormalizer(null, new CamelCaseToSnakeCaseNameConverter());
|
|
||||||
$serializer = new Serializer([$normalizer], [new JsonEncoder()]);
|
|
||||||
|
|
||||||
$configurationDataDto = $serializer->deserialize(
|
|
||||||
json_encode($configurationData),
|
|
||||||
ConfigDto::class,
|
|
||||||
'json',
|
|
||||||
);
|
|
||||||
|
|
||||||
// ...
|
|
||||||
}
|
|
||||||
|
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
PageBreak
|
|
||||||
|
|
||||||
.. code-block:: php
|
|
||||||
:linenos:
|
|
||||||
:startinline: true
|
|
||||||
|
|
||||||
// ValidateConfigurationData.php
|
|
||||||
|
|
||||||
public function handle(array $configurationData, \Closure $next)
|
|
||||||
{
|
|
||||||
// ...
|
|
||||||
|
|
||||||
$validator = Validation::createValidatorBuilder()
|
|
||||||
->enableAnnotationMapping()
|
|
||||||
->getValidator();
|
|
||||||
$violations = $validator->validate($configurationDataDto);
|
|
||||||
|
|
||||||
if (0 < $violations->count()) {
|
|
||||||
throw new \RuntimeException('Configuration is invalid.');
|
|
||||||
}
|
|
||||||
|
|
||||||
return $next([$configurationData, $configurationDataDto]);
|
|
||||||
}
|
|
||||||
|
|
||||||
.. code-block:: php
|
|
||||||
:linenos:
|
|
||||||
:startinline: true
|
|
||||||
|
|
||||||
// ConfigDto.php
|
|
||||||
|
|
||||||
#[Assert\Collection(
|
|
||||||
allowExtraFields: false,
|
|
||||||
fields: ['docroot' => new Assert\Choice([null, 'web', 'docroot'])],
|
|
||||||
)]
|
|
||||||
public array $drupal;
|
|
||||||
|
|
||||||
#[Assert\Collection([
|
|
||||||
'ignore' => new Assert\Optional([
|
|
||||||
new Assert\All([
|
|
||||||
new Assert\Type('string'),
|
|
||||||
]),
|
|
||||||
]),
|
|
||||||
])]
|
|
||||||
public array $git;
|
|
||||||
|
|
||||||
#[Assert\Choice(choices: ['javascript', 'php', 'typescript'])]
|
|
||||||
public string $language;
|
|
||||||
|
|
||||||
#[Assert\NotBlank]
|
|
||||||
#[Assert\Type('string')]
|
|
||||||
public string $name;
|
|
||||||
|
|
||||||
#[Assert\Type('string')]
|
|
||||||
public string $projectRoot;
|
|
||||||
|
|
||||||
#[Assert\Choice(choices: [
|
|
||||||
'drupal',
|
|
||||||
'fractal',
|
|
||||||
'php-library',
|
|
||||||
'symfony',
|
|
||||||
])]
|
|
||||||
public string $type;
|
|
||||||
|
|
||||||
.. code-block:: php
|
|
||||||
:startinline: true
|
|
||||||
:linenos:
|
|
||||||
|
|
||||||
// CreateListOfFilesToGenerate.php
|
|
||||||
|
|
||||||
public function handle(array $configurationDataAndDto, \Closure $next)
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* @var ConfigDto $configDto,
|
|
||||||
* @var array<string,mixed> $configurationData
|
|
||||||
*/
|
|
||||||
[$configurationData, $configDto] = $configurationDataAndDto;
|
|
||||||
|
|
||||||
/** @var Collection<int, TemplateFile> */
|
|
||||||
$filesToGenerate = collect();
|
|
||||||
|
|
||||||
// ...
|
|
||||||
}
|
|
||||||
|
|
||||||
.. code-block:: php
|
|
||||||
:startinline: true
|
|
||||||
:linenos:
|
|
||||||
|
|
||||||
// CreateListOfFilesToGenerate.php
|
|
||||||
|
|
||||||
public function handle(array $configurationDataAndDto, \Closure $next)
|
|
||||||
{
|
|
||||||
// ...
|
|
||||||
|
|
||||||
if (!isset($configDto->php['phpunit']) || $configDto->php['phpunit'] !== false) {
|
|
||||||
|
|
||||||
$filesToGenerate->push(
|
|
||||||
new TemplateFile(
|
|
||||||
data: 'drupal/phpunit.xml.dist',
|
|
||||||
name: 'phpunit.xml.dist',
|
|
||||||
)
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
// ...
|
|
||||||
|
|
||||||
return $next([$configurationData, $configDto, $filesToGenerate]);
|
|
||||||
}
|
|
||||||
|
|
||||||
.. code-block:: php
|
|
||||||
:linenos:
|
|
||||||
:startinline: true
|
|
||||||
|
|
||||||
// GenerateConfigurationFiles.php
|
|
||||||
|
|
||||||
public function handle(array $filesToGenerateAndConfigurationData, \Closure $next)
|
|
||||||
{
|
|
||||||
// ...
|
|
||||||
|
|
||||||
$filesToGenerate->each(function(TemplateFile $templateFile) use ($configurationData): void {
|
|
||||||
if ($templateFile->path !== null) {
|
|
||||||
if (!$this->filesystem->exists($templateFile->path)) {
|
|
||||||
$this->filesystem->mkdir("{$this->outputDir}/{$templateFile->path}");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
$sourceFile = "{$templateFile->data}.twig";
|
|
||||||
|
|
||||||
$outputFile = collect([$this->outputDir, $templateFile->path, $templateFile->name])
|
|
||||||
->filter()->implode('/');
|
|
||||||
|
|
||||||
$this->filesystem->dumpFile($outputFile, $this->twig->render($sourceFile, $configurationData));
|
|
||||||
});
|
|
||||||
|
|
||||||
return $next([$configurationDataDto, $filesToGenerate]);
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
@ -1,55 +0,0 @@
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
PageBreak standardPage
|
|
||||||
|
|
||||||
What is "Build Configs"?
|
|
||||||
========================
|
|
||||||
|
|
||||||
- Command-line tool.
|
|
||||||
- Inspired by Workspace, name from the TheAltF4Stream.
|
|
||||||
- Built with Symfony.
|
|
||||||
- Creates and manages build configuration files.
|
|
||||||
- Customisable per-project.
|
|
||||||
- Drupal, PHP library, Fractal (TypeScript).
|
|
||||||
- "Sprint zero in a box".
|
|
||||||
|
|
||||||
What Problem Does it Solve?
|
|
||||||
===========================
|
|
||||||
|
|
||||||
- I work on multiple similar projects.
|
|
||||||
- Different configuration values - e.g. ``web`` vs. ``docroot``.
|
|
||||||
- Different versions of PHP, node, etc.
|
|
||||||
- Different Docker Compose (``fpm`` vs. ``apache`` images).
|
|
||||||
- Each project was separate.
|
|
||||||
- Difficult to add new features and fix bugs across all projects.
|
|
||||||
- Inconsistencies across projects.
|
|
||||||
- Out of the box solutions didn't seem like the best fit.
|
|
||||||
|
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
TextAnnotation "Multiple projects with similar but different configurations."
|
|
||||||
TextAnnotation ""
|
|
||||||
TextAnnotation "Out of the box solutions tend to focus on one technology, could be hard to customise, and usually had more than I nedeed."
|
|
||||||
TextAnnotation ""
|
|
||||||
TextAnnotation "Start small and build up instead of removing additional things."
|
|
||||||
TextAnnotation ""
|
|
||||||
TextAnnotation "More opportunities to learn the underlying technologies."
|
|
||||||
|
|
||||||
How Does it Work?
|
|
||||||
=================
|
|
||||||
|
|
||||||
.. image:: diagram.png
|
|
||||||
:width: 18cm
|
|
||||||
|
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
TextAnnotation "Canonical templates and project-specific configuration goes in, templates come out."
|
|
||||||
|
|
||||||
What Files Does it Generate?
|
|
||||||
============================
|
|
||||||
|
|
||||||
- Dockerfile, Docker Compose, Nix Flake, php.ini, NGINX default.conf.
|
|
||||||
- ``run`` file.
|
|
||||||
- PHPUnit, PHPCS, PHPStan.
|
|
||||||
- GitHub Actions workflow.
|
|
||||||
- Git hooks.
|
|
||||||
|
|
@ -1,117 +0,0 @@
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
PageBreak standardPage
|
|
||||||
|
|
||||||
Dockerfile.twig
|
|
||||||
===============
|
|
||||||
|
|
||||||
.. code-block:: twig
|
|
||||||
:linenos:
|
|
||||||
|
|
||||||
FROM php:{{ php.version }} AS base
|
|
||||||
|
|
||||||
COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
|
|
||||||
RUN which composer && composer -V
|
|
||||||
|
|
||||||
ARG DOCKER_UID=1000
|
|
||||||
ENV DOCKER_UID="${DOCKER_UID}"
|
|
||||||
|
|
||||||
WORKDIR {{ project_root }}
|
|
||||||
|
|
||||||
RUN adduser --disabled-password --uid "${DOCKER_UID}" app \
|
|
||||||
&& chown app:app -R {{ project_root }}
|
|
||||||
|
|
||||||
Dockerfile.twig
|
|
||||||
===============
|
|
||||||
|
|
||||||
.. code-block:: twig
|
|
||||||
:linenos:
|
|
||||||
|
|
||||||
{% if dockerfile.stages.build.extensions.install %}
|
|
||||||
RUN docker-php-ext-install
|
|
||||||
{{ dockerfile.stages.build.extensions.install|join(' ') }}
|
|
||||||
{% endif %}
|
|
||||||
|
|
||||||
COPY --chown=app:app phpunit.xml* ./
|
|
||||||
|
|
||||||
{% if dockerfile.stages.build.extra_files %}
|
|
||||||
COPY --chown=app:app {{ dockerfile.stages.build.extra_files|join(" ") }} ./
|
|
||||||
{% endif %}
|
|
||||||
|
|
||||||
{% for directory in dockerfile.stages.build.extra_directories %}
|
|
||||||
COPY --chown=app:app {{ directory }} {{ directory }}
|
|
||||||
{% endfor %}
|
|
||||||
|
|
||||||
docker-compose.yaml.twig
|
|
||||||
========================
|
|
||||||
|
|
||||||
.. code-block:: twig
|
|
||||||
:linenos:
|
|
||||||
|
|
||||||
services:
|
|
||||||
{% if "web" in dockerCompose.services %}
|
|
||||||
web:
|
|
||||||
<<: [*default-proxy, *default-app]
|
|
||||||
build:
|
|
||||||
context: .
|
|
||||||
target: web
|
|
||||||
depends_on:
|
|
||||||
- php
|
|
||||||
profiles: [web]
|
|
||||||
{% endif %}
|
|
||||||
|
|
||||||
phpstan.neon.dist.twig
|
|
||||||
======================
|
|
||||||
|
|
||||||
.. code-block:: twig
|
|
||||||
:linenos:
|
|
||||||
|
|
||||||
parameters:
|
|
||||||
level: {{ php.phpstan.level }}
|
|
||||||
excludePaths:
|
|
||||||
- *Test.php
|
|
||||||
- *TestBase.php
|
|
||||||
paths:
|
|
||||||
{% for path in php.phpstan.paths -%}
|
|
||||||
- {{ path }}
|
|
||||||
{%- endfor %}
|
|
||||||
|
|
||||||
{% if php.phpstan.baseline %}
|
|
||||||
includes:
|
|
||||||
- phpstan-baseline.neon
|
|
||||||
{% endif %}
|
|
||||||
|
|
||||||
phpunit.xml.dist.twig
|
|
||||||
=====================
|
|
||||||
|
|
||||||
.. code-block:: twig
|
|
||||||
:linenos:
|
|
||||||
|
|
||||||
<phpunit
|
|
||||||
beStrictAboutChangesToGlobalState="true"
|
|
||||||
beStrictAboutOutputDuringTests="false"
|
|
||||||
beStrictAboutTestsThatDoNotTestAnything="true"
|
|
||||||
bootstrap="{{ drupal.docroot }}/core/tests/bootstrap.php"
|
|
||||||
cacheResult="false"
|
|
||||||
colors="true"
|
|
||||||
failOnWarning="true"
|
|
||||||
printerClass="\Drupal\Tests\Listeners\HtmlOutputPrinter"
|
|
||||||
>
|
|
||||||
|
|
||||||
phpunit.xml.dist.twig
|
|
||||||
=====================
|
|
||||||
|
|
||||||
.. code-block:: twig
|
|
||||||
:linenos:
|
|
||||||
|
|
||||||
<testsuites>
|
|
||||||
<testsuite name="functional">
|
|
||||||
<directory>./{{ drupal.docroot }}/modules/custom/**/tests/**/Functional</directory>
|
|
||||||
</testsuite>
|
|
||||||
<testsuite name="kernel">
|
|
||||||
<directory>./{{ drupal.docroot }}/modules/custom/**/tests/**/Kernel</directory>
|
|
||||||
</testsuite>
|
|
||||||
<testsuite name="unit">
|
|
||||||
<directory>./{{ drupal.docroot }}/modules/custom/**/tests/**/Unit</directory>
|
|
||||||
</testsuite>
|
|
||||||
</testsuites>
|
|
||||||
|
|
@ -1,29 +0,0 @@
|
||||||
.. footer:: @opdavies
|
|
||||||
|
|
||||||
Building "Build Configs"
|
|
||||||
########################
|
|
||||||
|
|
||||||
.. class:: titleslideinfo
|
|
||||||
|
|
||||||
Oliver Davies (@opdavies)
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
||||||
.. class:: titleslideinfo
|
|
||||||
|
|
||||||
https://opdavi.es/bco
|
|
||||||
|
|
||||||
.. include:: ./sections/intro.rst
|
|
||||||
.. include:: ./sections/example.rst
|
|
||||||
.. include:: ./sections/customisation.rst
|
|
||||||
.. include:: ./sections/templates.rst
|
|
||||||
|
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
PageBreak titlePage
|
|
||||||
|
|
||||||
.. class:: centredtitle
|
|
||||||
|
|
||||||
Demo
|
|
||||||
|
|
||||||
.. include:: ./sections/conclusion.rst
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
Building and presenting slide decks with rst2pdf
|
|
||||||
################################################
|
|
||||||
|
|
||||||
https://www.oliverdavies.uk/talks/building-presenting-slide-decks-rst2pdf
|
|
||||||
|
|
@ -1,12 +0,0 @@
|
||||||
rst2pdf slides.rst
|
|
||||||
|
|
||||||
|
|
||||||
rst2pdf slides.rst --break-level 1 --stylesheets main
|
|
||||||
|
|
||||||
|
|
||||||
rst2pdf slides.rst \
|
|
||||||
--output slides.pdf \
|
|
||||||
--stylesheets main \
|
|
||||||
--break-level 1 \
|
|
||||||
--fit-background-mode scale \
|
|
||||||
--extension-module preprocess
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
.. code-block:: javascript
|
|
||||||
:include: code/additional-config-options.txt
|
|
||||||
:hl_lines: 2 3 4
|
|
||||||
:linenos:
|
|
||||||
|
|
@ -1 +0,0 @@
|
||||||
.. include:: sections/intro.rst
|
|
||||||
|
|
@ -1,3 +0,0 @@
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
PageBreak standardPage
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
pageTemplates:
|
|
||||||
standardPage:
|
|
||||||
frames: []
|
|
||||||
[3%, 3%, 92%, 92%]
|
|
||||||
showFooter: true
|
|
||||||
showHeader: false
|
|
||||||
|
|
@ -1,29 +0,0 @@
|
||||||
linkColor: #24608a
|
|
||||||
|
|
||||||
styles:
|
|
||||||
normal:
|
|
||||||
fontSize: 24
|
|
||||||
leading: 32
|
|
||||||
textColor: #383745
|
|
||||||
|
|
||||||
bodytext:
|
|
||||||
alignment: TA_LEFT
|
|
||||||
|
|
||||||
heading:
|
|
||||||
fontSize: 20
|
|
||||||
spaceAfter: 16
|
|
||||||
textColor: #24608a
|
|
||||||
|
|
||||||
title:
|
|
||||||
fontSize: 300%
|
|
||||||
parent: heading
|
|
||||||
textColor: white
|
|
||||||
|
|
||||||
bullet-list:
|
|
||||||
commands: []
|
|
||||||
[LEFTPADDING, [0, 0], [1, -1], 10]
|
|
||||||
[RIGHTPADDING, [0, 0], [1, -1], 0]
|
|
||||||
[VALIGN, [0, 0], [-1, -1], TOP]
|
|
||||||
colWidths: ["20", null]
|
|
||||||
textColor: #aaaaaa
|
|
||||||
|
|
||||||
|
|
@ -1,14 +0,0 @@
|
||||||
Building and presenting slide decks with rst2pdf
|
|
||||||
################################################
|
|
||||||
|
|
||||||
.. class:: titleslideinfo
|
|
||||||
|
|
||||||
Oliver Davies (@opdavies)
|
|
||||||
|
|
||||||
|
|
||||||
What is rst2pdf?
|
|
||||||
================
|
|
||||||
|
|
||||||
* "Use a text editor. Make a PDF."
|
|
||||||
* reStructuredText to PDF
|
|
||||||
* Each slide is a page
|
|
||||||
|
|
@ -1,14 +0,0 @@
|
||||||
.. image:: images/editing.png
|
|
||||||
:width: 20cm
|
|
||||||
|
|
||||||
|
|
||||||
.. code-block:: php
|
|
||||||
:startinline: true
|
|
||||||
:linenos:
|
|
||||||
|
|
||||||
echo 'Hello world!';
|
|
||||||
|
|
||||||
|
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
TextAnnotation "This is a speaker note."
|
|
||||||
|
|
@ -1,8 +0,0 @@
|
||||||
nodemon --ext rst,style,txt --exec "
|
|
||||||
rst2pdf slides.rst \
|
|
||||||
--output slides.pdf \
|
|
||||||
--stylesheets main \
|
|
||||||
--break-level 1 \
|
|
||||||
--fit-background-mode scale \
|
|
||||||
--extension-module preprocess
|
|
||||||
"
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 225 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 71 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 119 KiB |
|
|
@ -1,169 +0,0 @@
|
||||||
.. footer:: @opdavies
|
|
||||||
|
|
||||||
Building and presenting slide decks with rst2pdf
|
|
||||||
################################################
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
||||||
.. class:: titleslideinfo
|
|
||||||
|
|
||||||
Oliver Davies (@opdavies)
|
|
||||||
|
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
TextAnnotation "Gave my first talk in 2012."
|
|
||||||
TextAnnotation "A talk about a tool (rst2pdf) that I've been using for the last couple of talks."
|
|
||||||
|
|
||||||
.. page:: standardPage
|
|
||||||
|
|
||||||
What have I used before?
|
|
||||||
========================
|
|
||||||
|
|
||||||
* **UI based:** Keynote, Google Slides, slides.com
|
|
||||||
* **HTML/JavaScript:** reveal.js
|
|
||||||
* **Markdown:** Deckset, Marp, reveal-md
|
|
||||||
|
|
||||||
What is rst2pdf?
|
|
||||||
================
|
|
||||||
|
|
||||||
* "Use a text editor. Make a PDF."
|
|
||||||
* reStructuredText to PDF
|
|
||||||
* Each slide is a page
|
|
||||||
* Page templates for layouts
|
|
||||||
* Not just for slide decks
|
|
||||||
* Table of contents, page numbers, headers, footers
|
|
||||||
|
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
TextAnnotation "Use the tools you're familiar with."
|
|
||||||
TextAnnotation "Similar to Markdown."
|
|
||||||
TextAnnotation "Primarily used for technical documentation within the Python community."
|
|
||||||
TextAnnotation "Now maintained by PHPers Rob Allen and Lorna Jane Mitchell."
|
|
||||||
TextAnnotation "Breaks at titles automatically, or you can add manual page breaks."
|
|
||||||
|
|
||||||
Advantages
|
|
||||||
==========
|
|
||||||
|
|
||||||
* Easy to start a new presentation, or update an existing one
|
|
||||||
* Version controllable
|
|
||||||
* Portable
|
|
||||||
* Content is searchable
|
|
||||||
* Easy to re-use content and/or styling
|
|
||||||
* Slides uploaded to SpeakerDeck straight away
|
|
||||||
|
|
||||||
.. page:: imagePage
|
|
||||||
|
|
||||||
.. image:: images/editing.png
|
|
||||||
:width: 23cm
|
|
||||||
|
|
||||||
.. page:: standardPage
|
|
||||||
|
|
||||||
Useful reStructuredText
|
|
||||||
=======================
|
|
||||||
|
|
||||||
.. code-block:: rst
|
|
||||||
:include: code/useful-rst-1.txt
|
|
||||||
:linenos:
|
|
||||||
|
|
||||||
Useful reStructuredText
|
|
||||||
=======================
|
|
||||||
|
|
||||||
.. code-block:: rst
|
|
||||||
:include: code/useful-rst-2.txt
|
|
||||||
:linenos:
|
|
||||||
|
|
||||||
Page Templates
|
|
||||||
==============
|
|
||||||
|
|
||||||
main.style:
|
|
||||||
|
|
||||||
.. code-block:: yaml
|
|
||||||
:include: code/page-templates-style.txt
|
|
||||||
|
|
||||||
slides.rst:
|
|
||||||
|
|
||||||
.. code-block:: rst
|
|
||||||
:include: code/page-templates-rst.txt
|
|
||||||
|
|
||||||
Keeping things organised
|
|
||||||
========================
|
|
||||||
|
|
||||||
Split slides into different sections:
|
|
||||||
|
|
||||||
.. code-block:: rst
|
|
||||||
:include: code/includes-sections.txt
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
||||||
Including code snippets from separate files:
|
|
||||||
|
|
||||||
.. code-block:: rst
|
|
||||||
:include: code/includes-code.txt
|
|
||||||
|
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
TextAnnotation "Includes!"
|
|
||||||
|
|
||||||
Styling
|
|
||||||
=======
|
|
||||||
|
|
||||||
.. code-block:: yaml
|
|
||||||
:include: code/styling.txt
|
|
||||||
:linenos:
|
|
||||||
|
|
||||||
Building
|
|
||||||
========
|
|
||||||
|
|
||||||
.. code-block::
|
|
||||||
:include: code/building.txt
|
|
||||||
|
|
||||||
Watching
|
|
||||||
========
|
|
||||||
|
|
||||||
Re-compiling when something changes.
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
:include: code/watching.txt
|
|
||||||
|
|
||||||
Presenting
|
|
||||||
==========
|
|
||||||
|
|
||||||
``pdfpc`` - PDF presenter console
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
||||||
.. code-block::
|
|
||||||
|
|
||||||
pdfpc slides.pdf
|
|
||||||
|
|
||||||
.. page:: imagePage
|
|
||||||
|
|
||||||
.. image:: images/pdfpc-1.png
|
|
||||||
:width: 23cm
|
|
||||||
|
|
||||||
.. raw:: pdf
|
|
||||||
|
|
||||||
PageBreak
|
|
||||||
|
|
||||||
.. image:: images/pdfpc-2.png
|
|
||||||
:width: 23cm
|
|
||||||
|
|
||||||
.. page:: standardPage
|
|
||||||
|
|
||||||
Thanks!
|
|
||||||
=======
|
|
||||||
|
|
||||||
References:
|
|
||||||
|
|
||||||
* https://rst2pdf.org
|
|
||||||
* https://github.com/rst2pdf/rst2pdf
|
|
||||||
* https://github.com/opdavies/talks
|
|
||||||
* https://oliverdavies.link/lorna-rst2pdf-talk
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
||||||
Me:
|
|
||||||
|
|
||||||
* https://www.oliverdavies.uk
|
|
||||||
|
|
@ -1 +0,0 @@
|
||||||
use flake
|
|
||||||
10
building-static-websites-sculpin/demo/.gitignore
vendored
10
building-static-websites-sculpin/demo/.gitignore
vendored
|
|
@ -1,10 +0,0 @@
|
||||||
/output_*/
|
|
||||||
|
|
||||||
/.phpunit.cache
|
|
||||||
/.phpunit.result.cache
|
|
||||||
|
|
||||||
# Nix
|
|
||||||
/.direnv/
|
|
||||||
|
|
||||||
# Composer
|
|
||||||
/vendor/
|
|
||||||
|
|
@ -1,12 +0,0 @@
|
||||||
#!/usr/bin/env bash
|
|
||||||
|
|
||||||
export PATH="${PATH}:./vendor"
|
|
||||||
|
|
||||||
tmux new-window -dn shell
|
|
||||||
tmux new-window -dn server
|
|
||||||
|
|
||||||
tmux send-keys -t server "sculpin generate --server --watch" Enter
|
|
||||||
|
|
||||||
xdg-open http://localhost:8000
|
|
||||||
|
|
||||||
nvim
|
|
||||||
|
|
@ -1,7 +0,0 @@
|
||||||
sculpin_content_types:
|
|
||||||
# speakers:
|
|
||||||
# permalink: /speakers/:basename/
|
|
||||||
# talks:
|
|
||||||
# permalink: /talks/:basename/
|
|
||||||
posts:
|
|
||||||
enabled: false
|
|
||||||
|
|
@ -1,2 +0,0 @@
|
||||||
name: 'My New Sculpin Site'
|
|
||||||
locale: en
|
|
||||||
|
|
@ -1,2 +0,0 @@
|
||||||
imports:
|
|
||||||
- sculpin_site.yml
|
|
||||||
|
|
@ -1,7 +0,0 @@
|
||||||
#!/usr/bin/env bash
|
|
||||||
|
|
||||||
set -euo pipefail
|
|
||||||
|
|
||||||
export PATH="$PATH:./vendor/bin"
|
|
||||||
|
|
||||||
sculpin generate "$@"
|
|
||||||
|
|
@ -1,3 +0,0 @@
|
||||||
---
|
|
||||||
name: demo
|
|
||||||
template: php-sculpin
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
#!/usr/bin/env bash
|
|
||||||
|
|
||||||
set -euo pipefail
|
|
||||||
|
|
||||||
rm -rfv output_* vendor
|
|
||||||
|
|
@ -1,10 +0,0 @@
|
||||||
{
|
|
||||||
"require": {
|
|
||||||
"sculpin/sculpin": "^3.0"
|
|
||||||
},
|
|
||||||
"config": {
|
|
||||||
"allow-plugins": {
|
|
||||||
"sculpin/sculpin-theme-composer-plugin": true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
3607
building-static-websites-sculpin/demo/composer.lock
generated
3607
building-static-websites-sculpin/demo/composer.lock
generated
File diff suppressed because it is too large
Load diff
27
building-static-websites-sculpin/demo/flake.lock
generated
27
building-static-websites-sculpin/demo/flake.lock
generated
|
|
@ -1,27 +0,0 @@
|
||||||
{
|
|
||||||
"nodes": {
|
|
||||||
"nixpkgs": {
|
|
||||||
"locked": {
|
|
||||||
"lastModified": 1740828860,
|
|
||||||
"narHash": "sha256-cjbHI+zUzK5CPsQZqMhE3npTyYFt9tJ3+ohcfaOF/WM=",
|
|
||||||
"owner": "nixos",
|
|
||||||
"repo": "nixpkgs",
|
|
||||||
"rev": "303bd8071377433a2d8f76e684ec773d70c5b642",
|
|
||||||
"type": "github"
|
|
||||||
},
|
|
||||||
"original": {
|
|
||||||
"owner": "nixos",
|
|
||||||
"ref": "nixos-unstable",
|
|
||||||
"repo": "nixpkgs",
|
|
||||||
"type": "github"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"root": {
|
|
||||||
"inputs": {
|
|
||||||
"nixpkgs": "nixpkgs"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"root": "root",
|
|
||||||
"version": 7
|
|
||||||
}
|
|
||||||
|
|
@ -1,26 +0,0 @@
|
||||||
{
|
|
||||||
inputs.nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
|
|
||||||
|
|
||||||
outputs = inputs:
|
|
||||||
let
|
|
||||||
system = "x86_64-linux";
|
|
||||||
pkgs = import inputs.nixpkgs { inherit system; };
|
|
||||||
in
|
|
||||||
{
|
|
||||||
devShells.${system}.default =
|
|
||||||
with pkgs;
|
|
||||||
mkShell {
|
|
||||||
buildInputs = [
|
|
||||||
nodePackages.browser-sync
|
|
||||||
|
|
||||||
(php83.buildEnv {
|
|
||||||
extraConfig = ''
|
|
||||||
error_reporting = E_ALL & ~E_DEPRECATED & ~E_USER_DEPRECATED
|
|
||||||
'';
|
|
||||||
})
|
|
||||||
|
|
||||||
php83Packages.composer
|
|
||||||
];
|
|
||||||
};
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
@ -1,19 +0,0 @@
|
||||||
<!DOCTYPE html>
|
|
||||||
<html lang="{{ site.locale|default('en') }}">
|
|
||||||
<head>
|
|
||||||
<meta charset="UTF-8">
|
|
||||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
|
||||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
||||||
<title>{{ site.name|default('Sculpin Skeleton') }}</title>
|
|
||||||
<link rel="stylesheet" href="/css/styles.css">
|
|
||||||
</head>
|
|
||||||
<body>
|
|
||||||
<div class="container">
|
|
||||||
{% block content_wrapper %}
|
|
||||||
<h1>{{ page.title }}</h1>
|
|
||||||
|
|
||||||
{% block content %}{% endblock %}
|
|
||||||
{% endblock %}
|
|
||||||
</div>
|
|
||||||
</body>
|
|
||||||
</html>
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
{% extends 'base' %}
|
|
||||||
|
|
||||||
{% block content_wrapper %}
|
|
||||||
<h1>{{ page.name }}</h1>
|
|
||||||
{% endblock %}
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
{% extends 'base' %}
|
|
||||||
|
|
||||||
{% block content_wrapper %}
|
|
||||||
<h1>{{ page.title }}</h1>
|
|
||||||
{% endblock %}
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
---
|
|
||||||
name: Ciaran McNulty
|
|
||||||
imageUrl: /images/ciaran.jpg
|
|
||||||
---
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
---
|
|
||||||
name: Dan Leech
|
|
||||||
imageUrl: /images/highres_257208698.jpeg
|
|
||||||
---
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
name: Dave Liddament
|
|
||||||
imageUrl: /images/highres_203797572.jpeg
|
|
||||||
---
|
|
||||||
|
|
||||||
Director and Developer at Lamp Bristol. PHP, Java and Python software developer.
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
---
|
|
||||||
name: Derick Rethans
|
|
||||||
imageUrl: /images/highres_276685584.jpeg
|
|
||||||
---
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
name: James Titcumb
|
|
||||||
imageUrl: /images/highres_134740252.jpeg
|
|
||||||
---
|
|
||||||
|
|
||||||
James is the founder of the UK based PHP Hampshire user group, a Zend Certified Engineer and Development Manager at Protected.co.uk.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
name: Mike Karthauser
|
|
||||||
imageUrl: /images/highres_80709042.jpeg
|
|
||||||
---
|
|
||||||
|
|
||||||
Dev since '98. PHP since '03.
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
---
|
|
||||||
name: Naomi Gotts
|
|
||||||
imageUrl: /images/highres_311941362.jpeg
|
|
||||||
---
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
---
|
|
||||||
name: Nigel Dunn
|
|
||||||
imageUrl: /images/highres_131268052.jpeg
|
|
||||||
---
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
name: Oliver Davies
|
|
||||||
imageUrl: /images/highres_317091329.jpeg
|
|
||||||
---
|
|
||||||
|
|
||||||
Full Stack Software Consultant. Drupal and PHP expert.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
name: Rob Allen
|
|
||||||
imageUrl: /images/highres_312615346.jpeg
|
|
||||||
---
|
|
||||||
|
|
||||||
PHP developer from Worcester.
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
name: Robin Hodson
|
|
||||||
imageUrl: /images/highres_243972257.jpeg
|
|
||||||
---
|
|
||||||
|
|
||||||
Ready to look for coding/hardware work post-lockdown, now largely recovered from stressful experiences. Accepted work from the government in September/October; currently realigning goals plus getting things I've been working on a bit more tangible.
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
---
|
|
||||||
name: Ryan Lee
|
|
||||||
imageUrl: /images/highres_273691940.jpeg
|
|
||||||
---
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
title: Behaviour Driven Development (BDD) in Practice
|
|
||||||
date: 2022-09-14
|
|
||||||
speakers:
|
|
||||||
- Ciaran McNulty
|
|
||||||
---
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
title: Building "Build Configs"
|
|
||||||
date: 2023-11-08
|
|
||||||
speakers:
|
|
||||||
- Oliver Davies
|
|
||||||
---
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
title: Introducing Domain Driven Design
|
|
||||||
date: 2024-01-10
|
|
||||||
speakers:
|
|
||||||
- Rob Allen
|
|
||||||
---
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
title: 'FPGA^2: An open-source FPGA'
|
|
||||||
date: 2024-02-14
|
|
||||||
speakers:
|
|
||||||
- Robin Hodson
|
|
||||||
---
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
title: Go for PHP
|
|
||||||
date: 2023-02-08
|
|
||||||
speakers:
|
|
||||||
- Dan Leech
|
|
||||||
---
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
title: What's new in PHP 8.*
|
|
||||||
date: 2023-02-11
|
|
||||||
speakers:
|
|
||||||
- Derick Rethans
|
|
||||||
---
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
title: Building Static Websites with PHP and Sculpin
|
|
||||||
date: 2024-02-14
|
|
||||||
speakers:
|
|
||||||
- Oliver Davies
|
|
||||||
---
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
title: What is TDD and why should I care?
|
|
||||||
date: 2023-07-12
|
|
||||||
speakers:
|
|
||||||
- Naomi Gotts
|
|
||||||
---
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
title: Terraform from a dev’s perspective
|
|
||||||
date: 2023-10-11
|
|
||||||
speakers:
|
|
||||||
- Nigel Dunn
|
|
||||||
---
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
title: Testing Legacy
|
|
||||||
date: 2023-11-08
|
|
||||||
speakers:
|
|
||||||
- Mike Karthauser
|
|
||||||
---
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
title: Building Better TUIs (with PHP)
|
|
||||||
date: 2023-11-08
|
|
||||||
speakers:
|
|
||||||
- Dan Leech
|
|
||||||
---
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
title: Thoughts on Ubiquitous Language
|
|
||||||
date: 2023-11-08
|
|
||||||
speakers:
|
|
||||||
- Rob Allen
|
|
||||||
---
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
.container {
|
|
||||||
margin: 0 auto;
|
|
||||||
max-width: 768px;
|
|
||||||
padding: 0 1rem;
|
|
||||||
}
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 52 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 9.5 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 32 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 1.7 MiB |
Binary file not shown.
|
Before Width: | Height: | Size: 41 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 758 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 49 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 154 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 24 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 794 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 22 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 7.2 KiB |
|
|
@ -1,4 +0,0 @@
|
||||||
---
|
|
||||||
layout: base
|
|
||||||
title: Hello, World!
|
|
||||||
---
|
|
||||||
|
|
@ -1,7 +0,0 @@
|
||||||
#!/usr/bin/env bash
|
|
||||||
|
|
||||||
set -euo pipefail
|
|
||||||
|
|
||||||
export PATH="$PATH:./vendor/bin"
|
|
||||||
|
|
||||||
sculpin generate --server --watch "$@"
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
Building static websites with Sculpin
|
|
||||||
#####################################
|
|
||||||
|
|
||||||
https://www.oliverdavies.uk/talks/building-static-websites-sculpin
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
---
|
|
||||||
name: oliverdavies.uk
|
|
||||||
menu_links:
|
|
||||||
- { title: Home, href: / }
|
|
||||||
- { title: About, href: /about }
|
|
||||||
|
|
@ -1,10 +0,0 @@
|
||||||
---
|
|
||||||
title: My Daily Email Archive
|
|
||||||
layout: default
|
|
||||||
use:
|
|
||||||
- daily_email
|
|
||||||
---
|
|
||||||
|
|
||||||
{% for email in data.daily_emails %}
|
|
||||||
<p>{{ email.title }}</p>
|
|
||||||
{% endfor %}
|
|
||||||
|
|
@ -1,12 +0,0 @@
|
||||||
---
|
|
||||||
...
|
|
||||||
testimonials:
|
|
||||||
- { name: ..., role: ..., text: ..., url: ... }
|
|
||||||
- { name: ..., role: ..., text: ..., url: ... }
|
|
||||||
- { name: ..., role: ..., text: ..., url: ... }
|
|
||||||
---
|
|
||||||
|
|
||||||
{% for testimonial in page.testimonials %}
|
|
||||||
<h2>{{ testimonial.name }} - {{ testimonial.role }}</h2>
|
|
||||||
<p>{{ testimonial.text }}</p>
|
|
||||||
{% endfor %}
|
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
---
|
|
||||||
layout: post
|
|
||||||
title: New blog post
|
|
||||||
draft: yes
|
|
||||||
---
|
|
||||||
|
|
@ -1,9 +0,0 @@
|
||||||
<!DOCTYPE html>
|
|
||||||
<html>
|
|
||||||
<head>
|
|
||||||
<title>Hello!</title>
|
|
||||||
</head>
|
|
||||||
<body>
|
|
||||||
<p>Hello, World!</p>
|
|
||||||
</body>
|
|
||||||
</html>
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
---
|
|
||||||
layout: default
|
|
||||||
title: Hello!
|
|
||||||
---
|
|
||||||
|
|
||||||
Hello, World!
|
|
||||||
|
|
@ -1,11 +0,0 @@
|
||||||
{# source/_layouts/base.html.twig #}
|
|
||||||
|
|
||||||
<!DOCTYPE html>
|
|
||||||
<html lang="{{ site.locale|default('en') }}">
|
|
||||||
<head>
|
|
||||||
<title>{{ site.name|default('Sculpin Skeleton') }}</title>
|
|
||||||
</head>
|
|
||||||
<body>
|
|
||||||
{% block body %}{% endblock %}
|
|
||||||
</body>
|
|
||||||
</html>
|
|
||||||
|
|
@ -1,7 +0,0 @@
|
||||||
{# source/_layouts/page.html.twig #}
|
|
||||||
|
|
||||||
{% extends 'base' %}
|
|
||||||
|
|
||||||
{% block body %}
|
|
||||||
{% block content %}{% endblock %}
|
|
||||||
{% endblock %}
|
|
||||||
|
|
@ -1,13 +0,0 @@
|
||||||
app/
|
|
||||||
config/
|
|
||||||
sculpin_kernel.yml
|
|
||||||
sculpin_site.yml
|
|
||||||
composer.json
|
|
||||||
composer.lock
|
|
||||||
output_dev/
|
|
||||||
output_prod/
|
|
||||||
source/
|
|
||||||
_includes/
|
|
||||||
_templates/
|
|
||||||
index.md
|
|
||||||
vendor/
|
|
||||||
|
|
@ -1,8 +0,0 @@
|
||||||
{{ 'today' }}
|
|
||||||
|
|
||||||
{{ 'today'|date }}
|
|
||||||
|
|
||||||
{{ 'today'|date('Y') }}
|
|
||||||
|
|
||||||
{{ 'today'|date('Y') - 2007 }} # 18 (years of experience)
|
|
||||||
|
|
||||||
|
|
@ -1,24 +0,0 @@
|
||||||
---
|
|
||||||
title: Building Static Websites with Sculpin
|
|
||||||
events:
|
|
||||||
- name: PHP Berkshire
|
|
||||||
date: 2024-08-28
|
|
||||||
location: Reading, UK
|
|
||||||
url: https://www.meetup.com/php-berkshire/events/301850284
|
|
||||||
- name: BrumPHP
|
|
||||||
date: 2024-05-23
|
|
||||||
location: Birmingham, UK
|
|
||||||
url: https://www.eventbrite.com/e/brumphp-23rd-may-2024-tickets-803037766577
|
|
||||||
---
|
|
||||||
// end yaml
|
|
||||||
|
|
||||||
// start twig
|
|
||||||
{% set talkCount = 0 %}
|
|
||||||
|
|
||||||
{% for talk in data.talks %}
|
|
||||||
{% for event in talk.events if 'today'|date('U') >= event.date|date('U') %}
|
|
||||||
{% set talkCount = talkCount + 1 %}
|
|
||||||
{% endfor %}
|
|
||||||
{% endfor %}
|
|
||||||
|
|
||||||
<p>I have given {{ talkCount }} talks.</p>
|
|
||||||
|
|
@ -1,15 +0,0 @@
|
||||||
{% set talks = site.talks|filter(talk => talk.speaker == page.name) %}
|
|
||||||
|
|
||||||
{% if talks is not empty %}
|
|
||||||
<section>
|
|
||||||
<h2>Talks by {{ page.name }}</h2>
|
|
||||||
|
|
||||||
<div>
|
|
||||||
<ul>
|
|
||||||
{% for talk in talks %}
|
|
||||||
<li><a href="#0">{{ talk.title }}</a></li>
|
|
||||||
{% endfor %}
|
|
||||||
</ul>
|
|
||||||
</div>
|
|
||||||
</section>
|
|
||||||
{% endif %}
|
|
||||||
|
|
@ -1,8 +0,0 @@
|
||||||
- Adding a new page (`/talks`)
|
|
||||||
- Adding a new menu link
|
|
||||||
- Adding a new content type (talks)
|
|
||||||
- Add a new talk
|
|
||||||
- Show how to use page-level variables, adding events to a talk
|
|
||||||
- Adding the talks page to the menu
|
|
||||||
- Active menu link styling?
|
|
||||||
- Generating a production version of the site
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 12 KiB |
Some files were not shown because too many files have changed in this diff Show more
Loading…
Add table
Add a link
Reference in a new issue