Skip to content

Commit

Permalink
Fixes to non-discrimination statement and update to technical details
Browse files Browse the repository at this point in the history
  • Loading branch information
eldobbins committed Sep 16, 2024
1 parent a16ce7a commit c673daa
Show file tree
Hide file tree
Showing 6 changed files with 70 additions and 122 deletions.
3 changes: 2 additions & 1 deletion _quarto-html.yml
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,8 @@ book:

page-footer:
right: "This page is built with [Quarto](https://quarto.org/)."
center: "&copy; [CC BY-SA 4.0](https://github.com/acep-uaf/aetr-web-book-2024/blob/main/LICENSE.md), 2024<br /> [Alaska Center for Energy and Power](https://www.uaf.edu/acep/)"
left: "&copy; [CC BY-SA 4.0](https://github.com/acep-uaf/aetr-web-book-2024/blob/main/LICENSE.md), 2024<br /> [Alaska Center for Energy and Power](https://www.uaf.edu/acep/)"
center: "UA is an affirmative action/equal opportunity employer, educational institution and provider and prohibits illegal discrimination against any individual: www.alaska.edu/nondiscrimination."

# These change page titles https://quarto.org/docs/books/book-structure.html#parts-appendices
# but not in the sidebar navigation or in cross-references
Expand Down
43 changes: 43 additions & 0 deletions _quarto-word.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
book:
chapters:
- index.qmd
- methods.qmd
- capacity.qmd
- generation.qmd
- consumption.qmd
- prices.qmd
- conclusions.qmd
- data.qmd
appendices:
- about.qmd
- historic_reports.qmd
- acronyms.qmd
- credits.qmd

crossref:
appendix-title: "Appendix"
appendix-delim: ":"

format:
docx:
#pdfengine: xelatex
#documentclass: scrreprt
papersize: letter

fig-width: 6
fig-height: 3.25

fontsize: 11pt
mainfont: Barlow
toccolor: blue

toc: true
toc-depth: 3
toc-title: "Table of contents"
lof: true
lot: true
number-sections: true
number-depth: 2

include-in-header:
- scripts/latex/preamble.tex
11 changes: 7 additions & 4 deletions about.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -43,14 +43,17 @@ The @tbl-report-eras provides a summary of this timeline. This report serves to

For a table of links to these historic reports, please refer to @tbl-historic-reports.

::: {.content-visible when-format="html"}
## Technical Details

The book is formatted using [Quarto](https://quarto.org), an open-source scientific and technical publishing system. The template was developed by the Openscapes project, as part of their [Quarto Website Tutorial](https://github.com/Openscapes/quarto-website-tutorial).
This report has been formatted and rendered using [Quarto](https://quarto.org), an open-source scientific and technical publishing system. The initial inspiration for this workflow was provided by the Openscapes project and their [Quarto Website Tutorial](https://github.com/Openscapes/quarto-website-tutorial). This publishing method experimentally models a new (to ACEP) method of automatically generating reports that include data.

The markdown files that create the report reside in the [aetr-web-book-2024](https://github.com/acep-uaf/aetr-web-book-2024) GitHub repository. The original format of the report was an HTML-based web book, and an option for rendering it in PDF format was added months later. The generation material and process is publicly accessible and transparent. Errors in the document are flagged using GitHub issues where they can be tracked and addressed by the DCM team. The report also integrates R code for data processing and figure generation.

The markdown files that make up the book reside in the [aetr-web-book](https://github.com/acep-uaf/aetr-web-book) GitHub repository. The generation process is publicly accessible. Errors in the document can be flagged using GitHub issues where they can be tracked and addressed by the DCM team.
Early versions of this report contained errors in the data. These were flagged with GitHub issues and corrected in subsequent tagged versions. When data files were updated, the Quarto render updated the figures automatically, reducing the labor required to maintain an up-to-date report.

The book also integrates R code for data processing and figure generation. When data files are updated, manually triggering the Quarto render will update the figures automatically.
The web-first workflow of PDF report generation resulted in some formatting issues that are difficult to correct using this system. These issues include pagination that sometimes separates figures from contextual information. While this is not ideal, we hope to refine our techniques in future reports and to eventually produce a publication quality report.

::: {.content-visible when-format="html"}

## Notice of Nondiscrimination

Expand Down
4 changes: 2 additions & 2 deletions credits.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -65,10 +65,10 @@ The Alaska Electrical Trends report has been produced by the Alaska Center for E
### Acknowledgements

* [Dayne Broderson](https://www.uaf.edu/acep/about/our-team/dayne-broderson.php)`r "^1^"`
* Roles: conceptualization, funding acquisition, visualization
* Roles: conceptualization, funding acquisition, visualization, writing – original draft

* [Gwen Holdmann](https://www.uaf.edu/acep/about/our-team/gwen-holdmann.php)`r "^1^"`
* Roles: conceptualization, funding acquisition
* Roles: conceptualization, funding acquisition, writing – original draft

* [Emily Richmond](https://www.uaf.edu/acep/about/our-team/emily-richmond.php)`r "^1^"`
* Roles: software, visualization
Expand Down
31 changes: 16 additions & 15 deletions scripts/latex/before-body.tex
Original file line number Diff line number Diff line change
Expand Up @@ -53,25 +53,26 @@


\newpage
% \thispagestyle{empty}

\noindent
{\normalsize\bfseries Technical Report} \\
UAF/ACEP/number \\
\vspace{3ex}
August 2024 \\
Suggested Citation: \\
Kaczmarski, J., I. Yeager, S. Colt, E. L. Dobbins, N. McMahon, S. Fisher-Goad, and B. Smart. “2024 Alaska Energy Trends Report,” Alaska Center for Energy and Power, University of Alaska, Fairbanks, 2024. UAF/ACEP/number. DOI:number.
{\centering
\bfseries\normalsize Suggested Citation
\par
}

\newpage
% \thispagestyle{empty}
\vspace{30ex}
Kaczmarski, J., I. Yeager, S. Colt, E. L. Dobbins, N. McMahon, S. Fisher-Goad, and B. Smart. “2024 Alaska Energy Trends Report,” Alaska Center for Energy and Power, University of Alaska, Fairbanks, 2024. DOI:number.

The code that generated this report is available at https://github.com/acep-uaf/aetr-web-book-2024.

Cover photo is the Salmon Creek Dam in Juneau, courtesy of Sarah Traiger.

\vfill
\noindent
{\centering
\bfseries\normalsize Notice
\par
}
\small The University of Alaska Fairbanks is an affirmative action/equal opportunity employer and educational institution. UAF does not discriminate on the basis of race, religion, color, national origin, citizenship, age, sex, physical or mental disability, status as a protected veteran, marital status, changes in marital status, pregnancy, childbirth or related medical conditions, parenthood, sexual orientation, gender identity, political affiliation or belief, genetic information, or other legally protected status. The University's commitment to nondiscrimination, including against sex discrimination, applies to students, employees, and applicants for admission and employment. Contact information, applicable laws, and complaint procedures are included on UA's statement of nondiscrimination available at www.alaska.edu/nondiscrimination/. \\
\\
\small This report is available at no cost from the Alaska Center for Energy and Power (ACEP) at the University of Alaska, Fairbanks (UAF) at www.uaf.edu/acep/our-resources/index.php. \\
\\
\small Cover photo is the Salmon Creek Dam in Juneau, courtesy of Sarah Traiger.
The University of Alaska is an affirmative action/equal opportunity employer, educational institution and provider. The University of Alaska does not discriminate on the basis of race, religion, color, national origin, citizenship, age, sex, physical or mental disability, status as a protected veteran, marital status, changes in marital status, pregnancy, childbirth or related medical conditions, parenthood, sexual orientation, gender identity, political affiliation or belief, genetic information, or other legally protected status. The University's commitment to nondiscrimination, including against sex discrimination, applies to students, employees, and applicants for admission and employment. Contact information, applicable laws, and complaint procedures are included on UA's statement of nondiscrimination available at https://www.alaska.edu/nondiscrimination.

% \small This report is available at no cost from the Alaska Center for Energy and Power (ACEP) at the University of Alaska, Fairbanks (UAF) at www.uaf.edu/acep/our-resources/index.php. \\

100 changes: 0 additions & 100 deletions website_backup.yml

This file was deleted.

0 comments on commit c673daa

Please sign in to comment.