From 1aa409b794e9c93aa9c8659b15f5e88890de4bcc Mon Sep 17 00:00:00 2001 From: GenevensiS <66968533+G-e-n-e-v-e-n-s-i-S@users.noreply.github.com> Date: Mon, 11 Aug 2025 16:06:53 +0200 Subject: [PATCH] update readme --- README.md | 30 ++++++++++++++++++------------ resource/readme/hunspell.png | Bin 0 -> 30066 bytes 2 files changed, 18 insertions(+), 12 deletions(-) create mode 100644 resource/readme/hunspell.png diff --git a/README.md b/README.md index 4ee7679c..20afbf25 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,9 @@ Magic Set Editor, or MSE for short, is a program with which you can design your More information on https://magicseteditor.boards.net/ +Documentation on https://mseverse.miraheze.org/wiki/Category:MSE_Documentation + + ## Dependencies The code depends on @@ -11,13 +14,14 @@ The code depends on * boost * hunspell + ## Building on Windows with Visual Studio On windows, the program can be compiled with Visual Studio (recommended) or with mingw-gcc. - * VS instructions up-to-date as of April 2024 + * Visual Studio instructions up-to-date as of April 2024 * Download and install [Visual Studio Community Edition](https://visualstudio.microsoft.com/vs/community/) * Download and install [vcpkg](https://github.com/microsoft/vcpkg) - * Use vcpkg to install pkgconf, wxwidgets, boost, hunspell + * Use vcpkg to install pkgconf, wxwidgets, boost, hunspell: ======= ```` @@ -27,28 +31,28 @@ and/or ```` .\vcpkg install pkgconf wxwidgets[fonts] boost-smart-ptr boost-regex boost-logic boost-pool boost-iterator boost-json hunspell --triplet=x86-windows-static ```` +(these two lines differ only by the triplet at the end. Use x64 for 64 bit operating systems, and x86 for 32 bit.) + then, regardless of your choice ```` .\vcpkg integrate install ```` - * Then just use "Open Folder" from inside visual studio to open the Magic Set Editor source code root folder. - * Select the configuration that you want to build (probably release x64-windows-static). + * Inside Visual Studio go to File menu > Open > Folder... > select the Magic Set Editor source code root folder. + * Select the configuration that you want to build (probably release x64-windows-static). Make sure you have installed all the packages with the corresponding triplet. -![configuration](https://github.com/haganbmj/MagicSetEditor2/blob/master/resource/readme/configuration.png) +![configuration](https://github.com/G-e-n-e-v-e-n-s-i-S/MagicSetEditor2/blob/main/resource/readme/configuration.png) + * Just to the right of that, select magicseteditor.exe. (These options sometimes get de-selected. If you suddenly can't build anymore, make sure to re-select these.) * To build the app go to Build menu > build magicseteditor.exe Notes: * You will most likely get a message about being unable to open hunspell-1.7.lib because pkgconf forgets to add the actual path to HUNSPELL_LIBRARIES. If so, uncomment the noted line in CMakeLists.txt (line 31) and point it to the root vcpkg installation to find the correct hunspell-1.7.lib file. - * You may need to work around [this bug](https://github.com/microsoft/vcpkg/issues/4756) by replacing `$VCPATH\IDE\CommonExtensions\Microsoft\CMake\CMake\share\cmake-3.16\Modules\FindwxWidgets.cmake` with the file from https://github.com/CaeruleusAqua/vcpkg-wx-find (`$VCPATH` is usually `C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7`) - * vcpkg by default installs 32 bit versions of libraries, use `vcpkg install PACKAGENAME --triplet=x64-windows` if you want to enable a 64 bit build. - * Similarly, to use a static build, use `vcpkg install PACKAGENAME --triplet=x32-windows` or `vcpkg install PACKAGENAME -triplet=x64-windows-static`. - -For running tests you will also need to - * Download and install perl (For example [Strawberry perl](http://strawberryperl.com/) or using [MSYS2](https://www.msys2.org/)) -The tests can be run from inside visual studio +![hunspell](https://github.com/G-e-n-e-v-e-n-s-i-S/MagicSetEditor2/blob/main/resource/readme/hunspell.png) + + * For running tests you will also need to download and install perl (For example [Strawberry perl](http://strawberryperl.com/) or using [MSYS2](https://www.msys2.org/)). The tests can be run from inside visual studio + ## Building on Windows with GCC (MSYS2) @@ -73,6 +77,7 @@ cmake --build build Use `CMAKE_BUILD_TYPE=Debug` for a debug build. + ## Building on Linux / FreeBSD * Install the dependencies: @@ -107,6 +112,7 @@ On old versions it's possible that cmake can't find wx-config, to solve this add Install the resource folder to the .magicseteditor dir: `mkdir -p $HOME/.magicseteditor && cp -rT ./resource $HOME/.magicseteditor/resource` Templates are installed to `~/.magicseteditor/data`. Fonts are installed to `~/.local/share/fonts`. + ## Building on Mac OS * Install the dependencies; for example, using Homebrew: (Note: Tested with boost 1.84.0, wxmac (wxwidgets) 3.2.4, hunspell 1.7.2, cmake 3.28.3, dylibbundler 1.0.5.) diff --git a/resource/readme/hunspell.png b/resource/readme/hunspell.png new file mode 100644 index 0000000000000000000000000000000000000000..ac3136f8ccd0fc30c051e10bbb1b0a5b67e48670 GIT binary patch literal 30066 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 z z6#T-+<6RR>MjpbFLcDi{gA#Vmr)&~%=EV+NDdty!9eJx8#^!$Bf;DcteIKERqsM%7lPg==UY`{QRNQe=S>2<#hpa?3-1`NgJ2frhtUGM? zp#!$mtHaqGxOa|aiA>UNV+31XAV>+GtMRWcH`Tr^R5p--M>*7 zq+u1A>~X6|AMaYoIkcBH?W?75Tsf%jAK6lS0`$I7Jh zW`sg#^UjUKSUhWO#;xzp1fGrRV7>6U5bAe)=S)EhXWq2ZWU|L`vuKN7_jv<3qjrvQ z5p;XZj@Yrq5oYc<689qGCQXUMrOwm7xi0Q}bn(AO)XI+((Imx;MshCxmT?C8p6>V2 zI>Z))w~Ph9sf-ZNt+}YrheITjn91hbSr3*y&RneX36;=s8;g>XB~qBI?M}dZ2lO7= zl>Dh_^gN6PH=ns%-Z#sMAlN-*8|FTG4*p#!WtLA zteE%;JA=h4Vt%oGCWi|TVo)Nk8X1VAJXeYT9^MnUjdaa%pmk#EXyQvVcFwn~8{u}h zs5}Cdi~&O`@FFg~wR7@o<_j#PuZN#7>O;?BEe(FG5%ve0o%y8G#H-iSanr*b=HtJN z+3HX1(n2TVswFc-xnH)0G;zb8?aQ= z`x*V*suPYUdlmR5K7^)7wYl#zX}s>>w&rn2cu2c7E8!Z+LDpfh>QgfiQy)=lq?mlmVOg4ENk3P;{ zOw`%shbJHc1o8#X4KR^hNR!ag(kvfqI(J7*9e>U;mq=N^iK=!HBJeQ>VICnO^)(3yKQ>^jX-w%K5@gl&oJ;+WW-wz5;ksb zbTNbw3W+|bVmrK|EwDFnozDer%Buww(S;uw-De_-4@clFFhq`r?wOff=bv=i9wXwE z4ekZhg9q)Bni14*tST20PLXbO3yPoCG=Mqi8o3JGu-9L8e6w)>)`fP1gY!{0HYT{A z`KzWbt9??z6rqpz{*om}xO7+x?^_3@9cIdTK#WFWh&t8rJR<(kvw@gaHamh%$m@{> zHdk{k6wUPL3jYO%8QvU?=NZso^Yj$P=|9i74Hza@H+JjG|9P;kV28MU2pfe*$D~7$ zYiG&nie_(Nt|Ji&>|Bv4eZPrQpB!W1E-%48YIn+>h`NW-s7O=(2!FJ<+FF*P@8b#N+6QVp|ar9XMffMhVs%nVqH zKE_nyA{!ZIE(6)g8u^4C_dPqo{0iNX^=z8~ISh;${Xto!!FC z9KR-ME?38p2%*{MJbLAP!d@F)i9zqjQ@6x@48D+2EZmebk^LRBc2pZmP8?uxs0^H! zQl(cJQVc8}Zd=Gz|6T5)PZW`J0G(~LWk?b=BHVU(Akn*|*U`9Cj|fF1S^T#AiLlc? zeYx12EAQtU{p@?S)%!@ZJW45hwpiyrpW3~ea0NIBt^$5U3*Lppq9Hn8nN86?P8jn8 zXCjK{A2eLa6_=VEkP%@OTH(x3e{fv-hImMT|A>?1qp1g z&_s2(oS`b3!^z3*e4Jf60(1p)F#&wExWQYMTt@fHhI$*v3A63hsbv1h>O9%wcd|#Z zR4ydQb6b9}wfk=-tD#&cel5~>f7x4mOM>BGc|i+KtCwD+vt~mxJ6o`v;xN-sZcBkb z7p{6XCrRCRxTeb3@x)U!vH9+AI!4Zwg3HClDcVkTEY6n^%q0MQCpd`%xoy`YwnlSD?)NQK|6Linf-64H;B9g1yXb=R6pmaX(Lz=*-a3C3YRl0=A6;$&p$2X=B>~g&s;? zbfN)y*DeIE>!)n`OGY&BbM7t-mO{eT2~)+nDdNO3>Wplo40~))k2#+$R#hW|hvE zt?|AVCvB^@919K#p3y6?q}H0YQu4!}DnQFO-h97G@}V8Yew6#C@(6VJKF0IP49LwA zY53t#km8h(Y#sdc5d4@@U)zqfB&ZlGQhxXEW#@msKOY+CI~?t21h8__6p7f;n@Wc_sK^We}_rhgR6#l=>kj9=P{Dz7tup2X9H+1l9lmO=G$ta7Ya=(_H^dwY;%mxf!o&yJ*WX4kMF>?!`SYvSVCQBC7Bl+kwHoP(#!I7`K4AQ}z=3rh8D zr#*LnHj#Zg=+hcEz{B6kJ$<=queP;ptkh+-(<%>J??^2lXW|jKVU-%ck!kKR5wa)# zy7!EP%i)V?#$TVcohG|8?)}8ri9w_fx2V1hBD&%6iu67%r87kmxo>5eBx|A_nMwQb zFm-Aq@#}#YTcY?%ug4WDz$bgr)RxA-@9G}6T+u}%pIrhdd9!PyPf+p;(;1pEosDO- zBFQ4FZFJjXC7=AN87o3I8q@GXL|-2f5*RoCO%e*1YazIyXe`jL`gGy{;cEOABK{F@5%UWiX$4?*Vf?y>IZxwfCl(zS1MvN5na1>@>@=97uun>ibQ z)@yny!}%igdnaO$FRz_KUtc`!tPR!RZN8J54seDa*o;1IK0qrg?3S@Me_9wZJ%5HK zTfMzYkVlQ(vMimYLr&VSIYCL<Ko_Y zJN3=R%MHm;GL<^T*_*aCKry3BQgqVZ@>@@$LFh#kJotk)N0|oZ>`8pLShM%nqLw?o zWupD$`q-mY?d8b@Jvw{={N2%w)A4}A(qZsIk5!h+bJQ@OaY^z}A`5*ZV@k?m?YJq0 z&b~yPgQIw8cUSyBJxk;5Ptpaah%XVyg_9S{g)&5l+pBTXszGH&>vmSM{iVy0LQ|mF ziz7#o=)x_&9@|DH=8m>%AC9Ft3IbS#P~BQrJUM)yjl0BAW{3OvBW$PQ{CNYT#pr1_ zH*JRJ0&0wefcQ16?f%TBHFm2KAcJfl ztje*b;zD_lY;$kodUc4^Bwyq1*5JU?MkaTI4o|cZlY(x&+jOFb+QIiM6!*4b8Rg@k zA?JyJk-wJj=oy1e|0GGEaB?5*?2%F}Ow!w?HLwmDKXf-KBN(Ec$hA_bFRJ>rN^X{? zIZ7bz8wGZHczU}I^u9{(Yx8u_ik|v7z39|l zJ72n{h3b(c@^olwY$PupL8PufXFVwv7RxOCnBV3jDfP5}r{m!M=809;hFxayX#QR$ z&`lKu&YSG-^soJG^~a}k9R)S~Uc(HrmXJ6IaIELnCvaFF<-(=CXD9iDx%R~B`om*; zV9$lMM(p9Q)yGqmIyC*O*nIjn?dd{#g%;%YX2XHYPJI416-!|4;Ef)M;qBQB%w=p+ zqLy!>nf-t-<9k=_2#;ovnX~Vr6uq`DNRBo0qWf@M6-l2F-+&NNxI3438c34xEE?&x zoLqFE5=UR;dt>^F=4)&~aREe}7$>?XAkA>!#(dT-My>4EQ_BYUx3BT$9Aw9?YIJ8v z8{vA)pO=PF26RF?M{6Zx=li@Y(4%~a2yqf#>PFNt781V~aC_U{BQ$qvBf6H}{&3Z` z56ME|0ZUO0(pSFZ6Qx~t?7`S?{p}eirOhtfn%iD>u_fy+yGUmTq`AFNBiGIQj0V;R z7R>H6Z@?VJLhT@nW5FajUSQkVbWhJ@4KFrma+`wOl#cOn2E5)}J6JOd+6Cqi_x@H4 z1e^JHJyGxMU5l^GG`tHr?sxt$-lVSHNY}6R87^_NF@*NrRZ~FzaCPOgNbXPdpM$O~ zAx}zqxy}^A62v_WPJX5#E^JkN)}jKWj3yjT$vEGmAf_;5mmc6=>?h{-XIv7_{Xu{e zx2Xb2x8zZyE;ebFHOnk2DCH+zA>MbXX>T%7s#!{>*jt_UkEbQ!?ML(GC;I#R5Q+K} zkWcpc?bcDmG%DNq2aMp;_JBZ~XMqw-L9dtl6?_~mld1Q--L$w$XfQLsKhgn;Zmt+C z>7Ia5{po!ITg#C)d_re<+`2`JC*RxF5xdgp@f!N5I*~gTu7Dh+9g~L2`Gwy1xfO?A zJoc13#T}iC4bVEQo^g*2=MiV#ogC%oK(hMYt*p9?utfhEft6;Z`(MWoMRSZ~G>g0& zGQR@JfW9*G0l_YGOT_)|lhg#_XSm7!j)X12_CX3i!p-d*A;H86&InB=$F z*%)?i8mf-E#lM7xP$^)CZ2~9;QE6pQK$xFNQap*P+Ekc1MA}Cq?Pfc-hg5Jjxg^5M3a#h;&s6A?Z^)-dPmLYVM*gtBbiWnnA?4d^fga@gDR}$T zNaQW@adeUW{VEZ5QixFNGrW4)vt#rbupF|XbBzZ@kj$=0dls<$+ii0e*9xS}6&^4@ zEBf%Bw{n&d)1Kgd)&WzK8rNq4*z;%voC{#n%k;y z8mg`5MX#`RpR7Z-(4}O8+8%b&FpjJvRE`!99zy;3Jp~vJ1n_eZ)7HaB^loP`%6jvz zy1pS7xUfH+e%tDoy{_;4oditxD)Qk_=xKcOYpOkmMxj@A+3Px8~ z?X+lt5ztmf6tu!|4%CXm*9W*@1RHHhyO!*?9gfuj}Z~|^uk#Q z6LC}Y`&{s^X^CazUjH`-&*@|OgC!Fe%`(}w@KW)yC6h(}m0aH-*1s;Cs%ho=!D_az z)bh?Qb(_>?G;II$!3mY({jawK2;~3UVUqR;7o9~Zw+mw8W*mk|_~~C$A!m~Q_hvQ? zZ|w-^VvagyM@=2F&kFiP^sf)C{~04dURy8HjMCgT-jg21$Ff$QT1G{KjOGYmjGO;! zIHfA9YnF=FY<2Oz>8Jdo(r=J~-_y8aVET@Kn~lkcA}0Rt=ZcF9ilip6G);8fwf**f z#D9>F2usW2>gj*uGwI$Fq2^IS+f8o(S