w-html2docx 1.0.0

package/docs/styles/prettify.css

@@ -0,0 +1,80 @@
+.pln {
+  color: #ddd;
+}
+
+/* string content */
+.str {
+  color: #61ce3c;
+}
+
+/* a keyword */
+.kwd {
+  color: #fbde2d;
+}
+
+/* a comment */
+.com {
+  color: #aeaeae;
+}
+
+/* a type name */
+.typ {
+  color: #8da6ce;
+}
+
+/* a literal value */
+.lit {
+  color: #fbde2d;
+}
+
+/* punctuation */
+.pun {
+  color: #ddd;
+}
+
+/* lisp open bracket */
+.opn {
+  color: #000000;
+}
+
+/* lisp close bracket */
+.clo {
+  color: #000000;
+}
+
+/* a markup tag name */
+.tag {
+  color: #8da6ce;
+}
+
+/* a markup attribute name */
+.atn {
+  color: #fbde2d;
+}
+
+/* a markup attribute value */
+.atv {
+  color: #ddd;
+}
+
+/* a declaration */
+.dec {
+  color: #EF5050;
+}
+
+/* a variable name */
+.var {
+  color: #c82829;
+}
+
+/* a function name */
+.fun {
+  color: #4271ae;
+}
+
+/* Specify class=linenums on a pre to get line numbering */
+ol.linenums {
+  margin-top: 0;
+  margin-bottom: 0;
+  padding-bottom: 2px;
+}

package/g.mjs

@@ -0,0 +1,26 @@
+import w from 'wsemi'
+import WHtml2docx from './src/WHtml2docx.mjs'
+//import WHtml2docx from 'w-html2docx/src/WHtml2docx.mjs'
+//import WHtml2docx from 'w-html2docx'
+
+
+async function test() {
+
+    let fpIn = `./test/ztmp.html`
+    let fpOut = `./test/ztmp.docx`
+    let opt = {}
+
+    let r = await WHtml2docx(fpIn, fpOut, opt)
+    console.log(r)
+    // => ok
+
+    w.fsDeleteFile(fpOut)
+
+}
+test()
+    .catch((err) => {
+        console.log('catch', err)
+    })
+
+
+//node g.mjs

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "w-html2docx",
+  "version": "1.0.0",
+  "main": "dist/w-html2docx.umd.js",
+  "dependencies": {
+    "lodash-es": "^4.17.21",
+    "wsemi": "^1.8.34"
+  },
+  "devDependencies": {
+    "w-package-tools": "^1.1.2"
+  },
+  "scripts": {
+    "postinstall": "node scripts/install.mjs",
+    "test": "mocha --parallel --timeout 60000",
+    "deploy": "gh-pages -d docs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yuda-lyu/w-html2docx.git"
+  },
+  "keywords": [
+    "package",
+    "tool",
+    "win32com",
+    "html",
+    "docx",
+    "windows",
+    "nodejs"
+  ],
+  "author": "yuda-lyu(semisphere)",
+  "license": "MIT"
+}

package/script.txt

@@ -0,0 +1,17 @@
+#node toolg/addVersion.mjs
+node toolg/modifyReadme.mjs
+
+node toolg/cleanFolder.mjs
+./node_modules/.bin/jsdoc -c .jsdoc
+
+node toolg/gDistRollup.mjs
+
+git add .  -A
+git commit -m 'modify: '
+git push origin master:master
+
+npm run deploy
+
+#npm test
+
+#npm publish

package/scripts/install.mjs

@@ -0,0 +1,30 @@
+import path from 'path'
+import { fileURLToPath } from 'url'
+import downloadFiles from '../src/downloadFiles.mjs'
+
+
+async function init() {
+
+    //check, 被安裝條件才執行
+    let __dirname = path.dirname(fileURLToPath(import.meta.url))
+    if (!__dirname.includes('node_modules')) {
+        return //非位於node_modules, 代表套件本身
+    }
+
+    //fdSrv
+    let fdSrv = path.resolve()
+
+    //fdBase,
+    let fdBase = `${fdSrv}/src/` //npm i後觸發安裝時, 工作路徑是位於套件內
+    // console.log('fdBase', fdBase)
+
+    //downloadFiles
+    await downloadFiles(fdBase)
+
+}
+init()
+    .catch((err) => {
+        console.log(err)
+    })
+
+//node scripts/install.mjs

package/src/WHtml2docx.mjs

@@ -0,0 +1,162 @@
+import path from 'path'
+import process from 'process'
+import get from 'lodash-es/get.js'
+import isestr from 'wsemi/src/isestr.mjs'
+import isearr from 'wsemi/src/isearr.mjs'
+import cstr from 'wsemi/src/cstr.mjs'
+import str2b64 from 'wsemi/src/str2b64.mjs'
+import execProcess from 'wsemi/src/execProcess.mjs'
+import fsIsFile from 'wsemi/src/fsIsFile.mjs'
+
+
+let fdSrv = path.resolve()
+
+
+function isWindows() {
+    return process.platform === 'win32'
+}
+
+
+/**
+ * Html檔轉Docx檔
+ *
+ * @param {String} fpInHtml 輸入來源Html檔位置字串
+ * @param {String} fpOutDocx 輸入轉出Docx檔位置字串
+ * @param {Object} [opt={}] 輸入設定物件，預設{}
+ * @param {Array|String} [opt.fontFamilies=['標楷體', 'Times New Roman']] 輸入Docx更改字型陣列或字串，預設['標楷體', 'Times New Roman']
+ * @returns {Promise} 回傳Promise，resolve回傳成功訊息，reject回傳錯誤訊息
+ * @example
+ *
+ * import w from 'wsemi'
+ * import WHtml2docx from './src/WHtml2docx.mjs'
+ * //import WHtml2docx from 'w-html2docx/src/WHtml2docx.mjs'
+ * //import WHtml2docx from 'w-html2docx'
+ *
+ * async function test() {
+ *
+ *     let fpIn = `./test/ztmp.html`
+ *     let fpOut = `./test/ztmp.docx`
+ *     let opt = {}
+ *
+ *     let r = await WHtml2docx(fpIn, fpOut, opt)
+ *     console.log(r)
+ *     // => ok
+ *
+ *     w.fsDeleteFile(fpOut)
+ *
+ * }
+ * test()
+ *     .catch((err) => {
+ *         console.log('catch', err)
+ *     })
+ *
+ */
+async function WHtml2docx(fpInHtml, fpOutDocx, opt = {}) {
+    let errTemp = null
+
+    //isWindows
+    if (!isWindows()) {
+        return Promise.reject('operating system is not windows')
+    }
+
+    //check
+    if (!fsIsFile(fpInHtml)) {
+        return Promise.reject(`fpInHtml[${fpInHtml}] does not exist`)
+    }
+
+    //轉絕對路徑
+    fpInHtml = path.resolve(fpInHtml)
+    fpOutDocx = path.resolve(fpOutDocx)
+
+    //fontFamilies
+    let fontFamilies = get(opt, 'fontFamilies')
+    if (isestr(fontFamilies)) {
+        fontFamilies = [fontFamilies]
+    }
+    if (!isearr(fontFamilies)) {
+        fontFamilies = ['標楷體', 'Times New Roman']
+    }
+
+    //fnTmp
+    let fnTmp = `tmp.docx`
+
+    //fpTmp
+    let fpTmp = ``
+    if (true) {
+        let fpTmpSrc = `${fdSrv}/src/${fnTmp}`
+        let fpTmpNM = `${fdSrv}/node_modules/w-html2docx/src/${fnTmp}`
+        if (fsIsFile(fpTmpSrc)) {
+            fpTmp = fpTmpSrc
+        }
+        else if (fsIsFile(fpTmpNM)) {
+            fpTmp = fpTmpNM
+        }
+        else {
+            return Promise.reject(`can not find folder for ${fnTmp}`)
+        }
+
+        //轉絕對路徑
+        fpTmp = path.resolve(fpTmp)
+
+    }
+
+    //fnExe
+    let fnExe = `htmlToDocx.exe`
+
+    //fdExe
+    let fdExe = ''
+    if (true) {
+        let fdExeSrc = `${fdSrv}/src/`
+        let fdExeNM = `${fdSrv}/node_modules/w-html2docx/src/`
+        if (fsIsFile(`${fdExeSrc}${fnExe}`)) {
+            fdExe = fdExeSrc
+        }
+        else if (fsIsFile(`${fdExeNM}${fnExe}`)) {
+            fdExe = fdExeNM
+        }
+        else {
+            return Promise.reject('can not find folder for html2docx')
+        }
+    }
+    // console.log('fdExe', fdExe)
+
+    //prog
+    let prog = `${fdExe}${fnExe}`
+    // console.log('prog', prog)
+
+    //inp
+    let inp = {
+        fpInSrc: fpInHtml,
+        fpInTemp: fpTmp,
+        fpOut: fpOutDocx,
+        fontFamilies: ['標楷體', 'Times New Roman'],
+    }
+    // console.log('inp', inp)
+
+    //input to b64
+    let cInput = JSON.stringify(inp)
+    let b64Input = str2b64(cInput)
+    // console.log('b64Input', b64Input)
+
+    //execProcess
+    await execProcess(prog, b64Input)
+        .catch((err) => {
+            console.log('execProcess catch', err)
+            errTemp = err.toString()
+        })
+
+    //check
+    if (errTemp) {
+        return Promise.reject(errTemp)
+    }
+
+    // //check
+    // if (!isestr(output)) {
+    //     return Promise.reject(`output[${cstr(output)}] is not an effective string`)
+    // }
+
+    return 'ok'
+}
+
+
+export default WHtml2docx

package/src/downloadFiles.mjs

@@ -0,0 +1,23 @@
+import fsDownloadFile from 'wsemi/src/fsDownloadFile.mjs'
+
+
+async function downloadFiles(fdBase) {
+
+    //url
+    let url = `https://github.com/yuda-lyu/w-html2docx/raw/refs/heads/master/src/htmlToDocx.exe`
+    // console.log('url',url)
+
+    //fn
+    let fn = `htmlToDocx.exe`
+
+    //fp
+    let fp = `${fdBase}${fn}`
+
+    //fsDownloadFile
+    console.log(`downloading url[${url}]...`, `to fp[${fp}]`)
+    await fsDownloadFile(url, fp)
+
+}
+
+
+export default downloadFiles

package/srcPython/build.bat

@@ -0,0 +1,9 @@
+
+pyinstaller -F htmlToDocx.py
+pause
+
+pyinstaller build.spec
+pause
+
+pyinstaller htmlToDocx.py
+pause

package/srcPython/htmlToDocx.py

@@ -0,0 +1,239 @@
+from win32com import client as wc  
+
+#使用win32com
+#win32com因更新問題會出現 ImportError: DLL load failed while importing win32api: 找不到指定的模組。
+#1. 安裝 pip install pywin32
+#2. 使用系統管理員權限開啟cmd
+#3. cd至安裝目錄 C:\ProgramData\Anaconda3\Scripts
+#4. 用python安裝腳本 python pywin32_postinstall.py -install
+
+#編譯
+#1. 安裝編譯套件 pip install pyinstaller
+#2. 編譯 pyinstaller -F htmlToDocx.py
+
+#win32com教學
+#https://zhuanlan.zhihu.com/p/67543981
+
+
+def getError():
+    import sys
+
+    #exc_info
+    type, message, traceback = sys.exc_info()
+
+    #es
+    es=[]
+    while traceback:
+        e={
+            'name':traceback.tb_frame.f_code.co_name,
+            'filename':traceback.tb_frame.f_code.co_filename,
+        }
+        es.append(e)
+        traceback = traceback.tb_next
+
+    #err
+    err={
+        'type':type,
+        'message':message,
+        'traceback':es,
+    }
+
+    return err
+
+
+def j2o(v):
+    #json轉物件
+    import json
+    return json.loads(v)
+
+
+def o2j(v):
+    #物件轉json
+    import json
+    return json.dumps(v, ensure_ascii=False)
+
+
+def str2b64(v):
+    #字串轉base64字串
+    import base64
+    v=base64.b64encode(v.encode('utf-8'))
+    return str(v,'utf-8')
+    
+
+def b642str(v):
+    #base64字串轉字串
+    import base64
+    return base64.b64decode(v)
+
+
+def readText(fn):
+    #讀取檔案fn內文字
+    import codecs
+    with codecs.open(fn,'r',encoding='utf8') as f:
+        return f.read()
+
+    
+def writeText(fn,str):
+    #寫出文字str至檔案fn
+    import codecs
+    with codecs.open(fn,'w',encoding='utf8') as f:
+        f.write(str)
+
+
+def htmlToDocx(fpInSrc, fpInTemp, fpOut, opt):
+
+    #Dispatch
+    app = wc.Dispatch('Word.Application')
+
+    #正式版須隱藏
+    app.Visible = False #True False
+
+    #不詢問使用者
+    app.DisplayAlerts = False 
+
+    #Open
+    docInTemp = app.Documents.Open(fpInTemp)
+    docInSrc = app.Documents.Open(fpInSrc)
+
+    #選擇src並複製全文
+    docInSrc.Activate()
+    app.Selection.WholeStory()
+    app.Selection.Copy()
+
+    #選擇模板並貼上全文
+    docInTemp.Activate()
+    app.Selection.Paste()
+    # WdFormatOriginalFormatting = 16
+    # app.Selection.PasteAndFormat(WdFormatOriginalFormatting)
+
+    #選擇模板調整字型
+    try:
+        fontFamilies=opt['fontFamilies']
+        if hasattr(fontFamilies, "__len__"):
+            if len(fontFamilies)>0:
+                #print(fontFamilies)
+                docInTemp.Activate()
+                app.Selection.WholeStory()
+                for fn in fontFamilies:
+                    # print(fn)
+                    app.Selection.Font.Name = fn
+    except:
+        err=getError()
+        print(err)
+
+    #選擇模板偵測各圖片寬度是否大於滿版(412), 並限制於最大值
+    try:
+        docInTemp.Activate()
+        app.Selection.WholeStory()
+        #print(len(app.Selection.Range.InlineShapes)) #有幾張圖
+        for s in app.Selection.Range.InlineShapes:
+            try:
+                s.LockAspectRatio = True
+                #240 -> 8.47公分 max=14.55公分 
+                if s.Width > 412:
+                    s.Width = 412 
+            except:
+                err = getError()
+                print(err)
+
+    except:
+        err=getError()
+        print(err)
+
+    #SaveAs
+    WdSaveFormat = 16 # wdFormatDocumentDefault=16(docx) #https://learn.microsoft.com/zh-tw/office/vba/api/word.wdsaveformat
+    docInTemp.SaveAs2(fpOut, WdSaveFormat)
+
+    # Close
+    WdDoNotSaveChanges = 0  # wdDoNotSaveChanges
+    docInTemp.Close(WdDoNotSaveChanges)
+    docInSrc.Close(WdDoNotSaveChanges)
+
+    #Quit
+    WdSaveOptions = 0 #wdDoNotSaveChanges=0(不儲存擱置中變更) #https://learn.microsoft.com/zh-tw/office/vba/api/word.wdsaveoptions
+    app.Quit(WdSaveOptions)
+
+
+def core(b64):
+    state=''
+
+    try:
+
+        #b642str
+        s=b642str(b64)
+
+        #j2o
+        o=j2o(s)
+
+        #params
+        fpInSrc=o['fpInSrc']
+        fpInTemp=o['fpInTemp']
+        fpOut=o['fpOut']
+
+        #opt
+        opt={}
+        opt['fontFamilies']=o['fontFamilies']
+
+        #htmlToDocx
+        htmlToDocx(fpInSrc, fpInTemp, fpOut, opt)
+
+        state='success'
+    except:
+        err=getError()
+        state='error: '+str(err["message"])
+
+    return state
+
+
+def run():
+    import sys
+
+    #由外部程序呼叫或直接給予檔案路徑
+    state=''
+    argv=sys.argv
+    #argv=['','']
+    if len(argv)==2:
+        
+        #b64
+        b64=sys.argv[1]
+        
+        #core
+        state=core(b64)
+        
+    else:
+        #print(sys.argv)
+        state='error: invalid length of argv'
+    
+    #print & flush
+    print(state)
+    sys.stdout.flush()
+
+
+if True:
+    #正式版
+    
+    #run
+    run()
+    
+    
+if False:
+    #產生測試輸入b64
+    
+    #inp
+    inp={
+        'fpInSrc':'./ztmp.html',
+        'fpInTemp':'./tmp.docx',
+        'fpOut':'./ztmp.docx',
+        'fontFamilies': ['標楷體','Times New Roman'], #word使用, 因由左往右設定, 故得先設定標楷體再設定Times New Roman
+    }
+    # print(o2j(inp))
+    
+    #str2b64
+    b64=str2b64(o2j(inp))
+    print(b64)
+
+    #core
+    state=core(b64)
+
+    print(state)
+

package/srcPython/htmlToDocx.spec

@@ -0,0 +1,37 @@
+# -*- mode: python ; coding: utf-8 -*-
+
+
+a = Analysis(
+    ['htmlToDocx.py'],
+    pathex=[],
+    binaries=[],
+    datas=[],
+    hiddenimports=[],
+    hookspath=[],
+    hooksconfig={},
+    runtime_hooks=[],
+    excludes=[],
+    noarchive=False,
+)
+pyz = PYZ(a.pure)
+
+exe = EXE(
+    pyz,
+    a.scripts,
+    a.binaries,
+    a.datas,
+    [],
+    name='htmlToDocx',
+    debug=False,
+    bootloader_ignore_signals=False,
+    strip=False,
+    upx=True,
+    upx_exclude=[],
+    runtime_tmpdir=None,
+    console=True,
+    disable_windowed_traceback=False,
+    argv_emulation=False,
+    target_arch=None,
+    codesign_identity=None,
+    entitlements_file=None,
+)

package/srcPython/run.bat

@@ -0,0 +1,4 @@
+python htmlToDocx.py eyJmcEluU3JjIjogIkQ6XFwtIDAwNiAtICAgICAgICDplovmupBcXOmWi+a6kC1KUy0wMDgtNC13LWh0bWwyZG9jeFxcdy1odG1sMmRvY3hcXHNyY1B5dGhvblxcenRtcC5odG1sIiwgImZwSW5UZW1wIjogIkQ6XFwtIDAwNiAtICAgICAgICDplovmupBcXOmWi+a6kC1KUy0wMDgtNC13LWh0bWwyZG9jeFxcdy1odG1sMmRvY3hcXHNyY1B5dGhvblxcdG1wLmRvY3giLCAiZnBPdXQiOiAiRDpcXC0gMDA2IC0gICAgICAgIOmWi+a6kFxc6ZaL5rqQLUpTLTAwOC00LXctaHRtbDJkb2N4XFx3LWh0bWwyZG9jeFxcc3JjUHl0aG9uXFx6dG1wLmRvY3giLCAiZm9udEZhbWlsaWVzIjogWyLmqJnmpbfpq5QiLCAiVGltZXMgTmV3IFJvbWFuIl19
+pause
+
+#測試版使用

package/srcPython//350/252/252/346/230/216.txt

@@ -0,0 +1,24 @@
+
+0.可用pyinstaller或nuitka編譯，但nuitka編譯出檔案會小一點(4x mb)，不過卻無法執行待研究
+
+1.可先用一般編譯方式產生spec檔: pyinstaller -F htmlToDocx.py，就會產生htmlToDocx.spec
+
+2.若有需要修改spec後，編譯指令改為對spec檔編譯: pyinstaller build.spec
+
+3.使用build.bat進行編譯
+
+8.編譯完複製htmlToDocx.exe至bin，使用bin\run.bat執行，傳入的b64可將物件
+{
+    'fpIn':'input.html',
+    'fpOut':'output.docx'
+}
+序列化成字串再轉base64即可
+
+----------------------------------------------------------------------
+參考
+
+解决方法：pyinstaller打包缺文件
+https://www.geek-share.com/detail/2773482967.html
+
+pyinstaller spec文件
+https://pyinstaller.readthedocs.io/en/stable/spec-files.html