Skip to content

Commit 623e189

Browse files
committed
Prepare 0.3.0 release
1 parent e3cee8d commit 623e189

File tree

2 files changed

+34
-35
lines changed

2 files changed

+34
-35
lines changed

README.md

+27-29
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# mcf2pdf Converter for Mein CEWE Fotobuch (My CEWE Photobook) files to PDF
22

3-
Latest Release: Version 0.2.1
3+
Latest Release: Version 0.3.0
44

55
Author: Florian Albrecht
66

@@ -21,35 +21,33 @@ model used for professional printings. Therefore, you should not use the
2121
generated PDFs for any "real" print jobs - you will be really disappointed about
2222
the results.
2323

24-
I just started development of this program, and personally, I just needed it for
25-
one single photobook. For this, there will be many features of MCF files not yet
26-
supported by this software. This can result in empty or strange looking PDFs,
27-
or even in program crashes. Notice that this program is in BETA stage and is
28-
not guaranteed to work for ANY of your MCF files. However, if you notice any
29-
strange output, feel free to issue a ticket in the GitHub bugtracker.
30-
If possible, include a screenshot of the MCF software which shows how the page
31-
should look, and then a screenshot of the PDF how it looks after conversion.
32-
Also, including the whole .mcf file would help (don't panic, the .mcf files do
33-
not include any pictures by theirselves, but TEXT inserted into the photobook
34-
can be seen in the .mcf file).
35-
36-
If you are interested in extending the software, feel free to download the code
37-
and start developing! Most important classes are commented. If you send me your
38-
enhancements by e-mail, I can include them in the software.
24+
I just developed this program for personal use. So, there will be many features
25+
of MCF files not yet supported by this software. This can result in empty or
26+
strange looking PDFs, or even in program crashes. Notice that this program is
27+
in BETA stage and is not guaranteed to work for ANY of your MCF files. However,
28+
if you notice any strange output, feel free to issue a ticket in the GitHub
29+
bugtracker. If possible, include a screenshot of the MCF software which shows how
30+
the page should look, and then a screenshot of the PDF how it looks after
31+
conversion. Also, including the whole .mcf file would help (don't panic, the .mcf
32+
files do not include any pictures by theirselves, but TEXT inserted into the
33+
photobook can be seen in the .mcf file).
34+
35+
If you are interested in extending the software, feel free to fork the project
36+
and start developing! Most important classes are commented. If you create Pull
37+
Requests in the main project, I can review them and include them in the software.
3938

4039
## Installation and configuration
4140

42-
Installation is quite easy. Just extract the downloaded archive
43-
(mcf2pdf-x.y.z-bin-windows.zip or mcf2pdf-x.y.z-bin-linux.tar.gz), as you
44-
will likely already have done as you are reading this file.
41+
Installation is quite easy. Just download and extract the archive
42+
(mcf2pdf-x.y.z-bin-windows.zip or mcf2pdf-x.y.z-bin-linux.tar.gz).
4543

46-
To run mcf2pdf, you will have to adjust the startup script by hand, as the
44+
To run mcf2pdf, you will have to **adjust the startup script by hand**, as the
4745
program cannot yet automatically determine where the MCF software is installed.
4846

4947
Some notes about the structure of the MCF software first: The installation
5048
locations of the software consist of two components. One component is the
51-
"real" installation directory, like C:\Program Files\Mein CEWE Fotobuch under
52-
Windows, or perhaps /home/myuser/cewe-fotobuch under Linux. Here the binaries
49+
"real" installation directory, like `C:\Program Files\Mein CEWE Fotobuch` under
50+
Windows, or perhaps `/home/myuser/cewe-fotobuch` under Linux. Here the binaries
5351
of the software are located as well as the shipped background images, fonts,
5452
cliparts etc.
5553
The other component is the "temporary" directory of the MCF software which can
@@ -61,13 +59,13 @@ have to "tell" mcf2pdf about both. This is done by editing the startup script
6159
(mcf2pdf.bat under Windows, mcf2pdf under Linux) with any text editor you like
6260
(Windows: right-click the file and select "Edit").
6361

64-
Look for the line starting with <SET> MCF_INSTALL_DIR= (SET only in the .bat
62+
Look for the line starting with &lt;SET> MCF_INSTALL_DIR= (SET only in the .bat
6563
version). After the =, insert the complete path to the "real" MCF software
6664
installation location, e.g. "C:\Program Files\Mein CEWE Fotobuch". Notice that
6765
you MUST include the path in double quotes if it contains spaces!!
6866

69-
Next, look for the line starting with <SET> MCF_TEMP_DIR= (SET only in the .bat
70-
version). The same, insert now the TEMPORARY location of the software. If
67+
Next, look for the line starting with &lt;SET> MCF_TEMP_DIR= (SET only in the
68+
.bat version). The same, insert now the TEMPORARY location of the software. If
7169
unsure, startup the MCF software, open any file, select "Options", "Directories"
7270
(second item in the Options dialog), and copy the temporary directory listed
7371
there.
@@ -79,18 +77,18 @@ When finished, save the startup script.
7977
After correct configuration (see above), conversion of MCF files now is rather
8078
simple. Just open a command line (Windows: Win+R, then enter "cmd"), change to
8179
the directory where you extracted the mcf2pdf program (if you do not know what
82-
this means, google for "cd change directory"), and type "mcf2pdf <my MCF file>
83-
<my new PDF file>". For example:
80+
this means, google for "cd change directory"), and type "mcf2pdf &lt;my MCF file>
81+
&lt;my new PDF file>". For example:
8482

85-
mcf2pdf "C:\Documents and Settings\myuser\My Documents\USA 2011.mcf" output.pdf
83+
mcf2pdf "C:\Documents and Settings\myuser\My Documents\USA 2011.mcf" output.pdf
8684

8785
Notice the double quotes due to the spaces in the path to the MCF file!
8886

8987
If this seems to complicated, you can COPY the .mcf file AND the images folder
9088
of it (e.g. "USA 2011.mcf Files") to the directory where mcf2pdf is located,
9189
and then just enter
9290

93-
mcf2pdf "USA 2011.mcf" output.pdf
91+
mcf2pdf "USA 2011.mcf" output.pdf
9492

9593
The program will start converting the file and inform you when this is finished.
9694
Notice that the program is NOT optimized for speed in any way... It can take

pom.xml

+7-6
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,9 @@
1-
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
1+
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
2+
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
23
<modelVersion>4.0.0</modelVersion>
34
<groupId>de.florian-albrecht.tools</groupId>
45
<artifactId>mcf2pdf</artifactId>
5-
<version>0.2.2-SNAPSHOT</version>
6+
<version>0.3.0</version>
67
<name>mcf2pdf</name>
78
<description>mcf2pdf enables you to convert photobooks generated with the My CEWE Photobook software to PDF files for preview.</description>
89

@@ -15,12 +16,12 @@
1516
<connection>scm:git:https://github.com/albrechtf/mcf2pdf.git</connection>
1617
<url>https://github.com/albrechtf/mcf2pdf.git</url>
1718
<developerConnection>scm:git:https://github.com/albrechtf/mcf2pdf.git</developerConnection>
18-
<tag>HEAD</tag>
19-
</scm>
19+
<tag>HEAD</tag>
20+
</scm>
2021

2122
<developers>
2223
<developer>
23-
<id>cwflo</id>
24+
<id>albrechtf</id>
2425
<name>Florian Albrecht</name>
2526
<timezone>+1</timezone>
2627
</developer>
@@ -135,7 +136,7 @@
135136
<target>1.6</target>
136137
</configuration>
137138
</plugin>
138-
139+
139140
<plugin>
140141
<groupId>org.apache.maven.plugins</groupId>
141142
<artifactId>maven-release-plugin</artifactId>

0 commit comments

Comments
 (0)