mraible / angular-book

The Angular Mini-Book

Howdy, folks! 🤠

       

• 🔭 I'm currently working on finding my next gig. See my funemployment story and resume.
• 💬 Ask me about Java, Spring Boot, JHipster, Angular, or OAuth/OIDC.
• 😄 Pronouns: He/him.
• ⚡ Fun fact: I grew up without electricity or running water for 16 years.

   

Languages and Tools

My GitHub Stats

angular-book's Issues

Fix emoji rendering

For example, in the first chapter:

When you see errors happen, make sure to keep reading. 🙂

Here's an Asciidoctor issue that might help: asciidoctor/asciidoctor-pdf#323

Change `master` to `main` branch

Check out your `master` branch and create a new `netlify` one.

It might be necessary to show users how to set their default to main.

Investigate Knative warning

Running the following:

kubectl apply -f - <<EOF
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: pgdata
  annotations:
    volume.alpha.kubernetes.io/storage-class: default
spec:
  accessModes: [ReadWriteOnce]
  resources:
    requests:
      storage: 1Gi
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: postgres
spec:
  replicas: 1
  selector:
    matchLabels:
      service: postgres
  template:
    metadata:
      labels:
        service: postgres
    spec:
      containers:
        - name: postgres
          image: postgres:15.2
          ports:
            - containerPort: 5432
          env:
            - name: POSTGRES_DB
              value: bootiful-angular
            - name: POSTGRES_USER
              value: bootiful-angular
            - name: POSTGRES_PASSWORD
              value: $DB_PASSWORD
          volumeMounts:
            - mountPath: /var/lib/postgresql/data
              name: pgdata
              subPath: data
      volumes:
        - name: pgdata
          persistentVolumeClaim:
            claimName: pgdata
---
apiVersion: v1
kind: Service
metadata:
  name: pgservice
spec:
  ports:
  - port: 5432
    name: pgservice
  clusterIP: None
  selector:
    service: postgres
---
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: bootiful-angular
spec:
  template:
    spec:
      containers:
        - image: $DOCKER_USERNAME/bootiful-angular
          env:
          - name: SPRING_DATASOURCE_URL
            value: jdbc:postgresql://pgservice:5432/bootiful-angular
          - name: SPRING_DATASOURCE_USERNAME
            value: bootiful-angular
          - name: SPRING_DATASOURCE_PASSWORD
            value: $DB_PASSWORD
          - name: OKTA_OAUTH2_ISSUER
            value: $OKTA_ISSUER
          - name: OKTA_OAUTH2_CLIENT_ID
            value: $OKTA_CLIENT_ID
          - name: OKTA_OAUTH2_CLIENT_SECRET
            value: $OKTA_CLIENT_SECRET
          - name: OKTA_OAUTH2_AUDIENCE
            value: $OKTA_AUDIENCE
EOF

Results in the following, but still works.

Warning: Kubernetes default value is insecure, Knative may default this to secure in a future release: 
spec.template.spec.containers[0].securityContext.allowPrivilegeEscalation, 
spec.template.spec.containers[0].securityContext.capabilities, 
spec.template.spec.containers[0].securityContext.runAsNonRoot, 
spec.template.spec.containers[0].securityContext.seccompProfile

3rd page is blank in pdf-screen PDF

Confirm that `ng add @angular/localize` is necessary

Current text:

Add Bootstrap and NG Bootstrap:

[source,shell]
----
npm i bootstrap @ng-bootstrap/ng-bootstrap --force
----
// todo: add versions and remove force once ng-bootstrap supports Angular 12.
// https://github.com/ng-bootstrap/ng-bootstrap/issues/4093

Import `NgbModule` in `app.module.ts`:

[source,ts]
.src/app/app.module.ts
----
import { NgbModule } from '@ng-bootstrap/ng-bootstrap';

@NgModule({
  ...
  imports: [
    ...
    NgbModule
  ],
  ...
})
export class AppModule { }
----

If you run `ng serve -o`, you'll get a blank screen. Look in your browser's developer console, and you'll see why.

[source,shell]
----
Uncaught Error: It looks like your application or one of its dependencies is using i18n.
Angular 9 introduced a global `$localize()` function that needs to be loaded.
Please run `ng add @angular/localize` from the Angular CLI.
----

Cancel the process and run `ng add @angular/localize` to fix this error. Now, if you restart your app, you'll see it's pretty simple. And kinda ugly.

Update to Knative 1.0

Nov. 2, 2021: https://knative.dev/blog/articles/announcing-knative-1.0/

Fix tests after adding MockSecurityConfiguration

After adding this class, tests won't pass until you add a src/test/resources/application.properties with the following contents:

spring.main.allow-bean-definition-overriding=true
okta.oauth2.issuer=https://dev-06bzs1cu.us.auth0.com/
okta.oauth2.audience=api://default

Don't use `data` class for JPA

https://www.youtube.com/live/cjpSaeIfq9M?feature=share&t=1300

Update location of Bootstrap's default variables in v5

You can see the https://github.com/twbs/bootstrap/blob/v4-dev/scss/_variables.scss[default variables in Bootstrap's GitHub repo].

Add a sentence or paragraph explaining Angular's CSRF handling

https://angular.io/guide/http#security-xsrf-protection

Fix error that happens on startup

I'm unsure when this starts, but it should be fixed so users don't see a stack trace.

2023-04-11T09:02:04.416-06:00  INFO 50836 --- [           main] o.h.c.beanvalidation.TypeSafeActivator   : 
Error calling `jakarta.validation.Validation#buildDefaultValidatorFactory`

jakarta.validation.NoProviderFoundException: Unable to create a Configuration, because no 
Jakarta Bean Validation provider could be found. Add a provider like Hibernate Validator (RI) to your classpath.

Exclude emojis from PDFs

See mraible/jhipster-book#112 for the fix.

Rename chapter files from chapter1 to chapter-1, etc

It doesn't matter for book artifacts, but I think it looks better on the website.