style(README):Re-organize Contents to include some files
[BK-2020-04.git] / README.org
CommitLineData
baab678d 1* BK-2020-04: Baltakatei Engineering Drawing Templates
1cabc57a 2#+AUTHOR: Steven Baltakatei Sandoval
1a7b1bec
SBS
3#+DATE: 2023-08-19
4#+EMAIL: baltakatei@gmail.com
baab678d
SBS
5
6** Scope
baab678d 7This repository contains drawing files for constructing personal P&IDs
1a7b1bec
SBS
8([[https://en.wikipedia.org/wiki/Piping_and_instrumentation_diagram][Piping and Instrumentation Diagrams]]) and PFDs ([[Process flow diagram][Process Flow
9Diagrams]]).
baab678d 10
16bded73 11** Summary
16bded73
SBS
12See the [[File:REVISION.org][drawing revision history]] for a list of tracked files.
13
14Some drawings may be uploaded to Wikimedia Commons. Notable sets include:
15
9496219a 16- [[https://commons.wikimedia.org/wiki/File:Technical_drawing_templates_(ISO_5457_1999_Sizes_A0-A4).pdf][BK-2020-04-PID-1]]: Chemical engineering symbols ([[https://en.wikipedia.org/wiki/ISO_10628][ISO 10628]]-2:2012 Symbols)
16bded73
SBS
17- [[https://commons.wikimedia.org/wiki/File:Technical_drawing_templates_(ISO_5457_1999_Sizes_A0-A4).pdf][BK-2020-04-TMP-1]]: Technical drawing templates (ISO 5457:1999 Sizes A0—A4)
18
15f5771f
SBS
19** Contents
20*** Directories
21**** ~DEL~ : Deliverables
22A directory that may include plain SVG files and exported PDF files. This is probably
0027c339 23what you want.
15f5771f
SBS
24**** ~DWG~ : Drawing source files
25A directory that may include [[https://inkscape.org/][Inkscape]] SVG files.
26**** ~EXEC~ : Executable files
27A directory that may include scripts useful for manipulating files.
28**** ~IMG~: Reference image files
29A directory that may include various image files used in creation of project source
baab678d 30files.
15f5771f
SBS
31*** Files
32**** ~README.org~
33This file.
34**** ~REVISIONS.org~
35A file containing a detailed version history of each drawing.
36**** ~TODO.org~
37A file containing a list of pending tasks for the project.
baab678d 38
1a7b1bec
SBS
39** Usage
40*** Generate a combined PDF
6545eabd
SBS
41A script is available at ~./EXEC/combine_pdfs.sh~ to merge multiple
42single-page PDFs into a single PDF file; the script uses the [[https://www.pdflabs.com/tools/pdftk-the-pdf-toolkit/][~pdftk~
43utility]] available on typical [[https://www.debian.org/][Debian]]-based [[https://en.wikipedia.org/wiki/Gnu-Linux][GNU/Linux]] machines
44of 2023. On a typical Debian 12 system, the following command may be
45used to merge ~input1.pdf~ and ~input2.pdf~ files into ~output.pdf~.
46
47: $ /bin/bash combine_pdfs.sh output.pdf input1.pdf input2.pdf
1a7b1bec 48
baab678d 49** License
ceed0445 50Unless otherwise specified, source and deliverable files are copyright
1a7b1bec 512023 [[https://baltakatei.com][Steven Baltakatei Sandoval]] and available under a [[https://creativecommons.org/licenses/by-sa/4.0/][CC BY-SA 4.0]]
ceed0445 52license.